Codex.io Docs MCP Server

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.

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ì vào tài liệu API.

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

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, subscription, kiểu dữ liệu và hướng dẫn. Nó 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.

Máy chủ MCP này dùng để tìm kiếm tài liệu và giúp 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 thông qua [điểm cuối GraphQL](/learn-graphql) hoặc [SDK](/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 tải 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 MCP	Codex Skills
Cách hoạt động	Tìm kiếm tài liệu theo yêu cầu qua giao thức MCP	Kiến thức API được tải sẵn — thao tác, xác thực, mẫu
Phù hợp nhất	Tra 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ủ MCP	Hoạ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

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 tệp `.vscode/mcp.json` trong thư mục gốc của dự á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"
    }
  }
}
```

Vào **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
```

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

Sau khi MCP được kết nối, bạn có thể yêu cầu trợ lý AI 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 tương tự như:

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

Xây dựng 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 được sắp xếp theo khối lượng 24h."

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 subscription WebSocket để phát trực tiếp các sự kiện hoán đổi 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 với ít nhất $10k thanh khoản."

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
    }
  }
}

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ỉ nhằm minh họa những gì có thể làm được.