콘텐츠로 이동

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)으로 저장됩니다.

  1. 탐색할 저장소 폴더에서 새 세션을 열고 에이전트에게 initial_instructions나 find를 호출하게 해 경로가 맞는지 확인하세요.
  2. 첫 실행이라 색인 준비 중 안내가 나오면 잠시 뒤 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

클라이언트별 대상 파일 경로는 전역 지침을 참고하세요.