接入与发现

远程 MCP 接入

通过 POST JSON-RPC MCP 端点发现并调用 PerchanceAI 工具。

接口

POST/api/mcp

鉴权与 Scope

此 ping 示例无需 bearer；业务调用需要正式账户凭据。

协议为 2026-07-28。server/discover、tools/list、ping 与 list_models 公开。业务工具和任务需要正式 bearer 及对应 REST scope；此处示例为公开 ping。

MCP-Protocol-Version 与 Mcp-Method 必须匹配 body。tools/call 还需 Mcp-Name 匹配 params.name；任务方法需 Mcp-Name 匹配 taskId。必须包含下方两个 _meta 键，即使 clientCapabilities 为空。使用任务方法前需协商 Tasks。

MCP 响应使用 JSON-RPC，不使用 REST envelope。鉴权失败返回 HTTP 401 与 WWW-Authenticate；协议和路由 header 校验先于鉴权。

请求参数

字段	类型	必填	说明
`jsonrpc / id / method`	JSON-RPC	是	jsonrpc=2.0、请求标识和匹配的方法。
`params._meta`	object	是	io.modelcontextprotocol/protocolVersion 与 io.modelcontextprotocol/clientCapabilities。

curl --request POST \
  --url 'https://api.perchanceai.art/api/mcp' \
  --header 'X-App-Id: perchanceai' \
  --header 'X-Request-Id: docs-example' \
  --header 'MCP-Protocol-Version: 2026-07-28' \
  --header 'Mcp-Method: ping' \
  --header 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"ping","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'

响应 HTTP 200

以下为说明响应结构的示例，并非实时 API 响应。示例数值和 USD 不代表固定定价或资金余额。空字段省略。

字段	类型	必填	说明
`jsonrpc / id / result`	JSON-RPC	是	响应标识与结果；ping 返回 resultType=complete。

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "resultType": "complete"
  }
}

远程 MCP 接入

接口

鉴权与 Scope

请求参数

响应 HTTP 200

相关错误