A2MCP 接入指南#

什么是 A2MCP#

A2MCP（Agent-to-MCP）是 OKX.AI 上 ASP 提供标准化、可由 Agent 调用服务的类型。服务可以免费，也可以按次通过 x402 收费。

A2MCP 服务按 endpoint 类型分为以下两类：

endpoint 类型	适用情况	调用定义来源
MCP 类型 endpoint	支持 MCP 协议，可发现并调用一个或多个 Tool	`tools/list` 返回的 Tool 定义
HTTP 类型 endpoint	普通 HTTP API	endpoint、请求方式、参数定义和请求示例

确认你的服务适合接入#

适合 A2MCP 的服务通常能清楚地抽象为「输入参数 → 明确结果」，并能由程序完成调用和交付。

特征	说明	示例
有结构化数据或能力	能通过接口返回明确结果，而非纯人工处理	天气、汇率、地图、行情、企业信息
可工具化	每项能力可拆成带参数的功能	查询订单、生成发票、翻译
结果可校验、风险较低	返回值相对确定	查询类、只读类服务
有持续价值	用户可能重复调用	数据 API、行业知识库、垂直搜索

接入前准备#

先选择你要接入的 endpoint 类型，再按对应的 4 个步骤完成准备。

MCP

HTTP API

构建 MCP Server

使用 MCP 官方 SDK 创建 Server，并将业务能力注册为 Tool。已有数据库、HTTP API 或 SaaS 时，可以在 Tool 的处理函数中调用这些能力

推荐学习顺序：

官方资料	用来解决什么问题
Build an MCP server	理解 Server、Tool 定义和客户端调用的基本流程
官方 SDK 索引	选择开发语言及其 SDK
Python SDK v1 文档	查看工具定义和 Streamable HTTP 示例
TypeScript SDK v1 Server 文档	查看工具注册及 Streamable HTTP Server 示例

注意协议版本和传输方式

官方教程与 SDK 持续更新，示例可能使用本地 stdio 或不同协议版本。本文的 OKX.AI 接入流程包含 initialize 握手，请选择能与平台协商兼容协议版本的实现。

2
定义工具并配置收费
定义MCP Tool
工具字段用途
name 程序调用工具的标识
title 平台展示的服务名称
description 说明服务用途、能力与返回结果
inputSchema 定义参数结构、类型、必填项及约束
OKX.AI 要求 title 和 description 非空；一个 Tool 可对应一个 Service，多个 Service 可以共用同一个 MCP Endpoint。
配置收费
收费 Tool 的价格信息也应维护在 MCP Tool / endpoint 中，并确保平台可以解析。
情况一：免费服务
调用 Tool 时直接返回业务结果，无需实现 x402。
情况二：按次收费（x402）
收费应在 tools/call 阶段触发。建议使用 OKX Payment SDK：OKX提供服务端 SDK（@okxweb3/x402-* 支持 Node.js、Go、Rust、Java 和 Python）。为 endpoint 挂上支付中间件并配置收款地址、网络和价格后，SDK 会处理 402 响应与链上验证。完整步骤见通过 SDK 接入。

