OpenRouter / Open WebUI | Integraciones

Configuración

Conecta OpenRouter a Open WebUI como conexión compatible con OpenAI y después añade Minds como servidor de herramientas MCP (Streamable HTTP) con una clave de API de Minds.

Conectar OpenRouter a Open WebUI

1. Crea una clave de API en openrouter.ai/keys.
2. En Open WebUI, abre Settings → Admin → Connections y haz clic en + Add Connection en las conexiones de OpenAI API.
3. URL: https://openrouter.ai/api/v1. Clave de API: tu clave de OpenRouter.
4. Añade los ID de modelo que quieras a la lista Model IDs, por ejemplo anthropic/claude-sonnet-5. OpenRouter devuelve miles de modelos, por eso Open WebUI recomienda una lista de permitidos y activar Cache Base Model List (documentación de Open WebUI).
5. Guarda y elige un modelo de OpenRouter en el selector del chat.

Añadir Minds a Open WebUI como servidor de herramientas MCP

Open WebUI admite MCP de forma nativa desde la v0.6.31 y solo los administradores pueden añadir servidores MCP (documentación MCP de Open WebUI).

1. Genera una clave de API de Minds en Ajustes → Claves de API (formato minds_…).
2. En Open WebUI, abre Settings → Admin → Integrations y haz clic en + Add Connection en External Tool Servers.
3. Tipo: MCP (Streamable HTTP), no OpenAPI.
4. URL: https://getminds.ai/mcp.
5. Auth: Bearer y pega tu clave minds_…. Elegir Bearer sin clave envía una cabecera vacía que el servidor rechaza.
6. Guarda y activa las herramientas de Minds para tu modelo o chat. Elige un modelo con llamadas a herramientas nativas fiables; un modelo débil puede ignorarlas aunque la conexión funcione.

Usar Minds a través de la API de OpenRouter

Cuando el proveedor del modelo (p. ej. openai/* vía OpenRouter) ejecuta la llamada MCP en el servidor, no puede realizar el handshake de OAuth. La petición llega a Minds sin cabecera Authorization y devuelve un 401. Pasa en su lugar el descriptor del servidor MCP con un campo headers estático:

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

El servidor MCP propio de OpenRouter es otra cosa

OpenRouter también tiene un servidor MCP en https://mcp.openrouter.ai/mcp. Permite a los asistentes de código consultar modelos, precios, créditos y documentación de OpenRouter; no conecta Minds (documentación MCP de OpenRouter).

URL del servidor MCP

https://getminds.ai/mcp

Ver la documentación completa de MCP