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

Codex を接続する

以下の手順では、OpenAI Codex を使用して DoiT MCP サーバーに接続する方法を説明します。

Required permissions​

  • MCP サーバー経由で DoiT Cloud Intelligence に接続してアクセスするには、ユーザーに Billing Profiles Admin 権限が割り当てられている必要があります。

  • DoiT MCP サーバーのツールは DoiT Cloud Intelligence API にマッピングされています。MCP リクエストは、サインイン中の DoiT アカウントで認証されます。さらに、各 DoiT API operation は、それぞれ独自の権限を適用します。

Prerequisites​

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

  • Node.js が PATH に含まれており、npx で @doitintl/doit-mcp-server を実行できること。

  • Codex が MCP サーバーを起動した際に DoiT のサインインフローを完了するための、サポート対象の Web ブラウザ。

Connection type​

Codex はローカルの stdio 接続を使用して DoiT MCP に接続します。Codex は npx を使用して、標準入出力（stdio）経由で、マシン上の公開パッケージ（@doitintl/doit-mcp-server）を起動します。Node.js が PATH に含まれていることを確認してください。

CLI と IDE 拡張機能は、config.toml 内の同じ MCP 設定を共有します。Codex MCP configuration を参照してください。

Configure the DoiT MCP server​

  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 テーブルを追加してください）。

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

    または、ターミナルで次のコマンドを実行します。

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

  4. Codex（CLI または IDE 拡張機能）を起動します。Codex が DoiT MCP サーバーを起動すると、ブラウザで DoiT のサインインページが開きます。DoiT アカウントでサインインしてください。

  5. DoiT の同意画面で Allow access を選択します。

    DoiT consent screen

    注意

    認可が ofid_ で始まる参照コードとともに失敗した場合は、組織のプランに DoiT API アクセスが含まれていること、また DoiT アカウントに Billing Profiles Admin 権限が付与されていることを確認してください。詳細については、Troubleshooting を参照してください。

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

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

に最終更新