Codex.io Docs MCP

Codex Docs MCP

將 Codex 文件 MCP 伺服器加入你的 AI 編碼工具，即可即時存取 API 文件。

Codex 文件以 Model Context Protocol (MCP) 伺服器的形式提供。將其加入你的 AI 編碼工具後，它就能直接搜尋並參考 Codex API 文件，讓你在不離開編輯器的情況下獲得準確的答案。

https://docs.codex.io/mcp

功能說明

連線後，你的 AI 工具即可搜尋完整的 Codex API 文件——包括查詢、訂閱、型別與指南。當你詢問關於 Codex API 的問題或需要協助撰寫查詢時，它會自動參考文件。

資訊

此 MCP 伺服器用於搜尋文件並協助你的 AI 撰寫查詢。它不會直接與 Codex API 互動——你仍需要使用 API 金鑰透過 GraphQL 端點 或 SDK 來執行查詢。

Docs MCP 與 Codex Skills 的比較

Codex Skills 為你的 AI 代理提供預載的 API 知識，使其能直接與 API 互動。Docs MCP 則讓它搜尋文件，進而能夠撰寫 GraphQL 查詢。

	Docs MCP	Codex Skills
運作方式	透過 MCP 協定隨需搜尋文件	預載 API 知識——操作、驗證、範本
最適合	查詢特定欄位、型別或指南	直接與 Codex API 互動
需要網路？	是——查詢 MCP 伺服器	可離線撰寫查詢（呼叫 API 時仍需連線）

建議兩者同時使用以獲得最佳體驗：Skill 負責查詢生成，MCP 在需要時補充細節。

設定

注意

Codex (codex.io) 是一個區塊鏈資料 API。它不是 OpenAI Codex 編碼代理。你仍然可以將此 MCP 伺服器加入 OpenAI Codex，如下所示。

使用 `Cmd+Shift+P` (Mac) 或 `Ctrl+Shift+P` (Windows/Linux) 開啟 MCP 設定，並選擇 **Cursor Settings: Open MCP Settings**。加入以下內容：

```json theme={null}
{
  "mcpServers": {
    "codex-docs": {
      "url": "https://docs.codex.io/mcp"
    }
  }
}
```

在專案根目錄建立 `.vscode/mcp.json` 檔案：

```json theme={null}
{
  "servers": {
    "codex-docs": {
      "type": "http",
      "url": "https://docs.codex.io/mcp"
    }
  }
}
```

開啟位於 `~/.codeium/windsurf/mcp_config.json` 的 MCP 設定檔，並加入以下內容：

```json theme={null}
{
  "mcpServers": {
    "codex-docs": {
      "serverUrl": "https://docs.codex.io/mcp"
    }
  }
}
```

前往 **Settings > Connectors**，選擇 **Add custom connector**，然後輸入：

* **名稱：** Codex Docs
* **URL：** `https://docs.codex.io/mcp`

執行以下指令：

```bash theme={null}
claude mcp add --transport http codex-docs https://docs.codex.io/mcp
```

執行：

```bash theme={null}
codex mcp add codex-docs --url https://docs.codex.io/mcp
```

或將此加入 `~/.codex/config.toml`：

```toml theme={null}
[mcp_servers.codex-docs]
url = "https://docs.codex.io/mcp"
```

範例提示

MCP 連線後，你可以要求 AI 助理使用 Codex API 建置功能。以下是一些入門範例。

取得代幣價格

「使用 Codex API 取得以太坊上 WETH 目前的美元價格。」

你的助理會查詢 getTokenPrices 查詢並撰寫類似以下的內容：

query {
  getTokenPrices(
    inputs: [
      {
        address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
        networkId: 1
      }
    ]
  ) {
    address
    priceUsd
  }
}

建立熱門代幣動態

「告訴我如何取得 Base 上按 24 小時交易量排序的前 10 大熱門代幣。」

query {
  filterTokens(
    filters: { network: [8453] }
    rankings: [{ attribute: volume24, direction: DESC }]
    limit: 10
  ) {
    results {
      token {
        name
        symbol
        address
      }
      volume24
      priceUSD
      change24
    }
  }
}

呈現價格圖表

「取得此代幣在 Solana 上過去 24 小時的 1 小時 OHLCV 蠟燭圖資料：So11111111111111111111111111111111111111112。」

query {
  getBars(
    symbol: "So11111111111111111111111111111111111111112:1399811149"
    from: 1719792000
    to: 1719878400
    resolution: "60"
  ) {
    o
    h
    l
    c
    volume
    t
  }
}

串流即時交易

「設定 WebSocket 訂閱，串流以太坊上某代幣的即時互換事件。」

subscription {
  onEventsCreated(
    address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    networkId: 1
  ) {
    address
    networkId
    events {
      eventDisplayType
      timestamp
      maker
      token0SwapValueUsd
      token1SwapValueUsd
      transactionHash
    }
  }
}

追蹤錢包持倉

「取得 Base 上某錢包的所有代幣餘額。」

query {
  balances(
    input: {
      walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      networks: [8453]
    }
  ) {
    items {
      tokenAddress
      balance
      shiftedBalance
      token {
        name
        symbol
      }
    }
  }
}

探索新上線代幣

「找出 Solana 上過去一小時內上線且流動性至少 $10k 的代幣。」

query {
  filterTokens(
    filters: {
      network: [1399811149]
      liquidity: { gte: 10000 }
      createdAt: { gte: 1719874800 }
    }
    rankings: [{ attribute: createdAt, direction: DESC }]
    limit: 20
  ) {
    results {
      token {
        name
        symbol
        address
      }
      liquidity
      priceUSD
      createdAt
    }
  }
}

提示

你不需要記住這些內容——只要描述你的需求，AI 助理就會從文件中查詢正確的查詢。以上範例僅用於展示可能性。

此文件由 Mintlify 建置與託管，這是一個開發者文件平台。