⚠️ x402 v2 支付挑战需 base64 编码后放入 PAYMENT-REQUIRED 响应头。市场校验的是响应头，不是响应体；建议使用 SDK，避免挑战格式或位置错误。
json
{ "x402Version": 2, "resource": { "url": "https://<your-public-endpoint>/...", "description": "<service-description>", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:196", "asset": "0x779ded0c9e1022225f8e0630b35a9b54be713736", "amount": "10000", "payTo": "0x<your-x-layer-wallet>", "maxTimeoutSeconds": 300, "extra": { "name": "USD₮0", "version": "1" } } ] }
收费 endpoint 应先校验必填参数，再返回支付要求，避免用户为无效请求付款。支付挑战中的网络、支付方式、资产、代币名称与版本、金额和收款地址必须完整；实际金额必须与平台解析出的价格一致。
3
部署并验证 MCP 服务
完成部署后，使用官方 MCP Inspector 或兼容 MCP Client 连接公网 HTTPS MCP 地址，例如 https://你的域名/mcp，验证以下流程：
text
客户端 initialize → 服务端返回初始化结果 → 客户端 notifications/initialized → tools/list 获取工具定义 → tools/call 携带有效 arguments 调用指定工具
确认可以发现并调用需要上架的工具，title、description 和参数定义准确，业务结果符合声明。收费 Tool 还需验证业务调用的支付要求，以及支付授权后重放同一调用能否正常交付。
不要仅以网页能打开、HTTP 200 或有进度消息作为调用成功依据。工具发现与调用可参考 SDK 文档，连接排障参考 MCP 官方调试指南。
4
注册到 OKX.AI
按 ASP 注册流程提交 Endpoint。

工具字段	用途
name	程序调用工具的标识
title	平台展示的服务名称
description	说明服务用途、能力与返回结果
inputSchema	定义参数结构、类型、必填项及约束

1
构建 HTTP API
提供能够通过 GET 或 POST 调用的业务接口。已有 API 可以跳过此步；从零开发可参考 FastAPI 官方教程，或使用你熟悉的 Web 框架。
数据库、内部系统或 SaaS 都可以作为服务端的数据与能力来源，但不能直接将内部地址当作对外 Endpoint。

准备调用信息并配置收费

信息	准备要求
服务名称	用户可理解的名称
服务描述	说明服务用途、能力及返回结果
请求方法	GET 或 POST，与实际接口一致
入参格式	每个参数的名称、类型、含义和是否必填；无参数时说明“无参数”

参数类型包括 string、number、boolean、array、object；对象和数组需说明其内容。例如：city（string，必填）：需要查询的城市名称。

注册不额外要求完整 cURL、每个参数的默认值、示例值、location 或手写 Schema JSON；验证所需的有效业务入参按 Agent 提示提供。

配置收费

完成调用定义后，选择免费或按次收费：

情况一：免费服务

接口被调用时直接返回业务结果（HTTP 200），无需实现 x402。

情况二：按次收费（x402）

价格来自 endpoint 的 x402 设置。建议使用 OKX Payment SDK：OKX提供服务端 SDK（@okxweb3/x402-* 支持 Node.js、Go、Rust、Java 和 Python）。为 endpoint 挂上支付中间件并配置收款地址、网络和价格后，SDK 会处理 402 响应与链上验证。完整步骤见通过 SDK 接入。

⚠️ x402 v2 支付挑战需 base64 编码后放入 PAYMENT-REQUIRED 响应头。市场校验的是响应头，不是响应体；建议使用 SDK，避免挑战格式或位置错误。

json

{
  "x402Version": 2,
  "resource": {
    "url": "https://<your-public-endpoint>/...",
    "description": "<service-description>",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:196",
      "asset": "0x779ded0c9e1022225f8e0630b35a9b54be713736",
      "amount": "10000",
      "payTo": "0x<your-x-layer-wallet>",
      "maxTimeoutSeconds": 300,
      "extra": { "name": "USD₮0", "version": "1" }
    }
  ]
}

收费 endpoint 应先校验必填参数，再返回支付要求，避免用户为无效请求付款。支付挑战中的网络、支付方式、资产、代币名称与版本、金额和收款地址必须完整；实际金额必须与平台解析出的价格一致。

3
部署并验证 HTTP API
部署 HTTP API 并为域名配置 HTTPS，确保第三方依赖、网络访问和服务端凭据已配置好。
使用 curl 或等效客户端，按真实请求方法和有效参数调用公网 HTTPS 业务路由，检查响应与业务结果。下面仅展示 POST JSON 请求的结构，请替换为自己的接口与输入：
bash
curl -i -X POST 'https://你的域名/业务路由' \ -H 'Content-Type: application/json' \ -d '{"city":"Shanghai"}'
付费服务还需检查未支付时的 x402 支付要求，以及携带有效支付凭证重放请求后的完整交付。
4
注册到 OKX.AI
按 ASP 注册流程提交 Endpoint。

什么是 A2MCP

确认你的服务适合接入