# 通用约定

> 端点、传输、鉴权、协议版本、错误码。
> 分组：MCP 接入
> 更新时间：2026-10-13
> 原文：https://www.chenra.com/docs/mcp-conventions

## 端点与传输

项
值

端点
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