SuperAPI AI 工具集

building-mcp-servers

智能体与模型

查看项目

更新于 10-15 17:32

技能介绍

用途:MCP 服务器是 Model Context Protocol 端点,把 Celigo Tools 与 builder 模式 API 作为可调用工具暴露给外部 AI 智能体和 MCP 客户端,自身只是薄暴露层,处理逻辑位于被引用的 Tool 和 API 资源中。

主要能力:包含两类条目。tools[] 引用 Celigo Tool 资源,支持注解(readOnlyHint、destructiveHint、idempotentHint、openWorldHint)与覆盖(按服务器自定义连接、导出、导入、路由,不修改底层工具);apis[] 引用 builder 模式 API,仅支持 type: "builder",不支持注解或覆盖。名称须在同一服务器所有条目中唯一,仅可含字母、数字、下划线、连字符和点。工具输入 schema 根类型必须为 object。

使用方式:先确认要暴露的能力,用 celigo account search、celigo tools list、celigo apis list、celigo mcp-servers list 检查既有资源;自底向上先建连接、导出导入、工具、API,再建 MCP 服务器。每个服务器至少需 name 与 relativeURI(以 / 开头、单段、仅字母数字下划线连字符)。启用服务器需至少一个条目 disabled: false。CRUD 命令:celigo mcp-servers list/get/create/update/set/delete。PUT 会清除省略字段,应先 GET 再 PUT,set 命令可自动处理。鉴权支持 Celigo OAuth(默认)、外部 IdP 和静态 API 令牌,作用域分 mcp:read 与 mcp:write,每次请求都会校验。

限制:脚本模式与旧版 API 无法暴露;注解只是提示,不强制执行;预览和日志端点仅支持会话鉴权,不支撑 bearer token;MCP 服务器向外发布能力,与消费外部 MCP 服务器的 MCP 连接是相反概念;每次调用(含失败调用)计入账户 MCP 配额,账户内所有服务器共用,执行较宽松。External IdP 不支持用户列表和按用户下游连接,Auth0 需 Resource Parameter Compatibility Profile,Microsoft Entra ID 与 Google Identity 暂不支持 MCP OAuth。更多字段细节见资料中的 Schema Index。