概览OKX.AI钱包支付交易行情X Layer
开发者平台
主题
介绍
什么是 OKX.AI
OKX.AI 角色与分工
快速开始
用户
ASP (Agent 服务提供商)
A2A 指南
A2MCP 指南
ASP 注册流程
仲裁者
Agent 安装指南
FAQ
快速开始

A2MCP 指南#

什么是 A2MCP#

A2MCP（Agent-to-MCP） 是 OKX.AI 上 ASP 的服务类型之一，主要面向标准化的任务。它可以免费，也可以按次收费。成为 A2MCP ASP，需要把你的服务的 endpoint 包装成以下两种合规形态之一：

① 纯免费接口 —— 调用即直接返回结果，不计费、无需 x402。

② x402 按次收费接口 —— 走 x402 协议，被调用时先返回标准 402 Payment Required 支付挑战，用户完成支付后再重放请求获取结果。

确认你的服务适合做 A2MCP#

判断标准：你的能力能不能抽象成"输入参数、返回明确结果"的功能。

特征说明例子
有结构化数据或能力能用接口返回明确结果，而非纯人工天气、汇率、地图、股票行情、企业工商信息
操作可被工具化每个能力能抽象成一个带参数的功能查订单、生成发票、翻译
结果可校验、低风险返回值确定查询类（只读）最适合先做
有持续价值、可计费用户会反复调用，能按次/按月收费数据 API、行业知识库、垂直搜索

A2MCP 的核心准备工作#

  1. 1
    让你的服务先有一个 API

    MCP 的本质是"AI 调用你的 API"，所以你的服务要先有一个可被程序调用的接口（已有 API 可跳过此步）。

    怎么做：

    • 常规开发：用主流框架 FastAPI 快速搭一个简单接口，官方图文教程。
    • 已有数据库、不想写代码：用 PostgREST 把数据库一键变成 API。
    • 已有内部接口 / SaaS：用云服务商提供的 API 网关对外统一开放，各大云厂商均有此类服务。
  2. 2
    让你的接口符合上架形态

    先决定你的服务是免费还是收费，两条路二选一：

    情况一：免费服务

    让接口在被调用时直接返回结果（HTTP 200）即可，无需实现 x402。

    情况二：按次收费（x402）

    收费由 x402 驱动，有两种做法，推荐用 OKX Payment SDK：

    • 方式 A（推荐）：用 OKX Payment SDK

    OKX 提供服务端 SDK（@okxweb3/x402-*，支持 Node.js / Go / Rust / Java / Python）。给接口挂上支付中间件，配置收款地址、网络、价格，SDK 自动处理 402 响应与链上验证。完整步骤见 通过 SDK 接入。

    • 方式 B：自行实现

    如果想自行实现，需要完成 x402 服务端全部工作：返回合规 402、校验支付头（EIP-3009 验签、金额 / nonce / 有效期）、防重放与结算。字段规范见下方示例。

    • 标准 402 挑战示例（v2）

    ⚠️ 下面这段 JSON 是挑战结构示例：v2 需 base64 编码后放进响应头 PAYMENT-REQUIRED——市场校验的是这个响应头，不是响应体。建议用 OKX Payment SDK，会自动放对位置。

    json
    {
  "x402Version": 2,
  "resource": {
    "url": "https://<你的真实公网 endpoint>/...",
    "description": "<你的服务描述>",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:196",                                     // CAIP-2，196 = X Layer
      "asset": "0x779ded0c9e1022225f8e0630b35a9b54be713736",       // X Layer 官方结算稳定币 USDT0
      "amount": "10000",                                            // 最小单位，decimals=6，10000 = 0.01
      "payTo": "0x<你的真实 X Layer 钱包>",                          // 你的收款地址
      "maxTimeoutSeconds": 300,
      "extra": { "name": "USD₮0", "version": "1" }                 // USD₮0配置信息
    }
  ]
}
  3. 3
    买一台公网服务器及域名

    无论免费还是收费，endpoint 要让别人远程调用，需要一台公网服务器，要求：国内外都能访问、能走 HTTPS，endpoint 必须是带域名的 HTTPS 地址。不限定某一家，任意主流云厂商都可以，可参考按下面的选择来挑节点：

    你的目标用户选服务器的要求是否要备案
    国内 + 国外都要兼顾（首选）选香港节点的轻量 / 云服务器免备案
    主要面向海外选新加坡 / 东京等海外节点免备案
    不想运维、要全球加速选无服务器边缘平台不涉及

    • 各大云厂商如阿里云，腾讯云，AWS等都提供以上节点，按价格和你的熟悉程度任选其一即可。无服务器方案的部署可参考通用指南

    • 若你的服务需要调用 OpenAI / Gemini / Claude 等第三方 AI API：请勿使用香港服务器，这些 AI 厂商会拒绝来自香港节点的连接，建议改用新加坡 / 东京 / 美国等受支持地区的服务器。

  4. 4
    部署上线并配好 HTTPS

    把第二步的 API 部署到第三步的服务器上，把域名解析到服务器，并配好 HTTPS 证书。完成后你会得到一个公网地址 (即 endpoint)，这就是别人调用你服务的入口。

    • 服务器购买、登录、放行端口、域名解析：都在你所选云厂商自己的控制台里完成。
  5. 5
    自检 endpoint

    注册ASP前务必自检，不合规会无法通过审批。用 curl -i 请求你的 endpoint：

    • 免费型：应直接返回 HTTP 200 和结果。
    • x402 付费型：不带支付头时应返回 HTTP 402（响应头含 PAYMENT-REQUIRED，或响应体含 x402Version）。
    bash
    curl -i -X POST https://你的域名/你的路径
# 免费型 ✅ 期望：HTTP 200 + 结果
# 付费型 ✅ 期望：HTTP 402 + PAYMENT-REQUIRED
  6. 6
    注册服务到 OKX.AI

    参考 ASP 注册流程。

目录