批量创建 MCP 工具

接口用途

批量创建或复用 MCP 连接与工作区 MCP 工具。

请求方式

POST

接口地址

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/connections/actions/batch-create-mcp-tools

身份认证

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

路径参数

无。

查询参数

无。

请求体

按 connection_id 与远端工具名幂等。已归档的旧工具也可能被识别为 existing。

字段

类型

必填

说明

items

array

是

待创建工具项；每项含 tool_name，可选 name/description/input_schema 等

connection_id

string

条件

复用已有连接

name

string

条件

新建连接名称

endpoint_uri

string

条件

新建连接 endpoint

transport

string

否

建议 http-streaming

auth_type

string

否

鉴权类型

credential

object

否

凭据

visibility

string

否

可见性

api_key_header

string

否

API Key 头名

请求示例

curl -X POST 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/connections/actions/batch-create-mcp-tools' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"name":"my-mcp","endpoint_uri":"https://<mcp_host>/mcp","transport":"http-streaming","auth_type":"bearer_token","credential":{"bearer_token":"<MCP_TOKEN>"},"items":[{"tool_name":"search","name":"mcp_search","description":"Search"}]}'

响应说明

除 A2A JSON-RPC 外，多数工作区接口成功响应形如 {"code":0,"data":...}；下列字段描述 data（或 HTTP 202 时的 data）。

批量结果：

字段

类型

必填

说明

connection

object

连接对象

connection_status

string

连接状态

items

array

逐项结果：tool_name / status / tool / error

使用限制

  • 建议先探测 MCP 服务，再执行批量创建。

相关接口