MCP 명령/도구 연동 가이드
MCP 서버를 통해 Claude Code의 명령/도구 활용 범위를 확장하는 방법
목적
MCP 연동은 외부 시스템을 Claude Code 작업 흐름 안으로 끌어오는 방법입니다. 프로젝트에 따라 슬래시 명령어처럼 보이는 래퍼를 제공할 수도 있고, 도구 호출 중심으로 동작할 수도 있습니다.
원본 선언(개념)
/mcp/mcp는 연결 상태와 노출 도구를 확인하는 시작점으로 사용합니다.
설계 원칙
- 읽기 전용 도구부터 붙인다.
- 승인 정책(
/permissions)과 같이 설계한다. - 커스텀 명령어로 캡슐화해 팀 사용성을 높인다.
좋은 사용 예
- 이슈 시스템 조회 도구 +
/review조합 - 문서 검색 도구 +
/simplify요약 조합 - 배포 상태 조회 도구 +
/resume운영 재개 조합
비슷한 명령어 추천
- 단순 상태 확인:
/status - 권한 통제:
/permissions - 자동화 연결:
/hooks
활용 사례
- 사내 위키 검색 자동화
- 티켓 추적 시스템 통합
- 운영 대시보드 질의 자동화
주의사항
- 민감 데이터는 서버 단에서 마스킹
- 도구 실패 시 재시도 정책과 fallback 준비