Codex에 MCP 추가: 문서 서버부터 시작
Codex 로컬·원격 MCP 연결을 이해하세요. OpenAI 공식 읽기 전용 문서 서비스를 추가하고 설정과 실제 호출을 확인합니다.
작동하는 Codex CLI부터 시작하세요
공식 안내로 Codex CLI를 설치하고 로그인하세요. CLI는 터미널 명령 도구이며 여기서는 MCP 설정에 씁니다. 새 플러그인 서비스를 구매하기보다 기존 Codex 이용 환경에서 시작하세요.
MCP는 외부 도구·정보를 제공합니다. 서버 추가가 모델 재학습이나 모든 권한의 자동 부여를 뜻하지 않습니다.
로컬 명령과 원격 주소 선택
로컬 STDIO 서버는 명령으로 시작하므로 실행 환경과 인수를 확인하세요. 원격 Streamable HTTP 서버는 주소를 사용하고 인증이 필요할 수 있습니다.
기본 설정은 ~/.codex/config.toml이며 신뢰한 프로젝트는 .codex/config.toml을 쓸 수 있습니다. 같은 호스트는 설정을 공유하지만 다른 기기·클라우드는 별도 연결 확인이 필요합니다.
공식 읽기 전용 문서 예시를 시도하세요
OpenAI 공개 문서 MCP는 개발 문서를 읽으며 대신 API를 호출하지 않습니다. 다음은 공식 설정 예시이며 사이트에서 실행한 명령이 아닙니다.
- Codex CLI가 설치된 터미널에서 실행: codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
- codex mcp list를 실행하고 openaiDeveloperDocs를 확인하세요.
- Codex 터미널 인터페이스에서 /mcp로 연결을 확인하고 출처를 포함한 문서 질문을 하세요.
설정 저장이 연결 성공을 뜻하지 않습니다
목록 표시는 설정 확인일 뿐 호출 성공은 아닙니다. 시작·인증·실제 결과를 확인하세요. OAuth는 제공 업체 안내와 codex mcp login server-name을 따르며 모든 서버가 로그인을 요구하지는 않습니다.
- 로컬 오류는 실행 환경·실행 파일·인수를 확인하세요.
- 원격 오류는 주소·네트워크·필요 인증을 확인하세요.
- 변경 후 클라이언트 안내대로 재시작·재연결하고 실제 호출을 확인하세요.
특정 작업용 도구를 추가하세요
작업용 서비스를 고르고 출처·권한·설정을 읽은 뒤 검증 가능한 요청을 시도하세요. 자격 증명은 공개 저장소 밖의 적절한 로컬 설정에 보관하세요.
출처 확인일: 2026-10-12. 설치·로그인·연결은 시험하지 않았습니다. 최신 클라이언트·서버 안내를 따르세요.