Cmd. /mcp
연결된 MCP 서버와 노출된 도구 상태를 확인하고, /mcp verbose로 권한·메타데이터까지 진단하는 명령. rust-v0.23.0부터 관측
핵심 요약
/mcp는 연결된 MCP 서버가 실제로 올라왔는지와 노출된 도구 상태를 확인하는 명령입니다.- 도구가 안 보이거나 권한·메타데이터가 의심되면
/mcp verbose로 더 자세한 상태까지 봅니다. - plugin 설치 후 tool surface 반영 여부를 점검하고, allowlist·metadata 문제를 추적할 때 활용합니다.
verbose는 changelog에 먼저 반영되는 surface라 slash docs보다 빠르게 갱신될 때가 있습니다.- 0.143.0부터 MCP tool search가 기본이고 ChatGPT-hosted server는 session auth를 명시할 수 있으며, 0.144.0부터 interactive auth request에 experimental opt-in이 필요 없습니다.
- Figma 구현 전에는
/mcp에서get_design_context,get_metadata,get_screenshot이 실제로 노출되는지 확인합니다. - 0.146.0부터 auth/config/plugin 변경 뒤 MCP 연결과 App tool inventory를 재시작 없이 refresh할 수 있습니다.
명령어 원본 선언
/mcp공식 설명 요약
/mcp는 Codex 세션 운영에서 MCP 서버 연결/도구 상태를 확인하는 명령.
사용법
/mcp좋은 사용 예
- 작업 시작 직후
/mcp로 필요한 서버가 실제로 올라왔는지 먼저 확인 - 도구가 보이지 않거나 권한/메타데이터가 의심되면
/mcp verbose까지 확장해 원인을 좁힘 - Figma node 구현 전에 디자인 컨텍스트·메타데이터·screenshot 도구가 모두 보이는지 점검
/mcp verbose비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
| /mcp | 핵심 동작 | 현재 페이지 상황에서 기본 선택 |
| /status | 상태 조회 중심 | 실행 전/후 상태 확인이 필요할 때 |
| /help | 목록 탐색 중심 | 정확한 명령어를 찾을 때 |
활용 사례
- MCP 서버 enable 상태 점검
- plugin 설치 후 실제 tool surface 반영 여부 확인
- verbose 진단으로 allowlist/metadata 문제 추적
- Figma MCP로 정확한 node의 디자인 컨텍스트와 asset을 가져오고 Playwright 검증으로 연결
v0.123.0~v0.125.0 변경사항
- **
/mcp verbose**가 changelog 기준 최신 surface로 추가되어, 기본 inventory보다 더 자세한 MCP 상태를 볼 수 있음 - remote plugin marketplace를 list/read 단위로 확인하는 흐름과 이어져,
/plugins와 함께 공급원 점검 루틴을 짜기 쉬워짐 - 0.125.0에서는 remote plugin install/marketplace upgrade가 app-server plugin management에 들어와
/mcp점검 이후 조치 루프가 더 짧아짐
v0.143.0~v0.144.0 변경사항
- MCP tool search가 기본화되어 큰 tool inventory를 지연 탐색하는 흐름이 표준이 됐습니다.
- ChatGPT-hosted MCP server는 session authentication을 명시할 수 있습니다.
- MCP tool의 interactive authentication request는 experimental opt-in 없이 기본 동작합니다.
v0.146.0 변경사항
- MCP 인증·config 변경 뒤 연결을 live refresh하고, Apps tool도 함께 갱신할 수 있습니다.
- auth redirect·remote WebSocket·MCP 경로의 proxy 지원이 보강됐으므로 proxy 환경에서는 refresh 후 실제 tool call까지 smoke test하세요.
주의사항
verbose는 최신 changelog에 먼저 잡히는 surface라 slash docs보다 반영이 빠를 수 있음- 0.143.0부터 MCP tool search가 기본이라 큰 tool inventory는 지연 탐색되므로, 도구가 곧바로 안 보여도 검색으로 확인
- 고위험 작업은 /permissions 정책과 함께 사용
도입 시점 (릴리즈 기준)
- 판정: 추가 확인
- 최초 근거 버전:
rust-v0.23.0 - 시기(UTC): 2025-08-20
- 릴리즈 링크: https://github.com/openai/codex/releases/tag/rust-v0.23.0
출처
- Codex slash commands: https://developers.openai.com/codex/cli/slash-commands
- Codex CLI features: https://developers.openai.com/codex/cli/features
- Codex changelog: https://developers.openai.com/codex/changelog
- Codex MCP customization: https://learn.chatgpt.com/docs/customization/overview#mcp
- Figma designs to code: https://learn.chatgpt.com/use-cases/figma-designs-to-code