Cmd. /mcp
MCP 서버 연결 상태와 사용 가능한 도구를 점검하고 운영하는 명령
명령어 원본 선언
/mcp공식 설명 요약
/mcp는 현재 세션에서 MCP 서버 및 노출 도구 상태를 확인할 때 쓰는 핵심 명령입니다.
외부 시스템 연동 품질은 /mcp 점검 루틴으로 크게 안정화됩니다.
최소 지원 버전
v1.0.18이상 (Changelog 기준)
사용법
/mcp좋은 사용 예
- 세션 시작 직후 MCP 서버 건강 상태 확인
- 도구 호출 실패 시 서버 목록과 권한 재점검
- 신규 MCP 배포 직후 가시성 확인
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/mcp | MCP 연결/도구 상태 중심 | 연동 점검 |
/permissions | 승인 정책 중심 | 실행 가능 범위 제어 |
/status | 세션 전체 상태 중심 | 전반 상태 확인 |
활용 사례
- 티켓 시스템/문서 시스템/모니터링 도구 통합 운영
- 사내 MCP 장애 대응 표준 플레이북의 첫 단계
주의사항
- 도구 접근 실패는 권한 문제와 서버 상태를 분리해 점검
- 민감 도구는 읽기 전용부터 단계적으로 개방
- v2.1.80에서
--channels연구 프리뷰 추가 — MCP 서버가 세션에 메시지를 직접 푸시 가능 - v2.1.81에서
--channels퍼미션 릴레이 — 도구 승인을 폰으로 전달 가능 - v2.1.81에서 MCP OAuth CIMD(SEP-991) 지원 추가
- v2.1.81에서 MCP read/search 도구 호출이 1줄로 접혀 표시 (Ctrl+O 확장)
- v2.1.78에서
deny: ["mcp__servername"]퍼미션 규칙이 MCP 서버 도구를 정상 제거하도록 수정 - v2.1.121에서 MCP server config의
alwaysLoad: true옵션이 추가되어 해당 서버 도구를 ToolSearch deferral 없이 항상 사용할 수 있습니다. - v2.1.128부터
/mcp는 연결된 서버의 tool count를 보여주고, tool이 0개인 서버를 표시합니다. - v2.1.122에서 중복 URL을 가진 claude.ai connector와 수동 서버가 있을 때 숨겨진 connector를
/mcp에 표시하고 정리 힌트를 제공합니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Changelog: https://code.claude.com/docs/en/changelog