管理自定义算子 MCP¶

将已启用的自定义算子发布为工作区 MCP 工具，供支持 MCP 的客户端发现和调用。发布、取消发布和查询状态使用自定义算子 API；客户端调用已发布工具时使用工作区的 MCP 入口。

调用前准备¶

先查看自定义算子详情，取得算子 ID 并确认算子已启用。准备具有目标工作区访问权限的个人访问令牌和目标工作区 ID。

发布和取消发布需要该算子的更新权限；查询状态需要读取权限。MCP 客户端调用时，tools/list 仅返回调用者有读取权限的工具，tools/call 还需要该算子的运行权限。

发布、取消发布和查询状态¶

将 $OPERATOR_ID 替换为自定义算子 ID。

发布

curl -X POST "https://api.moi.matrixorigin.cn/v5/workflow/v2/custom-operators/$OPERATOR_ID/mcp-publish" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

取消发布

curl -X POST "https://api.moi.matrixorigin.cn/v5/workflow/v2/custom-operators/$OPERATOR_ID/mcp-unpublish" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

查询状态

curl "https://api.moi.matrixorigin.cn/v5/workflow/v2/custom-operators/$OPERATOR_ID/mcp-status" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

参数	类型	是否必填	说明
`operator_id`	integer	是	自定义算子 ID，位于请求路径中。

发布或取消发布请求成功只表示状态变更已被接口接受。使用查询状态接口确认当前状态后，再让 MCP 客户端连接。

从 MCP 客户端调用已发布算子¶

已发布工具的工作区入口如下。该入口使用无会话 Streamable HTTP 和 JSON-RPC；使用 X-API-Key 传递个人访问令牌，不要同时传递 Authorization 请求头。

POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/published-mcp

先初始化，再调用 tools/list 取得当前调用者可用的工具。初始化完成后，发送 notifications/initialized 通知；该通知返回 HTTP 202 且没有响应体。

curl -X POST "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/published-mcp" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "init-01",
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {
        "name": "example-client",
        "version": "1.0.0"
      }
    }
  }'

GET 和 DELETE 不支持该入口，返回 HTTP 405。

最后更新于 2026 年 10 月 12 日