ecentic MCP 服务器。
Claude、ChatGPT 以及任何支持 Model Context Protocol 的客户端,都可以通过 JSON-RPC 2.0 原生调用 ecentic。本页是连接参考:包括端点、传输方式、握手以及其公开的所有工具。
流式 HTTP · JSON-RPC 2.0 · 7 个工具
连接
一个端点、两条路径,无需管理会话。
连接参考
- 主端点
- POST https://ecentic.ai/mcp
- 相同处理器
- POST https://ecentic.ai/api/mcp
服务器可通过 /mcp 和 /api/mcp 访问。两者使用同一个处理程序;之所以提供简短路径,是因为大多数客户端和扫描器会优先探测它。
传输方式为 Streamable HTTP。所有请求都是携带 JSON-RPC 2.0 的 POST 请求,所有响应也都通过同一个 POST 返回。ecentic 不会主动发起服务器流,因此带有 Accept: text/event-stream 的 GET 请求会返回 405,而不会让客户端挂在一个永远不会产生事件的流上。
不存在会话。ecentic 不会发放 Mcp-Session-Id,而用于终止会话的 DELETE 方法也会因同样原因返回 405。无需进行任何清理。
握手
先 initialize,再发送 initialized 通知。
探索握手流程
- 01
初始化
- 客户端发送
- initialize
- 服务器返回
- 200
协商后的协议与服务器能力
initialize会返回协商后的协议版本、服务器身份、其能力,以及说明 ecentic 用途的instructions字符串。如果请求的版本是 ecentic 支持的版本,就会返回该版本;否则会回退到其公开声明的版本。 - 02
通知
- 客户端发送
- notifications/initialized
- 服务器返回
- 202
接受请求并返回空响应体
随后发送的
notifications/initialized消息是 JSON-RPC notification——它没有id,也不会收到回复。按照传输协议要求,ecentic 会返回202 Accepted和空响应体。若服务器对 notification 返回 JSON-RPC 错误,就会破坏握手,因此当客户端无法连接时,最值得优先检查的就是这一步。
工具
服务器公开了哪些工具,以及哪些调用需要密钥。
认证
只读工具公开开放;任何涉及账户操作的请求都需要 bearer key。
发送 bearer key
对会修改账户状态的工具调用发送 Authorization: Bearer ecentic_sk_…。如果调用需要凭证但未提供,系统会返回 HTTP 401,并附带 WWW-Authenticate 响应头指向 Protected Resource Metadata 文档,使客户端能够直接从错误中重新执行发现流程。
错误
两类错误接口,以及如何区分当前看到的是哪一种。
JSON-RPC 错误
error.code
JSON-RPC 错误——例如未知方法、错误参数或工具拒绝执行——会按照 JSON-RPC 规范,以带有 error 成员的 HTTP 200 返回。请根据 error.code 做分支处理。
传输错误
application/problem+json
传输错误——例如调用了端点不支持的方法——会以 RFC 9457 problem 文档返回,携带 Content-Type: application/problem+json 和机器可读的 code。这与 REST 接口使用的是同一种错误模型。
身份验证异常
WWW-Authenticate
唯一例外是 401:它会保留 JSON-RPC 包装结构,因此已在解析 JSON-RPC 的客户端无需实现第二套解析器,同时还会附带用于发现流程的 WWW-Authenticate 响应头。