用途：为 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）。最常见的失败是漏掉第三步；完成后应重新读取智能体设置确认。
调用约定：基础地址 https://api.iblai.app/dm，/dm 前缀必需。请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org}=$IBLAI_ORG、{username}=$IBLAI_USERNAME、{mentor}=智能体 UUID。接口中智能体名词为 mentor。DELETE 等破坏性调用需先与用户确认，不得回显或提交凭证。未连接时先运行 /iblai-api-login 填充环境变量。
鉴权模式：auth_type 为凭证上线路方式（none|token|oauth2），auth_scope 为使用谁的凭证（platform|mentor|user），二者正交。仅 auth_type=oauth2 且 auth_scope=user 会触发聊天内 OAuth 提示；任何 oauth2 连接都需 connected_service id；聊天内 OAuth 服务器还须关联 oauth_service。运行时凭证解析顺序为：用户级连接、智能体级连接、平台级连接、精选服务器全局回退；无连接则 401。OAuth 连接由服务端在令牌临期时自动刷新。
OAuth 已连接服务：需先在凭证库安装名为 auth_{provider} 的凭证（含 client_id、client_secret、redirect_uri）。流程为发现已启用服务、start 返回 auth_url（在新标签打开，state 1 小时过期）、厂商回调后返回已连接服务，其 id 用作 MCP 连接的 connected_service。
读写接口：读取包括 MCP 服务器列表、连接列表、智能体设置、OAuth 服务与已连接服务及回调；写入包括创建/编辑/删除 MCP 服务器与连接、通过 PATCH 智能体设置完成接线、删除已连接服务；另有聊天内 OAuth 事件协议（oauth_required、oauth_connection_resolved、mcp_tools_retrieved、warning、error），最长等待 300s、轮询 10s。注：tool_slugs 与 mcp_servers 是整体替换而非合并，需先读后本地合并再整体写回，否则会静默清掉其他工具。