Codex MCP Tool — это сервер с открытым исходным кодом Model Context Protocol (MCP), который соединяет ваш IDE или AI-ассистент (Claude, Cursor и др.) с Codex CLI. Он обеспечивает неинтерактивную автоматизацию с помощью codex exec, безопасные песочницы с одобрением и масштабный анализ кода через ссылки на файлы [@. Созданный для надёжности и скорости, он транслирует обновления прогресса, поддерживает структурированный режим изменений (вывод патча OLD/NEW) и чисто интегрируется со стандартными MCP-клиентами для проверки кода, рефакторинга, документации и автоматизации CI.

Последний релиз (v1.2.4): Улучшенная совместимость с Windows — теперь использую кросс-спаун для надёжного глобального выполнения npm-команд на всех платформах (Windows, macOS, Linux). См. журнал изменений

• Задавайте вопросы по Codex своему клиенту MCP или программно обрабатывайте идеи.

Кратко: + Codex CLI

Цель: использовать Codex напрямую из вашего редактора с поддержкой MCP для эффективного анализа и редактирования кода.

Предварительные требования

Перед использованием этого инструмента убедитесь, что у вас:

1. Node.js (версия 18.0.0 или выше)
2. Codex 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"]
    }
  }
}