メインコンテンツへスキップ

Codex を接続する

以下の手順では、OpenAI Codex を使用して MCP サーバーに接続する方法を説明します。接続する前に、必要な権限 を満たしていることを確認してください。

前提条件​

  • Codex がインストールされていること（CLI または IDE 拡張機能）。

  • stdio を利用する場合、@doitintl/doit-mcp-server を実行できるように、npx が PATH 上の Node.js を参照できること、および DOIT_API_KEY として設定するための 個人用 API トークン を準備していること。

  • Streamable HTTP を利用する場合、接続時に DoiT のサインインフローを完了するためにサポートされている Web ブラウザがあること。

サポートされている接続方法​

Codex（CLI および IDE 拡張機能）は stdio と Streamable HTTP をサポートしています。CLI と IDE 拡張機能は config.toml 内の同じ MCP 設定を共有します。Codex MCP configuration および Connection methods を参照してください。

stdio で設定する​

  1. 次のいずれかの場所にある Codex の config.toml ファイルを作成または編集します。

    • すべてのプロジェクト（ユーザー）: macOS および Linux の場合は ~/.codex/config.toml、Windows の場合は %USERPROFILE%\.codex\config.toml

    • 1 つのプロジェクト: 信頼されたプロジェクトのルートにある .codex/config.toml。.codex ディレクトリが存在しない場合は作成してください。

  2. テキストエディタでその config.toml ファイルを開きます。

  3. 次の設定を追加またはマージします（ファイルに他のキーがすでにある場合は、既存の内容を削除せずに mcp_servers テーブルを追加してください）。your_doit_api_key を 個人用 API トークン に置き換えてください。

    [mcp_servers.doit_mcp_server]
    command = "npx"
    args = ["-y", "@doitintl/doit-mcp-server@latest"]

    [mcp_servers.doit_mcp_server.env]
    DOIT_API_KEY = "your_doit_api_key"

    もしくは、ターミナルで次のコマンドを実行します（事前に環境変数で DOIT_API_KEY を設定するか、上記の env テーブルを追加してください）。

    codex mcp add doit_mcp_server -- npx -y @doitintl/doit-mcp-server@latest

  4. Codex（CLI または IDE 拡張機能）を起動します。ローカルの stdio は DOIT_API_KEY で認証を行い、ブラウザによるサインインフローは開きません。

  5. 接続を確認します。Codex CLI では /mcp を実行し、MCP サーバーが一覧に表示され、そのツールが利用可能であることを確認してください。IDE 拡張機能では MCP 設定を開き、サーバーステータスを確認してください。

    これで、Codex セッションを開始し、Cloud Intelligence データに関連する質問やリクエストを行うことができます。

Streamable HTTP で設定する​

  1. stdio で設定する で説明した同じ config.toml ファイルを作成または編集します。

  2. command ・ args の代わりに URL エントリを使用します。

    [mcp_servers.doit_mcp_server]
    url = "https://mcp.doit.com/mcp"

  3. Codex を起動し、プロンプトが表示されたら DoiT のサインインおよび同意フローを完了し、その後 /mcp（CLI）または IDE の MCP 設定で接続を確認します。

に最終更新