MCP 명령/도구 연동 가이드
MCP 서버를 통해 Claude Code의 명령/도구 활용 범위를 확장하는 방법
핵심 요약
- MCP 서버는 Claude가 호출할 도구를 노출하는 게 기본이고, 프롬프트를 제공하면 슬래시 명령처럼 보이는 래퍼로도 쓸 수 있습니다.
/mcp는 서버 연결·OAuth 인증·추가/제거·노출 도구 점검의 시작점입니다.- MCP 프롬프트는
/mcp__<server>__<prompt>형식으로 노출되며, 서버를 연결·해제하면 목록도 동적으로 바뀝니다. - 설계 원칙은 읽기 전용 도구부터 붙이고,
/permissions승인 정책과 함께 설계하며, 커스텀 스킬/명령으로 캡슐화하는 것입니다.
목적
MCP(Model Context Protocol) 연동은 외부 시스템을 Claude Code 작업 흐름 안으로 끌어오는 방법입니다. 연결된 서버는 Claude가 호출할 도구(tool)를 노출하는 게 기본이고, 서버가 프롬프트(prompt)를 제공하면 슬래시 명령어처럼 보이는 래퍼로도 쓸 수 있습니다.
원본 선언(개념)
/mcp/mcp는 MCP 서버 연결과 OAuth 인증을 관리하는 명령입니다.
연결 상태 확인, 서버 추가·제거, 인증 흐름 처리, 노출 도구 점검의 시작점으로 사용합니다.
MCP 프롬프트를 명령으로 사용
MCP 서버가 프롬프트를 노출하면 슬래시 명령으로 나타납니다. 형식은 다음과 같습니다.
/mcp__<server>__<prompt>이 명령은 연결된 서버에서 동적으로 발견되고, 서버를 연결하거나 해제하면 목록도 같이 바뀝니다.
설계 원칙
- 읽기 전용 도구부터 붙인다.
- 승인 정책(
/permissions)과 같이 설계한다. - 커스텀 스킬/명령으로 캡슐화해 팀 사용성을 높인다.
좋은 사용 예
- 이슈 시스템 조회 도구 +
/review(PR 로컬 리뷰) 조합 - 문서 검색 도구 +
/simplify(변경 코드 정리 리뷰) 요약 조합 - 배포 상태 조회 도구 +
/resume(대화 재개) 운영 재개 조합
비슷한 명령어 추천
- 환경 상태 확인:
/status(Settings의 Status 탭 — 버전·모델·계정·연결 상태) - 권한 통제:
/permissions(별칭/allowed-tools) - 자동화 연결:
/hooks(도구 이벤트용 훅 설정 확인)
활용 사례
- 사내 위키 검색 자동화
- 티켓 추적 시스템 통합
- 운영 대시보드 질의 자동화
주의사항
- 민감 데이터는 서버 단에서 마스킹
- 도구 실패 시 재시도 정책과 fallback 준비
- 모든 사용자에게 모든 명령이 노출되지는 않습니다. 플랜·플랫폼·환경에 따라 가용 명령이 달라집니다.
출처
- Claude Code 명령 레퍼런스: https://code.claude.com/docs/en/commands
- MCP 프롬프트를 명령으로 사용: https://code.claude.com/docs/en/mcp