OpenAI の Codex CLI のシンプルな MCP サーバーラッパーです。AI アシスタントが Model Context Protocol を通じて Codex の機能を使用できるようにします。

• OpenAI API キーまたは ChatGPT Plus/Pro/Team アカウント
• Node.js 22+（Codex CLI の要件）
• --allow-npx オプションで、Codex CLI をローカルにインストールせずに利用できます

claude mcp add -s project codex-cli -- npx mcp-codex-cli --allow-npx

{
  "mcpServers": {
    "mcp-codex-cli": {
      "command": "npx",
      "args": ["mcp-codex-cli", "--allow-npx"]
    }
  }
}

あらゆるコーディングタスクを非インタラクティブモードで実行します。

パラメータ：

• prompt（必須）：実行するタスクの説明
• approvalLevel（オプション）："auto-edit"（ファイル読み取り/書き込み、デフォルト）、"full-auto"（完全自動）
• model（オプション）：使用するモデル（デフォルト："gpt-5"）
• workingDir（オプション）：タスク用の作業ディレクトリ

// コンポーネントのリファクタリング
chat({ 
  prompt: "UserDashboard コンポーネントをクラスコンポーネントの代わりに React hooks を使うようリファクタリング",
  approvalLevel: "auto-edit",
  workingDir: "./src/components"
});

// コード分析
chat({
  prompt: "./src/utils/auth.ts ファイルで JWT トークンのバリデーションはどのように動作しますか？"
});

// デバッグ
chat({
  prompt: "TypeError: Cannot read property 'length' of undefined というエラーがフォーム送信時のユーザー入力バリデーション関数で発生しています。./src/components/UserForm.tsx を確認してデバッグしてください。"
});

// コード生成
chat({
  prompt: "バリアント（primary、secondary、danger）とサイズ（small、medium、large）を持つ再利用可能な Button コンポーネントを TypeScript + React で ./src/components/Button.tsx に作成してください",
  model: "gpt-5"
});

Codex CLI の認証を設定：

# オプション1：OpenAI API キー
export OPENAI_API_KEY=your_api_key_here

# オプション2：ChatGPT アカウントを使用
# --allow-npx使用時は初回実行時に自動でサインインプロンプトが表示されます
# ローカルインストール時は以下を実行:
codex auth login

--allow-npx フラグを使用すると：

• Codex CLI をローカルにインストールする必要がありません
• 自動的に npx @openai/codex を使用して実行します
• 信頼されていないディレクトリでも動作します（--skip-git-repo-check を自動追加）
• 常に最新バージョンのCodex CLIを使用できます

すべてのツールは gpt-5 をデフォルトモデルとして使用します（Codex CLI の現在のデフォルト）。任意のツール呼び出しで model パラメータを指定してこれを上書きできます：

• gpt-5（デフォルト）
• gpt-4.1
• gpt-4.1-mini
• o1
• o1-mini

• auto-edit：ファイルの読み取りと書き込み；シェルコマンドには承認が必要（デフォルト）
• full-auto：完全に自動実行（注意して使用）

--allow-npx オプションを使用していればこのエラーは自動的に回避されます。手動で解決する場合：

# 信頼できるディレクトリとしてマーク
codex trust .

# または--skip-git-repo-checkを使用
codex --skip-git-repo-check exec "your task"

# OpenAI API キーを設定
export OPENAI_API_KEY=your_api_key_here

# またはChatGPTアカウントでログイン
codex auth login

• Model Context Protocol（MCP）
• OpenAI Codex CLI
• Claude Code Documentation