OpenRouter / Open WebUI | 集成

设置

先把 OpenRouter 作为 OpenAI 兼容连接接入 Open WebUI，再以 Minds API 密钥作为 Bearer 令牌，把 Minds 添加为 MCP（Streamable HTTP）工具服务器。

将 OpenRouter 连接到 Open WebUI

1. 在 openrouter.ai/keys 创建 API 密钥。
2. 在 Open WebUI 中打开 Settings → Admin → Connections，在 OpenAI API 连接下点击 + Add Connection。
3. URL：https://openrouter.ai/api/v1。API 密钥：您的 OpenRouter 密钥。
4. 在 Model IDs 允许列表中添加需要的模型 ID，例如 anthropic/claude-sonnet-5。OpenRouter 会返回数千个模型，因此 Open WebUI 建议设置允许列表并开启 Cache Base Model List（Open WebUI 文档）。
5. 保存后，在聊天的模型选择器中选择一个 OpenRouter 模型。

将 Minds 作为 MCP 工具服务器添加到 Open WebUI

Open WebUI 从 v0.6.31 起原生支持 MCP，且只有管理员可以添加 MCP 服务器（Open WebUI MCP 文档）。

1. 在 设置 → API 密钥 生成 Minds API 密钥（格式为 minds_…）。
2. 在 Open WebUI 中打开 Settings → Admin → Integrations，在 External Tool Servers 下点击 + Add Connection。
3. 类型：MCP (Streamable HTTP)，不是 OpenAPI。
4. URL：https://getminds.ai/mcp。
5. 认证：Bearer，然后粘贴您的 minds_… 密钥。选择 Bearer 却不填密钥会发送空请求头，服务器会拒绝。
6. 保存后，为您的模型或对话启用 Minds 工具。请选择原生工具调用可靠的模型；能力较弱的模型即使连接正常也可能忽略工具。

通过 OpenRouter API 使用 Minds

当模型服务方（例如通过 OpenRouter 的 openai/*）在服务端执行 MCP 调用时，它无法完成 OAuth 握手。请求到达 Minds 时不带 Authorization 头，因而返回 401。请改为传入带静态 headers 字段的 MCP 服务器描述：

{
  "type": "mcp",
  "server_label": "minds",
  "server_url": "https://getminds.ai/mcp",
  "headers": {
    "Authorization": "Bearer minds_YOUR_API_KEY"
  }
}

OpenRouter 自己的 MCP 服务器是另一回事

OpenRouter 还在 https://mcp.openrouter.ai/mcp 运行一个 MCP 服务器，供编程助手查询 OpenRouter 的模型、价格、额度和文档；它不会连接 Minds（OpenRouter MCP 文档）。

MCP 服务器 URL

https://getminds.ai/mcp

查看完整 MCP 文档