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ý tra cứu các truy vấn, subscription, kiểu dữ liệu và hướng dẫn trong tài liệu Codex khi bạn lập trình.
  • Viết truy vấn GraphQL — Mô tả dữ liệu bạn muốn và yêu cầu trợ lý tham khảo tài liệu để soạn truy vấn GraphQL Codex phù hợp.
  • Tra cứu trường và kiểu dữ liệu — Yêu cầu trợ lý tìm các trường, đối số hoặc định nghĩa kiểu dữ liệu cụ thể trong tài liệu API Codex.
  • Tham khảo hướng dẫn khi cần — Yêu cầu trợ lý trích dẫn các hướng dẫn hoặc ví dụ Codex phù hợp từ tài liệu trong khi thực hiện tác vụ.

Tài liệu

Codex Docs MCP

Thêm máy chủ MCP tài liệu Codex vào Claude Code, Cursor và các công cụ lập trình AI khác để chúng có thể tìm kiếm tài liệu API Codex trong khi bạn xây dựng.

Tài liệu Codex có sẵn dưới dạng máy chủ Model Context Protocol (MCP). Thêm máy chủ này vào công cụ lập trình AI của bạn để công cụ có thể tìm kiếm và tham khảo trực tiếp tài liệu API Codex, giúp bạn 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

Sau 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 khảo 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.

[!NOTE]

Máy chủ MCP này dùng để tìm kiếm tài liệu và hỗ trợ AI viết truy vấn. Máy chủ 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 thông qua điểm cuối GraphQL hoặc SDK.

Docs MCP và Codex Skills

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

Docs MCPCodex Skills
Cách hoạt độngTìm kiếm tài liệu theo yêu cầu thông qua giao thức MCPKiến thức API được tải sẵn — các 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ủ MCPCó thể viết truy vấn khi ngoại tuyến (vẫn cần kết nối để gọi API)

Để có trải nghiệm tốt nhất, hãy dùng cả hai cùng nhau: skill xử lý việc tạo truy vấn, còn MCP bổ sung thông tin chi tiết khi cần.

Thiết lập

[!NOTE]

Codex (codex.io) là một API dữ liệu blockchain. Đây không phải 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ư hướng dẫn bên dưới.

[tab] Cursor

Mở cài đặt MCP bằng Cmd+Shift+P (Mac) hoặc Ctrl+Shift+P (Windows/Linux), rồi chọn Cursor Settings: Open MCP Settings. Thêm nội dung sau:

{
  "mcpServers": {
    "codex-docs": {
      "url": "https://docs.codex.io/mcp"
    }
  }
}

[tab] VS Code

Tạo tệp .vscode/mcp.json trong thư mục gốc dự án:

{
  "servers": {
    "codex-docs": {
      "type": "http",
      "url": "https://docs.codex.io/mcp"
    }
  }
}

[tab] Windsurf

Mở tệp cấu hình MCP tại ~/.codeium/windsurf/mcp_config.json và thêm nội dung sau:

{
  "mcpServers": {
    "codex-docs": {
      "serverUrl": "https://docs.codex.io/mcp"
    }
  }
}

[tab] Claude Desktop

Vào Settings > Connectors, chọn Add custom connector, rồi nhập:

  • Name: Codex Docs
  • URL: https://docs.codex.io/mcp

[tab] Claude Code

Chạy lệnh sau:

claude mcp add --transport http codex-docs https://docs.codex.io/mcp

[tab] OpenAI Codex

Chạy:

codex mcp add codex-docs --url https://docs.codex.io/mcp

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

[mcp_servers.codex-docs]
url = "https://docs.codex.io/mcp"

Ví dụ câu lệnh

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

Lấy giá token

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

Trợ lý sẽ tra cứu truy vấn getTokenPrices và viết nội dung tương tự như sau:

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

Tạo nguồn cấp token thịnh hành

"Chỉ cho tôi cách lấy 10 token thịnh hành hàng đầu trên Base, sắp xếp theo khối lượng giao dịch 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
  }
}

Phát trực tiếp giao dịch

"Thiết lập đăng ký WebSocket để phát trực tiếp 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 số dư của tất cả token trong một ví trên Base."

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

Khám phá token mới ra mắt

"Tìm các token ra mắt trong giờ qua trên Solana với 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
    }
  }
}

[!TIP]

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

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.