MCP 接入
Model Context Protocol（Streamable HTTP 远程模式）。任何支持 MCP 的 AI 工具， 配置端点与 Bearer token 后即可调用全部 12 个工具。
第一步：获取 token
- 登录 开发者控制台 （成交平台账号）。
- 「新建应用」→ 勾选所需能力（scopes）→ client_secret 仅显示一次，请妥善保存。
- 合作方系统集成需由平台运营将应用「挂靠」到合作方主体后方可调用业务工具。
第二步：配置 MCP
正式环境（生产数据，存证走真实中数链）：
正式环境 · cjapp.cdcee.net
{
"mcpServers": {
"cdcee-open": {
"type": "streamablehttp",
"url": "https://cjapp.cdcee.net/market/openapi/v1/mcp",
"headers": {
"Authorization": "Bearer <你的token>"
}
}
}
}测试环境（沙箱演练：存证不连真实链、不耗配额）：
测试环境 · cjapp-t.cdcee.net
{
"mcpServers": {
"cdcee-open": {
"type": "streamablehttp",
"url": "https://cjapp-t.cdcee.net/market/openapi/v1/mcp",
"headers": {
"Authorization": "Bearer <你的token>"
}
}
}
} token 获取：个人用户可用 Skill 包 的脚本一键创建；合作方应用可在控制台创建后经 POST /api/v1/oauth/token （grant_type=client_credentials）换取访问令牌。
第三步：调用工具
MCP 客户端自动完成 tools/list 与 tools/call；协议为 Streamable HTTP（JSON-RPC 2.0）， 服务端无状态，错误通过调用结果返回（HTTP 恒为 200）。
工具目录（12 个）
| 工具 | 身份 | 所需 scope | 语义 |
|---|---|---|---|
| attest_work | 个人 | — | 作品存证（默认沙箱；真链需 confirm_mainnet=true 且提供实名信息，不可撤销） |
| list_my_attestations | 个人 | — | 本人存证台账（状态/证书链接） |
| list_my_orders | 个人 | — | 本人订单列表 |
| query_products | 个人 | — | 平台公开商品行情 |
| register_merchant | 合作方 | merchant:register | 商户引入（手机号幂等） |
| query_merchant | 合作方 | merchant:register | 按手机号查商户状态 |
| list_merchant_products | 合作方 | product:import | 商户商品列表 |
| import_product | 合作方 | product:import | 商品导入（external_id 幂等） |
| query_import_status | 合作方 | product:import | 导入单状态 |
| sync_institution | 合作方 | institution:sync | 机构同步（external_id 幂等） |
| list_institutions | 合作方 | institution:sync | 已同步机构列表 |
| query_dictionaries | 合作方 | — | 开放字典（品类/交易模式/标签） |
详细入参/出参字段见 工具文档。
安全须知
- token 等同身份凭据：仅保存在本地（建议 0600 权限），禁止写入日志或提交到代码仓库。
- 疑似泄露立即在控制台停用应用或吊销 token，即时生效。
- 真链存证不可撤销且消耗真实配额；AI 工具调用前必须向你逐项确认。
- 限流：个人 token 换票 30 次/分 · 500 次/日；合作方应用按主体共享配额（超限返回 429 + Retry-After）。