MCP 명령/연동 가이드
/mcp·/apps·/plugins·/permissions로 Codex의 MCP 서버·도구를 안전하게 운영하는 방법. 읽기 전용 도입과 승인 정책 동시 설계를 원칙으로 합니다.
핵심 요약
- MCP 연동의 핵심 명령은
/mcp,/apps,/plugins,/permissions네 가지입니다. - 도구는 읽기 전용부터 도입해 영향 범위를 좁힌 뒤 조금씩 넓혀갑니다.
- 승인 정책을 도구 도입과 동시에 설계해 권한 공백이 생기지 않게 합니다.
- 장애 상황에 대비해 fallback 절차를 미리 문서화합니다.
- Figma 같은 디자인 도구는 MCP가 외부 컨텍스트를 가져오고, Skill이 조회·구현·검증 순서를 정의하는 조합으로 운영합니다.
핵심 명령
- /mcp
- /apps
- /plugins
- /permissions
디자인 도구 연결
공식 Codex 디자인 흐름에서 Figma는 MCP 서버로 구조화된 디자인 컨텍스트, 변수, asset, 정확한 variant를 제공합니다. 구현 전 다음 항목을 확인합니다.
/plugins
/skills
/mcp| 확인 대상 | 목적 |
|---|---|
get_design_context | 정확한 Figma node의 구조·스타일·asset 컨텍스트 조회 |
get_metadata | 응답이 잘릴 때 파일 구조를 파악하고 필요한 node만 다시 선택 |
get_screenshot | 구현 전 정확한 variant의 시각 기준 확보 |
$playwright | 구현 후 실제 브라우저에서 반응형·상호작용·시각 차이 검증 |
도구가 보이지 않으면 /mcp verbose로 인증과 tool exposure를 확인합니다. 자세한 구현 순서는 /books/codex-command-master/design-workflows를 따릅니다.
운영 원칙
- 읽기 전용 도구부터 도입
- 승인 정책과 동시 설계
- 장애 시 fallback 절차 문서화
- 디자인 source of truth와 최종 브라우저 viewport 기록
출처
- 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