Cmd. /mcp
연결된 MCP 서버와 노출된 도구 상태를 확인하고, /mcp verbose로 권한·메타데이터까지 진단하는 명령. rust-v0.23.0부터 관측
핵심 요약
- 연결된 MCP 서버와 노출된 도구 상태를 확인하고, /mcp verbose로 권한·메타데이터까지 진단하는 명령. rust-v0.23.0부터 관측
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
연결된 MCP 서버와 노출된 도구 상태를 확인하고, /mcp verbose로 권한·메타데이터까지 진단하는 명령. rust-v0.23.0부터 관측
/mcp사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Codex CLI 0.155.1 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/mcp선택 시점
- 작업 시작 직후
/mcp로 필요한 서버가 실제로 올라왔는지 먼저 확인 - 도구가 보이지 않거나 권한/메타데이터가 의심되면
/mcp verbose까지 확장해 원인을 좁힘 - Figma node 구현 전에 디자인 컨텍스트·메타데이터·screenshot 도구가 모두 보이는지 점검
/mcp verbose관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
| /mcp | 핵심 동작 | 현재 페이지 상황에서 기본 선택 |
| /status | 상태 조회 중심 | 실행 전/후 상태 확인이 필요할 때 |
/ | 목록 탐색 중심 | 정확한 명령어를 찾을 때 |
실행 결과와 유지 범위
구성된 MCP 서버와 노출 도구를 조회합니다. 서버 추가·삭제 등은 codex mcp CLI의 해당 하위 명령을 사용합니다.
/mcp는 Codex 세션 운영에서 MCP 서버 연결/도구 상태를 확인하는 명령.
인증 확인
지원 Mac의 local TUI 세션에서 MCP 요청에 Touch ID verification을 사용할 수 있습니다. OAuth credential 만료 표시는 더 정확해졌고, 갱신 실패 시 reconnect 안내를 제공합니다.
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는 지연 탐색되므로, 도구가 곧바로 안 보여도 검색으로 확인
- 고위험 작업은 /permissions 정책과 함께 사용
deprecated를 이미 제거됐다는 뜻으로 읽지 말고, 반대로 구 subcommand가 실행된다는 이유로 migration을 미루지도 마세요.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록