OpenRouter / Open WebUI | Intégrations

Configuration

Connectez OpenRouter à Open WebUI comme connexion compatible OpenAI, puis ajoutez Minds comme serveur d’outils MCP (Streamable HTTP) avec une clé API Minds.

Connecter OpenRouter à Open WebUI

1. Créez une clé API sur openrouter.ai/keys.
2. Dans Open WebUI, ouvrez Settings → Admin → Connections et cliquez sur + Add Connection sous les connexions OpenAI API.
3. URL : https://openrouter.ai/api/v1. Clé API : votre clé OpenRouter.
4. Ajoutez les identifiants de modèles voulus à la liste Model IDs, par exemple anthropic/claude-sonnet-5. OpenRouter renvoie des milliers de modèles ; Open WebUI recommande donc une liste d’autorisation et l’option Cache Base Model List (documentation Open WebUI).
5. Enregistrez, puis choisissez un modèle OpenRouter dans le sélecteur du chat.

Ajouter Minds à Open WebUI comme serveur d’outils MCP

Open WebUI prend en charge MCP nativement depuis la v0.6.31, et seuls les administrateurs peuvent ajouter des serveurs MCP (documentation MCP d’Open WebUI).

1. Générez une clé API Minds dans Paramètres → Clés API (format minds_…).
2. Dans Open WebUI, ouvrez Settings → Admin → Integrations et cliquez sur + Add Connection sous External Tool Servers.
3. Type : MCP (Streamable HTTP), pas OpenAPI.
4. URL : https://getminds.ai/mcp.
5. Auth : Bearer, puis collez votre clé minds_…. Choisir Bearer sans clé envoie un en-tête vide que le serveur rejette.
6. Enregistrez, puis activez les outils Minds pour votre modèle ou votre chat. Choisissez un modèle fiable en appel d’outils natif ; un modèle faible peut ignorer les outils même si la connexion fonctionne.

Utiliser Minds via l’API OpenRouter

Lorsque le fournisseur du modèle (p. ex. openai/* via OpenRouter) exécute l’appel MCP côté serveur, il ne peut pas effectuer la poignée de main OAuth. La requête atteint Minds sans en-tête Authorization et renvoie un 401. Passez plutôt le descripteur du serveur MCP avec un champ headers statique :

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

Le serveur MCP d’OpenRouter est autre chose

OpenRouter exploite aussi un serveur MCP à https://mcp.openrouter.ai/mcp. Il permet aux assistants de code de consulter les modèles, prix, crédits et la documentation d’OpenRouter ; il ne connecte pas Minds (documentation MCP d’OpenRouter).

URL du serveur MCP

https://getminds.ai/mcp

Voir la documentation MCP complète