# オプション1: ワンコマンドインストール（近日公開）
npx create-codex-mcp --global

# オプション2: ソースから手動インストール
git clone https://github.com/goalseeklabs/codex-mcp-server.git
cd codex-mcp-server
./setup/install.sh

# npmを使用
npm install -g @openai/codex

# またはHomebrew（macOS）
brew install codex

npm install -g codex-mcp-server

codex-mcp-setup

codex.exec ツールを使用してフィボナッチ数を計算するPython関数を作成してください

codex.analyze ツールを使用して、このJavaScriptファイルのセキュリティ脆弱性をチェックしてください: /path/to/file.js

codex.fix ツールを使用して、この関数のパフォーマンス問題を修正してください: [コードを貼り付け]

codex.general ツールを使用してカスタムCodex操作を実行: このコードベースのアーキテクチャを説明してください

codex.search ツールを使用して、React useEffectフックの最新ベストプラクティスを調べてください

codex.search_detailed ツールを使用して、TypeScript genericsの詳しいチュートリアルと実装例を取得してください

{
  "prompt": "ユーザー認証用のREST APIエンドポイントを作成",
  "args": ["--language", "typescript"],
  "workingDirectory": "/path/to/project",
  "timeout": 30000
}

{
  "filePath": "/path/to/file.js",
  "analysisType": "security",
  "workingDirectory": "/path/to/project"
}

{
  "filePath": "/path/to/buggy-file.py",
  "issueDescription": "この関数のメモリリークを修正",
  "workingDirectory": "/path/to/project",
  "dryRun": true
}

{
  "command": "explain",
  "args": ["--detailed", "architecture"],
  "workingDirectory": "/path/to/project",
  "timeout": 60000
}

{
  "query": "React hooks useEffect best practices 2024",
  "provider": "bing",
  "workingDirectory": "/path/to/project",
  "timeout": 30000
}

{
  "query": "TypeScript advanced generics tutorial examples",
  "provider": "bing",
  "maxPages": 3,
  "workingDirectory": "/path/to/project",
  "timeout": 60000
}

~/.config/claude-code/mcp_settings.json

# OpenAI APIキー（ChatGPTサブスクリプションを使用しない場合）
export OPENAI_API_KEY="your-api-key-here"

# オプション: カスタムタイムアウト（ミリ秒）
export CODEX_MCP_TIMEOUT="30000"

{
  "mcpServers": {
    "codex": {
      "command": "codex-mcp",
      "args": [],
      "env": {
        "CODEX_MCP_TIMEOUT": "45000"
      }
    }
  }
}

git clone https://github.com/goalseeklabs/codex-mcp-server.git
cd codex-mcp-server

# 依存関係のインストール
npm install

# TypeScriptのビルド
npm run build

# テストの実行
npm test

# テスト用にグローバルインストール
npm install -g .

# バリデーションテストの実行
npm run test

# 手動バリデーション
node tests/validation.js

# サーバー起動テスト
node tests/startup-test.js

codex-mcp-server/
├── src/
│   ├── index.ts          # メインMCPサーバー
│   ├── codex.ts         # Codex CLI統合
│   └── schemas.ts       # 型定義とバリデーション
├── bin/
│   ├── codex-mcp.js     # CLIエントリーポイント
│   └── setup.js         # セットアップコマンド
├── config/
│   └── claude-code-mcp.json  # Claude Code設定テンプレート
├── setup/
│   └── install.sh       # インストールスクリプト
├── tests/
│   ├── validation.js    # バリデーションテスト
│   └── startup-test.js  # 起動テスト
└── docs/
    └── usage-guide.md   # 詳細使用ガイド

# Codex CLIのインストール
npm install -g @openai/codex
# または
brew install codex

# インストール確認
codex --version

# グローバルインストール確認
npm list -g codex-mcp-server

# 必要に応じて再インストール
npm install -g codex-mcp-server

# PATH確認
echo $PATH

# Claude Codeの再起動
# サーバーログの確認
codex-mcp --version

# セットアップ再実行
codex-mcp-setup

# macOS/Linuxでの権限修正
sudo chown -R $(whoami) ~/.config/claude-code
chmod 755 ~/.config/claude-code

DEBUG=codex-mcp:* codex-mcp