Codex MCP 도구는 IDE 또는 AI 어시스턴트(Claude, Cursor 등)를 Codex CLI와 연결하는 오픈 소스 모델 컨텍스트 프로토콜(MCP) 서버입니다. codex exec를 통한 비대화형 자동화, 승인을 통한 안전한 샌드박스 편집, @ 파일 참조를 통한 대규모 코드 분석을 가능하게 합니다. 신뢰성과 속도를 위해 설계되었으며, 진행 상황 업데이트를 스트리밍하고, 구조화된 변경 모드(OLD/NEW 패치 출력)를 지원하며, 표준 MCP 클라이언트와 깔끔하게 통합하여 코드 리뷰, 리팩토링, 문서화 및 CI 자동화를 지원합니다.

최신 릴리스 (v1.2.4): 향상된 Windows 호환성 - 이제 모든 플랫폼(Windows, macOS, Linux)에서 신뢰할 수 있는 npm 글로벌 명령 실행을 위해 크로스스폰을 사용합니다. 변경 로그 참조

• MCP 클라이언트에게 코덱스 질문을 하거나, 프로그래밍적으로 아이디어를 브레인스토밍할 수 있습니다.

요약: + 코덱스 CLI

목표: MCP 지원 편집기에서 Codex를 직접 사용하여 코드를 효율적으로 분석하고 편집합니다.

선수 조건

이 도구를 사용하기 전에 다음을 확인하세요:

1. Node.js (v18.0.0 이상)
2. 코덱스 CLI 설치 및 인증

** ✅ 크로스 플랫폼 지원**: Windows, macOS, Linux (v1.2.4+)에서 완전 테스트 및 실행 중입니다

한 줄짜리 설정

Codex MCP Tool

Codex MCP Tool is an open‑source Model Context Protocol (MCP) server that connects your IDE or AI assistant (Claude, Cursor, etc.) to the Codex CLI. It enables non‑interactive automation with codex exec, safe sandboxed edits with approvals, and large‑scale code analysis via @ file references. Built for reliability and speed, it streams progress updates, supports structured change mode (OLD/NEW patch output), and integrates cleanly with standard MCP clients for code review, refactoring, documentation, and CI automation.

Latest Release (v1.2.4): Enhanced Windows compatibility - Now using cross-spawn for reliable npm global command execution across all platforms (Windows, macOS, Linux). See changelog

• Ask Codex questions from your MCP client, or brainstorm ideas programmatically.

TLDR: + Codex CLI

Goal: Use Codex directly from your MCP-enabled editor to analyze and edit code efficiently.

Prerequisites

Before using this tool, ensure you have:

1. Node.js (v18.0.0 or higher)
2. Codex CLI installed and authenticated

✅ Cross-Platform Support: Fully tested and working on Windows, macOS, and Linux (v1.2.4+)

One-Line Setup

claude mcp add codex-cli -- npx -y @cexll/codex-mcp-server

Verify Installation

Type /mcp inside Claude Code to verify the Codex MCP is active.

---

Alternative: Import from Claude Desktop

If you already have it configured in Claude Desktop:

1. Add to your Claude Desktop config:

"codex-cli": {
  "command": "npx",
  "args": ["-y", "@cexll/codex-mcp-server"]
}

2. Import to Claude Code:

claude mcp add-from-claude-desktop

Configuration

Register the MCP server with your MCP client:

For NPX Usage (Recommended)

Add this configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "codex-cli": {
      "command": "npx",
      "args": ["-y", "@cexll/codex-mcp-server"]
    }
  }
}