通用约定
端点、传输、鉴权、协议版本、错误码。
端点与传输
| 项 | 值 |
|---|---|
| 端点 | POST https://api.chenra.com/api/relay/mcp |
| 传输 | Streamable HTTP（单端点，每个 JSON-RPC 消息一次 POST） |
| 协议 | JSON-RPC 2.0 |
鉴权
每个请求都要带 API Key：
Authorization: Bearer sk-你的密钥
- 缺少或无效 →
401 - 密钥绑定的订阅已失效 / 已过期 →
403（去控制台续费即可恢复） - 密钥按「每分钟请求上限」限流，超出返回
429（在「密钥管理」里自助调整，0 = 不限）
协议版本
服务端支持 2025-03-26 至 2026-07-28 的协议版本：客户端在 initialize 里报自己的版本，
服务端回它支持的版本；报的版本不在支持列表里则回落最新版。
错误结构
出错时返回 JSON-RPC 2.0 的标准错误体，id 与请求一致：
{"jsonrpc":"2.0","id":1,"error":{"code":-32602,"message":"未知工具：xxx"}}
| 码 | 含义 |
|---|---|
| -32700 | 请求体不是合法 JSON |
| -32600 | 非法请求（缺 jsonrpc / method） |
| -32601 | 方法未实现 |
| -32602 | 参数错误（如未知工具 / 未知资源） |
| -32603 | 服务端内部错误 |
通知（不带 id 的 JSON-RPC 消息，如 notifications/initialized）返回 202 空响应。
已实现的方法
initialize · ping · tools/list · tools/call · resources/list ·
resources/templates/list · resources/read · prompts/list · prompts/get
分享这篇文档