> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Codex は OpenAI の AI コーディングエージェントです。このページでは、Codex を Connect AI MCP サーバーに接続する方法を説明します。

Connect AI はデフォルトで OAuth 認証を使用しますが、Personal Access Token（PAT）を使用した Basic 認証も使用できます。

## 前提条件

Codex を Connect AI と連携させる前に、まず以下を準備する必要があります：

* Connect AI アカウントにデータソースを接続する。詳細については、[ソース](/ja/Sources) を参照してください。
* [Node.js](https://nodejs.org) 18 以降をインストールする。
* Codex を含む ChatGPT プラン（Plus、Pro、Business、Edu、または Enterprise）を持つ、または OpenAI API キーを持つ。
* （Basic 認証のみ）[Settings](/ja/Settings#personal-access-tokens) ページで Personal Access Token（PAT）を生成する。PAT をコピーし、認証時にパスワードとして使用します。

## Connect AI への接続

### OAuth 認証

<Steps>
  <Step>
    Codex CLI をグローバルにインストールします：

    ```bash theme={null}
    npm install -g @openai/codex
    ```
  </Step>

  <Step>
    Codex を起動してサインインします：

    ```bash theme={null}
    codex
    ```

    Codex を初めて実行する際は、**Sign in with ChatGPT** を選択し、ブラウザで認証を完了します。代わりに API キーを使用するには、`OPENAI_API_KEY` 環境変数を設定します。
  </Step>

  <Step>
    Connect AI MCP サーバーを登録します。Codex の設定ファイル `~/.codex/config.toml` を開き、以下を追加します：

    ```toml theme={null}
    [mcp_servers.connectai]
    url = "https://mcp.cloud.cdata.com/mcp"
    startup_timeout_sec = 30
    ```
  </Step>

  <Step>
    Connect AI MCP サーバーに認証します：

    ```bash theme={null}
    codex mcp login connectai
    ```

    ブラウザで OAuth フローを完了します。ChatGPT でのサインインは Codex への認証ですが、Connect AI MCP サーバーに認証するにはこのコマンドを別途実行する必要があります。認証が完了すると、`Successfully logged in to MCP server 'connectai'` というメッセージが表示されます。
  </Step>

  <Step>
    Codex がサーバーを登録したことを確認します：

    ```bash theme={null}
    codex mcp list
    ```
  </Step>
</Steps>

### Basic 認証

<Steps>
  <Step>
    Codex CLI をグローバルにインストールします：

    ```bash theme={null}
    npm install -g @openai/codex
    ```
  </Step>

  <Step>
    Codex を起動してサインインします：

    ```bash theme={null}
    codex
    ```

    Codex を初めて実行する際は、**Sign in with ChatGPT** を選択し、ブラウザで認証を完了します。代わりに API キーを使用するには、`OPENAI_API_KEY` 環境変数を設定します。
  </Step>

  <Step>
    Connect AI MCP サーバーを登録します。Codex の設定ファイル `~/.codex/config.toml` を開き、以下を追加します：

    ```toml theme={null}
    [mcp_servers.connectai]
    url = "https://mcp.cloud.cdata.com/mcp"
    http_headers = { "Authorization" = "Basic <Your_Base64Encoded_EMAIL:PAT>" }
    startup_timeout_sec = 30
    ```

    `<Your_Base64Encoded_EMAIL:PAT>` を、Connect AI のメールアドレスと PAT を `email:PAT` の形式で Base64 エンコードした値に置き換えます。
  </Step>

  <Step>
    Codex がサーバーを登録したことを確認します：

    ```bash theme={null}
    codex mcp list
    ```
  </Step>
</Steps>

## Codex セッションの開始

Codex セッションを開始し、自然言語プロンプトでデータを探索します。Codex は Connect AI MCP サーバーを使用してライブデータをクエリします。

<Frame>
  <img src="https://mintcdn.com/cdata/vbsnuniDZdFJKTDC/ja/images/codex_client_prompt.png?fit=max&auto=format&n=vbsnuniDZdFJKTDC&q=85&s=5b0dcc6328871b733e72245238306c16" alt="" width="1377" height="605" data-path="ja/images/codex_client_prompt.png" />
</Frame>

プロンプトのアイデアについては、CData の[プロンプトライブラリ](https://jp.cdata.com/ai/prompt-library/)を参照してください。

<Note>
  Codex が MCP の起動が未完了であると報告した場合、サーバーは Codex のデフォルトの 10 秒の起動ウィンドウ内に初期化されませんでした。サーバー設定の `startup_timeout_sec` を増やし（例：`30` 以上）、Codex を再起動します。初回の接続や OAuth フローでは、追加の時間が必要になることがよくあります。
</Note>

<Note>
  Codex の MCP サポートおよびセットアッププロセスは変更される場合があります。最新のセットアップ情報については、OpenAI の [Codex MCP のドキュメント](https://developers.openai.com/codex/mcp) を参照してください。
</Note>