自定义 MCP 公网接口

接口用途

说明自定义 MCP 公网接口形态。该地址不在工作区 API 基址下。

请求方式

POST

接口地址

https://<mcp_host>/mcp

身份认证

MOI 侧 transport 使用 http-streaming；鉴权放在 connection bearer credential。不要在文档中写真实 MCP Token。

请求体

自定义 MCP 公网 endpoint 由 MCP Server 自身定义；MOI 侧创建连接时 transport 使用 http-streaming，鉴权放在 connection 的 bearer credential。本文不展开第三方 MCP 协议字段。

请求示例

curl -X POST 'https://<mcp_host>/mcp' \
  -H 'Authorization: Bearer <MCP_TOKEN>' \
  -H 'Content-Type: application/json'

响应说明

响应由 MCP Server 决定；MOI 侧通过 probe / batch-create 消费其工具列表。

使用限制

  • 不要把该公网接口与工作区 API Key 直连路径混淆。

  • 不要把 POST /agents/<agent_id>/mcp/http 当作工作区 API Key 的稳定 MCP 直连接口；MCP 接入优先使用连接探测与批量创建工具。

相关接口

最后更新于