不稳定的智能体 MCP 入口¶

接口用途¶

说明 POST /agents/<agent_id>/mcp/http 不应作为工作区 API Key 的稳定 MCP 直连接口。

请求方式¶

POST

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agents/<agent_id>/mcp/http

身份认证¶

使用工作区 API Key，在请求头中携带 X-API-Key: <WORKSPACE_API_KEY>，并设置 Content-Type: application/json。

路径参数¶

名称	说明
`agent_id`	智能体标识。

查询参数¶

无。

请求体¶

请求体由 MCP HTTP 传输决定。仅传工作区 X-API-Key 会出现 runtime grant/authorization 相关错误；不作为稳定直连接口。

请求示例¶

curl -X POST 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agents/<agent_id>/mcp/http' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{}'

响应说明¶

常见为授权/grant 失败错误响应，而非稳定 MCP 会话。

使用限制¶

MCP 接入优先使用连接探测与批量创建工具链路。