Codex.io Docs MCP

chính thức

MCP để đọc API dữ liệu crypto của Codex, giúp các tác nhân có thể viết truy vấn GraphQL.

Bạn có thể làm gì với Codex Io Docs MCP?

  • Tìm kiếm tài liệu API Codex — Yêu cầu trợ lý của bạn tra cứu truy vấn, gói đăng ký, loại dữ liệu hoặc hướng dẫn từ toàn bộ tài liệu Codex qua https://docs.codex.io/mcp.
  • Tạo truy vấn GraphQL — Nhờ trợ lý viết các truy vấn như lấy giá token, token xu hướng hoặc số dư ví bằng cách mô tả nhu cầu của bạn bằng ngôn ngữ thông thường.
  • Xây dựng tính năng dữ liệu thời gian thực — Yêu cầu đăng ký WebSocket để phát trực tiếp sự kiện hoán đổi hoặc theo dõi biểu đồ giá token với dữ liệu nến OHLCV.
  • Khám phá token mới — Yêu cầu danh sách token được lọc dựa trên tiêu chí như thời gian ra mắt, thanh khoản hoặc khối lượng giao dịch trực tiếp từ tài liệu.

Tài liệu

Codex Docs MCP

Thêm máy chủ MCP tài liệu Codex vào các công cụ lập trình AI của bạn để truy cập tức thì tài liệu API.

Tài liệu Codex có sẵn dưới dạng máy chủ Model Context Protocol (MCP). Thêm nó vào công cụ lập trình AI của bạn cho phép công cụ tìm kiếm và tham chiếu trực tiếp tài liệu API Codex, để bạn có thể nhận được câu trả lời chính xác mà không cần rời khỏi trình soạn thảo.

https://docs.codex.io/mcp

Chức năng

Khi đã kết nối, công cụ AI của bạn có thể tìm kiếm toàn bộ tài liệu API Codex — bao gồm truy vấn, đăng ký, kiểu dữ liệu và hướng dẫn. Công cụ sẽ tự động tham chiếu tài liệu khi bạn đặt câu hỏi về API Codex hoặc cần trợ giúp viết truy vấn.

Thông tin

Máy chủ MCP này dùng để tìm kiếm tài liệu và hỗ trợ AI của bạn viết truy vấn. Nó không giao tiếp trực tiếp với API Codex — bạn vẫn cần thực thi truy vấn bằng khóa API của mình qua điểm cuối GraphQL hoặc SDK.

Docs MCP so với Codex Skills

Codex Skills cung cấp cho tác nhân AI của bạn kiến thức được nạp sẵn về API để nó có thể giao tiếp trực tiếp với API. Docs MCP cho phép nó tìm kiếm tài liệu, từ đó có thể viết các truy vấn GraphQL.

Docs MCPCodex Skills
Cách hoạt độngTìm kiếm tài liệu theo yêu cầu qua giao thức MCPKiến thức API được nạp sẵn — thao tác, xác thực, mẫu
Phù hợp nhất choTra cứu các trường, kiểu dữ liệu hoặc hướng dẫn cụ thểTương tác trực tiếp với API Codex
Cần mạng?Có — truy vấn máy chủ MCPHoạt động ngoại tuyến để viết truy vấn (vẫn cần kết nối để gọi API)

Sử dụng cả hai cùng nhau để có trải nghiệm tốt nhất: skill xử lý việc tạo truy vấn và MCP bổ sung chi tiết khi cần.

Thiết lập

Lưu ý

Codex (codex.io) là một API dữ liệu blockchain. Nó không phải là OpenAI Codex, tác nhân lập trình. Bạn vẫn có thể thêm máy chủ MCP này vào OpenAI Codex, như minh họa bên dưới.

Mở cài đặt MCP bằng `Cmd+Shift+P` (Mac) hoặc `Ctrl+Shift+P` (Windows/Linux) và chọn **Cursor Settings: Open MCP Settings**. Thêm nội dung sau:
```json theme={null}
{
  "mcpServers": {
    "codex-docs": {
      "url": "https://docs.codex.io/mcp"
    }
  }
}
```
Tạo một tệp `.vscode/mcp.json` trong thư mục gốc dự án của bạn:
```json theme={null}
{
  "servers": {
    "codex-docs": {
      "type": "http",
      "url": "https://docs.codex.io/mcp"
    }
  }
}
```
Mở tệp cấu hình MCP tại `~/.codeium/windsurf/mcp_config.json` và thêm nội dung sau:
```json theme={null}
{
  "mcpServers": {
    "codex-docs": {
      "serverUrl": "https://docs.codex.io/mcp"
    }
  }
}
```
Đi tới **Settings > Connectors**, chọn **Add custom connector**, sau đó nhập:
* **Tên:** Codex Docs
* **URL:** `https://docs.codex.io/mcp`
Chạy lệnh sau:
```bash theme={null}
claude mcp add --transport http codex-docs https://docs.codex.io/mcp
```
Chạy:
```bash theme={null}
codex mcp add codex-docs --url https://docs.codex.io/mcp
```

Hoặc thêm nội dung này vào `~/.codex/config.toml`:

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

Ví dụ về lời nhắc

Khi MCP đã được kết nối, bạn có thể yêu cầu trợ lý AI của mình xây dựng các tính năng bằng API Codex. Dưới đây là một số ví dụ để bắt đầu.

Lấy giá token

"Sử dụng API Codex để lấy giá USD hiện tại của WETH trên Ethereum."

Trợ lý của bạn sẽ tra cứu truy vấn getTokenPrices và viết nội dung như sau:

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

Xây dựng nguồn cấp token xu hướng

"Chỉ cho tôi cách lấy 10 token xu hướng hàng đầu trên Base được sắp xếp theo khối lượng 24 giờ."

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

Hiển thị biểu đồ giá

"Lấy nến OHLCV 1 giờ trong 24 giờ qua cho token này trên Solana: So11111111111111111111111111111111111111112."

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

Truyền phát giao dịch trực tiếp

"Thiết lập đăng ký WebSocket để truyền phát các sự kiện hoán đổi theo thời gian thực cho một token trên Ethereum."

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

Theo dõi số dư ví

"Lấy tất cả số dư token cho một ví trên Base."

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

Khám phá các đợt ra mắt mới

"Tìm các token được ra mắt trong giờ qua trên Solana có thanh khoản ít nhất $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
    }
  }
}

Mẹo

Bạn không cần phải ghi nhớ bất kỳ điều gì trong số này — chỉ cần mô tả những gì bạn muốn và trợ lý AI của bạn sẽ tra cứu truy vấn phù hợp từ tài liệu. Các ví dụ trên chỉ để minh họa những gì có thể thực hiện.

Tài liệu này được xây dựng và lưu trữ trên Mintlify, một nền tảng tài liệu dành cho nhà phát triển.