Cmd. /mcp
MCP 서버 연결과 OAuth 인증을 관리하고, 노출된 도구 상태를 점검하는 명령
핵심 요약
/mcp는 상태 조회에 그치지 않고 연결된 MCP 서버 목록과 노출 도구를 확인하며 OAuth 인증과 재인증까지 처리하는 대화형 명령이다.- 새 저장소 첫 세션에서는
/mcp·/agents로 서버와 서브에이전트를 설정하고/permissions로 승인 규칙을 잡는 순서가 좋다. - 서버가 노출하는 프롬프트는
/mcp__<server>__<prompt>형태로 동적으로 나타나는데,/mcp자체와는 별개 항목이다. deny: ["mcp__servername"]퍼미션 규칙으로 서버 도구를 제거할 수 있고, v2.1.121의alwaysLoad: true는 도구를 ToolSearch deferral 없이 항상 로드한다.- v2.1.128부터 연결 서버의 tool count와 도구가 0개인 서버까지 표시해 가시성을 높였다.
명령어 원본 선언
/mcp공식 설명 요약
공식 문서는 /mcp를 "Manage MCP server connections and OAuth authentication"
(MCP 서버 연결과 OAuth 인증 관리)으로 정의합니다.
단순 상태 조회에 그치지 않고, 현재 세션에 연결된 MCP 서버 목록과 노출 도구를 확인하고
OAuth가 필요한 서버를 인증하거나 재인증하는 대화형 명령입니다.
공식 워크플로 가이드는 새 저장소에서 첫 세션을 시작할 때 /mcp와 /agents로
프로젝트에 필요한 서버와 서브에이전트를 설정하고 /permissions로 승인 규칙을 잡으라고
권장합니다.
최소 지원 버전
v1.0.18이상 (Changelog 기준 — 공식 명령어 문서에는 별도 최소 버전 표기가 없습니다)
사용법
/mcp인자 없이 실행하면 대화형 화면이 열려 서버 목록·도구 수·인증 상태를 보여줍니다.
좋은 사용 예
- 세션 시작 직후 MCP 서버 연결과 노출 도구 상태 확인
- OAuth 인증이 필요한 서버에 로그인하거나 만료된 토큰 재인증
- 도구 호출 실패 시 서버 목록과 권한 재점검
- 신규 MCP 배포 직후 도구 가시성 확인
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/mcp | MCP 서버 연결·OAuth 인증·도구 상태 중심 | 연동/인증 점검 |
/permissions | 승인 정책 중심 (alias /allowed-tools) | 실행 가능 범위 제어 |
/status | 버전·모델·계정·연결성 등 세션 전체 상태 | 전반 상태 확인 |
MCP 서버가 노출하는 프롬프트는
/mcp__<server>__<prompt>형태의 명령으로 동적으로 나타나며, 연결된 서버에서 자동 발견됩니다. (이는/mcp자체와는 다른 항목입니다.)
활용 사례
- 티켓 시스템/문서 시스템/모니터링 도구 통합 운영
- 사내 MCP 장애 대응 표준 플레이북의 첫 단계
- 신규 팀원 온보딩 시 필요한 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에 표시하고 정리 힌트를 제공합니다. - v2.1.185부터 장시간 MCP tool 호출은
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT으로 idle timeout을 명시적으로 조정할 수 있습니다. - v2.1.187부터
claude mcp login/logout으로 CLI에서 MCP OAuth 인증을 갱신하거나 해제할 수 있습니다. 자동화 bootstrap은claude mcp, 대화형 진단은/mcp로 분리하세요. - v2.1.187의 misleading MCP status 수정 이후에도, 인증·도구 수·권한 문제를 분리해 확인하는 습관을 유지하세요.