OpenAI Codex에 MCP 서버 추가하는 방법(config.toml)

codex mcp add 또는 ~/.codex/config.toml로 Codex CLI, IDE 확장, 앱용 MCP 서버를 설정합니다.

CLI로 추가

codex mcp add context7 -- npx -y @upstash/context7-mcp

비밀 값은 --env VAR=VALUE로 전달합니다. codex mcp list로 설정된 서버를 확인할 수 있습니다.

또는 config.toml 편집

Codex는 MCP 설정을 ~/.codex/config.toml(신뢰된 프로젝트에서는 .codex/config.toml)에 저장합니다. 각 서버는 [mcp_servers.<name>] 테이블입니다:

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

[mcp_servers.example]
url = "https://mcp.example.com"

확인

Codex 터미널 화면(또는 ChatGPT 데스크톱 앱 입력창)에서 /mcp를 입력하면 연결된 서버가 표시됩니다. CLI, IDE 확장, 데스크톱 앱은 같은 설정을 공유합니다. OAuth 서버는 codex mcp login <name>을 실행하세요.