用途:在 ibl.ai 平台上为 AI 智能体(mentor)配置外部工具访问。平台用三个对象建模 MCP,完整集成必须三者齐备:MCP Server(外部端点元数据:name、url、transport、auth_type、auth_scope)、MCP Server Connection(凭据绑定,可为静态 token 或 OAuth ConnectedService 引用,作用域为 platform/agent/user)、Agent wiring(智能体 tools 列表含 "mcp-tool" 且 mcp_servers 含服务器 ID)。缺少第三步是最常见故障。
主要能力:注册/更新/删除 MCP 服务器;创建/更新/删除连接;读取与修改智能体设置;管理 OAuth 连接器(发现服务、发起授权、回调、列出与删除已连接服务);处理聊天内 OAuth 事件。
使用方式:需先准备 Base URL、org/tenant key、管理员用户名、API token(Authorization: Token <value>)与智能体 unique_id。token 从环境变量读取,勿回显或提交。服务器端点位于 /api/ai-agent/orgs/{org}/users/{user_id}/mcp-servers/,连接端点位于 .../mcp-server-connections/,智能体设置位于 .../agents/{mentor_id}/settings/,OAuth 端点位于 /api/accounts/。先决定 auth_type × auth_scope 模式,再注册服务器、创建连接、接线智能体并验证。智能体设置字段为替换而非合并,须先 GET 再回写完整列表。
适用场景:为智能体接入外部 MCP 工具、多租户共享服务器、按用户或按智能体区分凭据、聊天中触发用户 OAuth 授权。
限制:OAuth 连接器端点仅允许 GET/DELETE,ConnectedService 只能由托管 OAuth 流程创建;oauth2 连接必须提供 connected_service;聊天内 OAuth 需 auth_type=oauth2 且 auth_scope=user;超时默认 300 秒,轮询间隔 10 秒;state 缓存 1 小时。具体部署地址、凭据与价格等资料暂未提供。