端点与传输

本页面向开发或调试 MCP 客户端的开发者。如果你只是想接入现有的客户端，请参阅连接客户端。

端点

所有请求都发往同一个端点：

https://namebeta.com/api/mcp

属性	值
传输方式	Streamable HTTP，无状态。用 POST 发送 JSON-RPC 2.0 请求
其他方法	GET 和 DELETE 返回 405 Method Not Allowed；不提供 SSE 流
认证	必需。使用用户 NameBeta 账号的 OAuth 2.1——见授权
客户端注册	见客户端注册

请求

每个 POST 发送一个 JSON-RPC 请求，并携带通过授权获得的访问令牌：

POST /api/mcp HTTP/1.1
Host: namebeta.com
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

• Accept 须同时列出 application/json 和 text/event-stream，这是 Streamable HTTP 传输的要求。
• 每个 POST 一个请求。 请求体是单个 JSON-RPC 对象，而不是数组。
• 没有会话。 不使用 Mcp-Session-Id，每个请求相互独立。服务器接受 initialize，但它不会建立任何后续请求所依赖的状态。

违反上述任一规则的请求，会在任何工具运行之前被拒绝；对应的状态码见格式错误的请求。

响应

服务器对每个请求都返回普通 JSON 响应体（Content-Type: application/json），从不使用 SSE 流：没有任何流式输出，也没有通知或进度消息。失败时可能出现的各种形式见错误。