创建连接¶

接口用途¶

创建连接元数据。

请求方式¶

POST

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/connections

身份认证¶

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

路径参数¶

无。

查询参数¶

无。

请求体¶

创建 connection 元数据。通常创建 MCP 工具时优先使用批量创建接口自动复用或创建连接。

字段	类型	必填	说明
`name`	string	是	连接名称
`endpoint_uri`	string	是	MCP endpoint
`kind`	string	否	连接类型
`auth_type`	string	否	鉴权类型
`credential_ref`	string	否	已有凭据引用
`credential`	object	否	可含 `bearer_token` / `api_key` / `basic_username` / `basic_password` / `custom_headers`
`capabilities`	array	否	能力
`visibility`	string	否	可见性
`config`	object	否	配置
`description`	string	否	描述
`status`	string	否	状态

请求示例¶

curl -X POST 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/connections' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"name":"my-mcp","endpoint_uri":"https://<mcp_host>/mcp","auth_type":"bearer_token","credential":{"bearer_token":"<MCP_TOKEN>"}}'

响应说明¶

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

返回连接对象：

字段	类型	说明
`id`	string	连接 ID
`workspace_id`	string	工作区 ID
`name`	string	连接名称
`description`	string	描述
`status`	string	状态
`kind`	string	连接类型（如 MCP）
`endpoint_uri`	string	远端 endpoint
`auth_type`	string	如 `none` / `bearer_token` / `api_key` / `basic`
`credential_ref`	string	凭据引用；文档中勿展开明文
`capabilities`	array	能力列表
`visibility`	string	可见性
`config`	object	连接配置
`version`	integer	版本
`created_at`	string	创建时间
`updated_at`	string	更新时间

使用限制¶

创建后不要在文档或日志中沉淀真实 MCP Token。