Cmd. /mcp
연결된 MCP 서버와 노출된 도구 상태를 확인하고, /mcp verbose로 권한·메타데이터까지 진단하는 명령. rust-v0.23.0부터 관측
핵심 요약
- 연결된 MCP 서버와 노출된 도구 상태를 확인하고, /mcp verbose로 권한·메타데이터까지 진단하는 명령. rust-v0.23.0부터 관측
- 도구가 보이지 않으면
/mcp verbose로 원인을 좁히고, 0.161.0부터는 실행 중인 세션에서/mcp login <name>으로 MCP 서버에 로그인할 수 있습니다.
역할
연결된 MCP 서버와 노출된 도구 상태를 확인하고, /mcp verbose로 권한·메타데이터까지 진단하는 명령. 0.161.0 릴리스 노트부터 /mcp login으로 세션 안에서 서버에 로그인
/mcp사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-10-23 · Codex CLI 0.163.0 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/mcp
/mcp login github선택 시점
- 작업 시작 직후
/mcp로 필요한 서버가 실제로 올라왔는지 먼저 확인 - 도구가 보이지 않거나 권한/메타데이터가 의심되면
/mcp verbose까지 확장해 원인을 좁힘 - Figma node 구현 전에 디자인 컨텍스트·메타데이터·screenshot 도구가 모두 보이는지 점검
/mcp verbose실행 결과와 유지 범위
구성된 MCP 서버와 노출 도구를 조회합니다. /mcp login 뒤에 서버 이름을 주면 실행 중인 터미널 세션에서 그 서버의 로그인 절차를 시작합니다(0.161.0 릴리스 노트 기준, 공식 표에는 아직 없음). 서버 추가·삭제 등은 codex mcp CLI의 해당 하위 명령을 사용합니다.
인증 확인
지원 Mac의 local TUI 세션에서 MCP 요청에 Touch ID verification을 사용할 수 있습니다. OAuth credential 만료 표시는 더 정확해졌고, 갱신 실패 시 reconnect 안내를 제공합니다.
0.158.0부터 사전 등록 OAuth client의 secret이 필요한 서버는 codex mcp add --oauth-client-secret이나 서버 설정의 oauth.client_secret으로 연결합니다. secret은 client ID와 함께 지정해야 하고 debug 출력과 authorization URL에는 드러나지 않습니다. 같은 릴리스에서 mcp_servers.<name>.tool_input_schema_max_bytes(기본 5,000바이트)로 큰 MCP tool의 input schema 축약 기준을 조정할 수 있게 됐습니다.
0.161.0부터 실행 중인 세션에서 /mcp login <name>으로 MCP 서버에 로그인할 수 있습니다. PR 설명에 따르면 브라우저에서 authorization URL을 열고, 성공·실패 결과를 명령을 실행한 thread에 표시합니다. 셸의 codex mcp login <name>은 그대로 쓸 수 있습니다. 공식 슬래시 표에는 아직 login 인자가 없으므로 설치본에서 동작을 확인하세요.
/mcp login <name>App server 전환
- 새 host 통합은 deprecated
codex mcp-server대신codex app-server를 사용합니다. - bearer token 전달, startup 실패, 재연결을 정상 연결과 별도 시나리오로 검증합니다.
- 0.150.1 CLI help에서
codex app-server도 experimental로 표시됩니다. CLI version을 pin하고stdio·Unix socket·WebSocket 중 transport와 auth·shutdown·reconnect 계약을 검증한 뒤 production caller를 옮깁니다.
주의사항
verbose는 최신 changelog에 먼저 잡히는 surface라 slash docs보다 반영이 빠를 수 있음- 0.143.0부터 MCP tool search가 기본이라 큰 tool inventory는 지연 탐색되므로, 도구가 곧바로 안 보여도 검색으로 확인
deprecated를 이미 제거됐다는 뜻으로 읽지 말고, 반대로 구 subcommand가 실행된다는 이유로 migration을 미루지도 마세요.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록