用途:为 ibl.ai 智能体配置外部 MCP 工具访问。平台用三个对象建模 MCP,完整集成必须三者齐备:MCP 服务器(外部端点元数据:name、url、transport、auth_type、auth_scope)、MCP 服务器连接(凭据绑定,可为静态 token 或 OAuth 已连接服务引用,作用域为 platform、mentor 或 user)、智能体接线(智能体设置中 tool_slugs 需含 mcp-tool,mcp_servers 需含服务器 id)。缺少第三步是最常见故障:服务器与连接存在但智能体从不调用,完成后应重新读取智能体设置确认。
主要能力:注册、编辑、删除 MCP 服务器;创建、更新、删除连接;管理 OAuth 已连接服务生命周期(发现服务、发起授权、回调、撤销);配置聊天内 OAuth 逐用户授权;通过设置接口为智能体启用或停用连接器。
使用方式:基础 URL 为 https://api.iblai.app/dm,/dm 前缀必需。MCP 端点位于 /api/ai-mentor/orgs/{org}/users/{username}/...,OAuth 连接器端点位于 /api/ai-account/...。每个请求需带 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org}=$IBLAI_ORG、{username}=$IBLAI_USERNAME、{mentor} 为智能体 UUID。未连接时先运行 /iblai-api-login 填充环境变量。auth_type(none|token|oauth2)与 auth_scope(platform|mentor|user)正交,决定下游配置;仅 auth_type=oauth2 且 auth_scope=user 会触发聊天内 OAuth 提示。运行时凭据按用户、智能体、平台、精选服务器全局回退顺序解析,无连接则 401。
适用场景:需要让智能体调用外部 MCP 工具,并区分组织共享密钥、按智能体密钥、预置用户凭据或用户自行 OAuth 授权的场景。
限制:DELETE 等破坏性调用须先与用户确认;不得回显或提交凭据;智能体设置的 tool_slugs 与 mcp_servers 为整体替换而非合并,误写会清除其他工具;OAuth 流程 state 1 小时过期,聊天内 OAuth 默认等待 300 秒、轮询 10 秒,超时终止本轮。具体收费、价格与平台支持范围资料未提供。