添加 MCP 服务器
1
打开 MCP 设置
导航到设置 → MCP。你会看到所有已配置服务器的列表及其当前连接状态(空闲、连接中、已连接、重连中或错误)。
2
点击添加服务器
点击右上角的 + 按钮。选择与你的服务器匹配的传输类型。
4
等待连接
Rikka 会自动连接并同步服务器暴露的工具列表。绿色的已连接指示器确认握手成功。如果连接断开,Rikka 会以指数退避的方式自动重试,直到将服务器标记为错误状态。
MCP 服务器必须在互联网上公开可达,或与你的 Android 设备处于同一局域网中。位于防火墙或企业 VPN 后面的服务器需要在设备上先连接 VPN,Rikka 才能访问。
传输类型
Rikka 支持两种 MCP 传输机制。两者都只需要一个 URL 端点——选择你的服务器所支持的类型即可。SSE(Server-Sent Events)
最初的 MCP 传输方式。客户端打开一个持久 HTTP 连接,服务器通过该连接推送事件。提供完整的 SSE 端点 URL,例如
https://mcp.example.com/sse。Streamable HTTP
MCP 规范中定义的较新的推荐传输方式。使用标准 HTTP 请求配合分块流传输。提供服务器的基础 URL,例如
https://mcp.example.com/mcp。服务器选项
每个服务器都有一组通用选项,你可以在添加或编辑时进行配置。string
必填
该服务器的可读显示名称。显示在 MCP 服务器列表和助手设置选择器中。
boolean
默认值:"true"
在不删除服务器的情况下开启或关闭它。禁用后,Rikka 会关闭连接,并且不会将该服务器的工具暴露给任何助手。
string
必填
MCP 端点的完整 URL。对于 SSE 服务器,通常是以
/sse 结尾的路径;对于 Streamable HTTP 服务器,则是 MCP 基础路径。list of key-value pairs
随每个请求发送到该服务器的自定义 HTTP 头。用于传递身份验证令牌、API 密钥或服务器要求的任何其他请求元数据。以名称-值对的形式添加每个头,例如
Authorization: Bearer <token>。单个工具选项
Rikka 连接并同步后,会列出服务器暴露的每个工具。你可以单独控制每个工具。boolean
默认值:"true"
启用或禁用该服务器的特定工具。被禁用的工具会从助手的工具列表中隐藏,即使服务器已连接也不会被调用。
boolean
默认值:"false"
开启后,Rikka 会在执行该工具前显示确认对话框。对于任何执行不可逆操作的工具——文件写入、发送邮件、购买——使用此选项,以便你始终掌控 AI 的实际行为。
将 MCP 服务器附加到助手
将服务器添加到 Rikka 的全局列表并不会自动将其暴露给你的助手。你必须为每个助手单独启用。1
打开助手设置
在主屏幕上长按一个助手,或点击助手名称然后点击编辑(铅笔图标)来打开其设置。
2
找到 MCP 服务器部分
向下滚动到 MCP 服务器。你会看到全局 MCP 列表中当前已启用的所有服务器。
3
切换你需要的服务器
启用该助手应该有权访问的服务器。只有在此处勾选的服务器的工具才会出现在助手的工具调用中。
通过 JSON 导入服务器配置
如果某个服务提供了现成的 MCP 配置文件,你可以直接导入,而无需手动输入所有详情。1
复制或下载 JSON 配置
配置应该是一个 JSON 对象,按照 Rikka 的配置模式描述一个或多个 MCP 服务器。
2
打开 MCP 设置并点击导入
在设置 → MCP 中,点击导入图标并粘贴或加载 JSON。Rikka 会验证并将服务器合并到你的现有列表中。