Cmd. /mcp
MCP 서버 연결과 OAuth 인증을 관리하고, 노출된 도구 상태를 점검하는 명령
핵심 요약
- MCP 연결·OAuth·enable 상태 관리
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
MCP 연결·OAuth·enable 상태 관리
/mcp [reconnect <server>|enable|disable [<server>|all]]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
대화형 UI 외에 v2.1.205+의 -p에서는 인자 없는 호출이 서버 상태 텍스트를 출력합니다.
사용 예
/mcp인자 없이 실행하면 대화형 화면이 열려 서버 목록·도구 수·인증 상태를 보여줍니다.
선택 시점
- 세션 시작 직후 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 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로 분리하세요.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록