---
title: "OpenAI Codex CLI MCP 설정: 파일 경로, 키, 예시 · DotsAgent"
description: "OpenAI의 MCP 서버를 OpenAI Codex CLI에 추가하는 방법을 알아보세요. 설정 파일 위치, 최상위 키와 형식, 원격 OAuth 지원, 설정 예시를 확인할 수 있습니다."
url: https://dotsagent.io/ko/mcp/clients/codex-cli
---

OpenAI

# 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를 추가합니다.

`.codex/config.toml`

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

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

`shell`

```
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 설정 만들기 →](https://dotsagent.io/ko/mcp/config#client=codex-cli)

## 다른 클라이언트

[Claude Desktop](https://dotsagent.io/ko/mcp/clients/claude-desktop)

[Claude Code](https://dotsagent.io/ko/mcp/clients/claude-code)

[Cursor](https://dotsagent.io/ko/mcp/clients/cursor)

[VS Code (GitHub Copilot)](https://dotsagent.io/ko/mcp/clients/vscode-copilot)

[Windsurf / Devin Desktop](https://dotsagent.io/ko/mcp/clients/windsurf)

[Zed](https://dotsagent.io/ko/mcp/clients/zed)

[Gemini CLI](https://dotsagent.io/ko/mcp/clients/gemini-cli)

[ChatGPT](https://dotsagent.io/ko/mcp/clients/chatgpt)

[OpenClaw](https://dotsagent.io/ko/mcp/clients/openclaw)

[Cline](https://dotsagent.io/ko/mcp/clients/cline)

[Continue](https://dotsagent.io/ko/mcp/clients/continue)

[JetBrains AI Assistant](https://dotsagent.io/ko/mcp/clients/jetbrains-ai)

## 출처

1. [developers.openai.com](https://developers.openai.com/codex/mcp)/codex/mcp

AI 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다.

© 2026 DotsAgent · 정보 확인일: 2026년 10월 1일