Cmd. /mcp
MCP 서버 연결과 OAuth 인증을 관리하고, 노출된 도구 상태를 점검하는 명령
핵심 요약
- MCP 연결·OAuth·enable 상태 관리
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
MCP 연결·OAuth·enable 상태 관리
/mcp [reconnect (<server>|all)|enable|disable [<server>|all]]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-10-23 · Claude Code 2.1.308 |
대화형 UI 외에 v2.1.205+의 -p에서는 인자 없는 호출이 서버 상태 텍스트를 출력합니다. 대화형 터미널의 reconnect all은 v2.1.284+가 필요합니다.
사용 예
/mcp
/mcp reconnect all인자 없이 실행하면 대화형 화면이 열려 서버 목록·도구 수·인증 상태를 보여줍니다.
선택 시점
- 세션 시작 직후 MCP 서버 연결과 노출 도구 상태 확인
- OAuth 인증이 필요한 서버에 로그인하거나 만료된 토큰 재인증
- 도구 호출 실패 시 서버 목록과 권한 재점검
- 신규 MCP 배포 직후 도구 가시성 확인
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/mcp | MCP 서버 연결·OAuth 인증·도구 상태 중심 | 연동/인증 점검 |
/permissions | 승인 정책 중심 (alias /allowed-tools) | 실행 가능 범위 제어 |
/status | 버전·모델·계정·연결성 등 세션 전체 상태 | 전반 상태 확인 |
MCP 서버가 노출하는 프롬프트는
/mcp__<server>__<prompt>형태의 명령으로 동적으로 나타나며, 연결된 서버에서 자동 발견됩니다. (이는/mcp자체와는 다른 항목입니다.)
실행 결과와 유지 범위
서버 연결·OAuth 인증·활성 상태를 관리합니다. enable/disable 또는 재연결은 이후 사용할 수 있는 도구에 영향을 줍니다.
공식 문서는 /mcp를 "Manage MCP server connections and OAuth authentication"
(MCP 서버 연결과 OAuth 인증 관리)으로 정의합니다.
단순 상태 조회에 그치지 않고 현재 세션에 연결된 MCP 서버 목록과 노출 도구를 확인하고
OAuth가 필요한 서버를 인증하거나 재인증하는 대화형 명령입니다.
/mcp reconnect <server>는 끊긴 서버 하나를 다시 연결하고, /mcp reconnect all은 연결에 실패했거나 인증이 필요한 서버를 한 번에 다시 시도합니다(대화형 터미널은 v2.1.284+). /mcp enable <server>·/mcp disable all은 대화 상자 없이 연결 상태를 바꿉니다. -p에서는 인자 없는 /mcp가 서버 상태를 텍스트로 출력합니다(v2.1.205+).
주의사항
- 도구 접근 실패는 권한 문제와 서버 상태를 분리해 점검
- 민감 도구는 읽기 전용부터 단계적으로 개방
- v2.1.81에서
--channels퍼미션 릴레이 — 도구 승인을 폰으로 전달 가능 - v2.1.81에서 MCP read/search 도구 호출이 1줄로 접혀 표시 (Ctrl+O 확장)
- 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.287부터 2025-11-25 protocol을 쓰는 서버가 로그인 같은 용도로 URL prompt를 보낼 수 있습니다. 업데이트 뒤 연결되지 않는 서버는 MCP 설정 항목에
"bareElicitationCapability": true를 추가합니다. 같은 버전부터 서버의alwaysLoad: false는 그 서버의 도구 전체를 tool search 뒤로 미룹니다. - stdio 서버의 protocol 2026-07-28 협상은 v2.1.285부터 단계적으로 켜졌고 v2.1.292에서 Bedrock·Vertex·Foundry를 포함한 모든 설치본의 기본값이 됐습니다. 이전 handshake를 유지하려면
MCP_PROTOCOL_NEGOTIATION=legacy를 설정합니다. - v2.1.295부터 feature flag를 가져오지 않는 설치본(telemetry나 feature-flag fetching을 끈 세션 등)에서는 claude.ai connector도 protocol 2026-07-28을 기본으로 협상합니다. stdio 서버와 같이
MCP_PROTOCOL_NEGOTIATION=legacy로 끕니다. - v2.1.285부터 cloud session과 self-hosted runner에서는
widgets라는 서버 이름이 예약됩니다. 같은 이름이나widgets_같은 유사 철자의 사용자 서버는 로드되지 않으므로 이름을 바꿉니다. claude mcp get은 plugin이 제공한 stdio 서버의 command·인자·환경 변수 값을 숨기고 변수 이름만 보여줍니다(v2.1.285).
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록