模型上下文协议（MCP）¶
Agora 可以连接远程 MCP 服务器，并把服务器提供的工具交给支持工具调用的聊天模型。
添加服务器¶
- 打开设置 → MCP。
- 点击添加 MCP 服务器。
- 选择 Streamable HTTP 或 SSE。
- 输入显示名称，以及以 http:// 或 https:// 开头的服务器 URL。
- 只添加服务器必需的自定义 HTTP 请求头，然后保存。
Streamable HTTP 是当前传输方式；SSE 用于兼容旧版 MCP 服务器。
自定义请求头值使用与 API Key 相同的机密设置存储：通常由 Android Keystore AES-GCM 封装，但旧值或加密失败时可能为明文。其中可能包含授权令牌，请保护设备和导出文件，并且不要添加服务器不需要的请求头。
连接与工具发现¶
已启用的服务器会在后台连接，状态显示为空闲、正在连接、已连接或连接错误。可以在服务器菜单或编辑页中选择重新连接来重试发现。
连接成功后，Agora 会列出服务器的工具。新发现的工具默认启用；在服务器编辑页中可以逐项关闭。关闭整个服务器会从后续模型请求中移除其全部工具，但不会删除配置。
已启用的 MCP 工具进入 Agora 的标准工具调用流程。模型会看到工具名称、说明和输入结构，工具结果也会像其他工具调用一样保存在对话中。
编辑或删除服务器¶
点击服务器可以编辑传输方式、名称、URL、自定义请求头、连接状态和已启用工具。服务器右侧菜单可用于重新连接或删除。
删除服务器会移除其配置并停用对应工具，但不会删除已有的对话历史。
安全¶
MCP 工具可能在外部系统产生副作用。请只连接可信服务器、检查工具清单，并授予尽可能小的凭据范围。离开可信局域网时优先使用 HTTPS。
故障排查¶
连接错误¶
- 确认 Android 设备可以访问该 URL。
- 确认所选传输方式与服务器匹配。
- 检查认证请求头与服务器日志。
- 修改配置后使用重新连接。
没有显示工具¶
- 确认服务器已启用且状态为已连接。
- 重新连接以刷新工具发现。
- 打开编辑页，确认具体工具没有被关闭。
模型没有获得某个工具¶
当前模型与提供商必须支持工具调用，同时服务器和该工具本身都必须处于启用状态。