跳转到内容

ecentic MCP 服务器。

Claude、ChatGPT 以及任何支持 Model Context Protocol 的客户端,都可以通过 JSON-RPC 2.0 原生调用 ecentic。本页是连接参考:包括端点、传输方式、握手以及其公开的所有工具。

流式 HTTP · JSON-RPC 2.0 · 7 个工具

01

连接

一个端点、两条路径,无需管理会话。

连接参考

主端点
POST https://ecentic.ai/mcp
相同处理器
POST https://ecentic.ai/api/mcp
POST https://ecentic.ai/mcp

服务器可通过 /mcp 和 /api/mcp 访问。两者使用同一个处理程序;之所以提供简短路径,是因为大多数客户端和扫描器会优先探测它。

02

握手

先 initialize,再发送 initialized 通知。

探索握手流程

  1. 01

    初始化

    客户端发送
    initialize
    服务器返回
    200

    协商后的协议与服务器能力

    initialize 会返回协商后的协议版本、服务器身份、其能力,以及说明 ecentic 用途的 instructions 字符串。如果请求的版本是 ecentic 支持的版本,就会返回该版本;否则会回退到其公开声明的版本。

  2. 02

    通知

    客户端发送
    notifications/initialized
    服务器返回
    202

    接受请求并返回空响应体

    随后发送的 notifications/initialized 消息是 JSON-RPC notification——它没有 id,也不会收到回复。按照传输协议要求,ecentic 会返回 202 Accepted 和空响应体。若服务器对 notification 返回 JSON-RPC 错误,就会破坏握手,因此当客户端无法连接时,最值得优先检查的就是这一步。

完整握手示例
initialize 支持的协议版本
03

工具

服务器公开了哪些工具,以及哪些调用需要密钥。

04

认证

只读工具公开开放;任何涉及账户操作的请求都需要 bearer key。

发送 bearer key

代码示例

对会修改账户状态的工具调用发送 Authorization: Bearer ecentic_sk_…。如果调用需要凭证但未提供,系统会返回 HTTP 401,并附带 WWW-Authenticate 响应头指向 Protected Resource Metadata 文档,使客户端能够直接从错误中重新执行发现流程。

创建凭证

密钥完全自助获取:创建账户后,可在控制台生成,也可以在已认证会话中通过 create_api_key 调用生成。整个过程都无需联系销售。

05

错误

两类错误接口,以及如何区分当前看到的是哪一种。

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 响应头。

本页所有声明都可验证:manifest、server card 和 OpenAPI 文档描述的是同一个端点。