MCP 클라이언트 등록
codemap-search mcp를 클라이언트에 등록한 뒤, 탐색할 저장소 폴더에서 클라이언트를 실행하세요.
클라이언트별 등록
섹션 제목: “클라이언트별 등록”모든 저장소에서 공통으로 쓰려면 사용자 범위로 등록하세요.
claude mcp add --scope user codemap-search -- codemap-search mcp팀과 공유할 .mcp.json에 추가하려면 탐색할 저장소 폴더에서 실행하세요.
claude mcp add --scope project codemap-search -- codemap-search mcp--scope를 생략하면 현재 저장소의 개인 설정(local, ~/.claude.json)으로 저장됩니다.
codex mcp add codemap-search -- codemap-search mcp또는 ~/.codex/config.toml에 직접 추가하세요.
[mcp_servers.codemap-search]command = "codemap-search"args = ["mcp"]-
@buyong/pi-mcp-adapter를 설치하세요.
터미널 창 pi install npm:@buyong/pi-mcp-adapter -
~/.pi/agent/settings.json의extensions에"-builtin:mcp"를 추가하거나pi config의 Built-in에서mcp를 꺼 기본 MCP를 비활성화하세요. -
~/.pi/agent/mcp.json(전역)이나.pi/mcp.json(저장소)에 다음을 추가하세요.{"mcpServers": {"codemap-search": { "command": "codemap-search", "args": ["mcp"] }}} -
이미
pi가 실행 중이면/reload를 실행하세요.
전역 ~/.config/opencode/opencode.json이나 저장소의 opencode.json에 추가하세요.
{ "$schema": "https://opencode.ai/config.json", "mcp": { "codemap-search": { "type": "local", "command": ["codemap-search", "mcp"], "enabled": true } }}연결 확인
섹션 제목: “연결 확인”- 탐색할 저장소 폴더에서 새 세션을 열고 에이전트에게
initial_instructions나find를 호출하게 해 경로가 맞는지 확인하세요. - 첫 실행이라 색인 준비 중 안내가 나오면 잠시 뒤
search로 심볼이 검색되는지 확인하세요.
- 바이너리를 찾지 못할 때: 터미널
PATH는 설치 문제 해결을 참고하고,~/.zshrc·~/.bashrc를 읽지 않는 GUI 클라이언트는which codemap-search(Windows는where.exe codemap-search)로 확인한 절대 경로를command에 적으세요. - 다른 폴더가 색인될 때: 탐색할 저장소 폴더에서 클라이언트를 실행했는지 확인하세요(홈 디렉터리
~에서는codemap-search가 동작하지 않습니다).
전역 지침 자동 등록 (선택)
섹션 제목: “전역 지침 자동 등록 (선택)”클라이언트의 전역 지침 파일(CLAUDE.md, AGENTS.md)에 codemap-search 우선 사용 안내 한 줄을 넣어 두려면 ~/.codemap/config.toml에 다음을 추가한 뒤 새 세션을 여세요.
[global_instructions]enabled = true클라이언트별 대상 파일 경로는 전역 지침을 참고하세요.