OpenAI Codex CLI에 MCP 서버 추가

Codex는 config.toml에서 서버를 관리하며, 서버마다 [mcp_servers.<name>] 테이블을 하나씩 사용합니다. codex mcp add로 서버를 추가할 수도 있습니다.

macOS

~/.codex/config.toml

Windows

~/.codex/config.toml

Linux

~/.codex/config.toml

프로젝트 파일

.codex/config.toml (trusted projects only)

최상위 키

mcp_servers

형식

toml

원격 서버용 OAuth

●예

설정 예시

이 예시는 이 클라이언트가 요구하는 형식으로 GitHub 호스팅 서버와 로컬 서버인 Playwright를 추가합니다.

[mcp_servers.github]
url = "https://api.githubcopilot.com/mcp/"

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

codex mcp add github --url https://api.githubcopilot.com/mcp/
codex mcp add playwright -- npx @playwright/mcp@latest

참고 및 특이사항

• Codex CLI, Codex IDE extension, ChatGPT 데스크톱 앱은 같은 config.toml을 읽습니다.
• 프로젝트의 .codex/config.toml은 신뢰하는 프로젝트에서만 읽습니다.
• env_vars는 셸의 변수를 이름으로 전달하고, bearer_token_env_var는 변수에 저장된 토큰을 원격 서버로 보냅니다.
• 서버별 옵션으로 startup_timeout_sec, tool_timeout_sec, enabled_tools, disabled_tools를 설정할 수 있습니다.
• codex mcp login <name>은 OAuth를 실행하며 CIMD와 동적 등록을 모두 지원합니다.

OpenAI Codex CLI 설정 만들기 →

다른 클라이언트