OpenRouter MCP : configuration, appels de modèles et vrais compromis

OpenRouter MCP est un serveur Model Context Protocol hébergé, conçu pour explorer et tester des modèles avant de faire un choix : votre agent peut consulter les tarifs en temps réel, les benchmarks, les endpoints et la documentation. En revanche, il ne remplace pas l’API OpenRouter pour les usages en production.

En bref : ce qu’apporte OpenRouter MCP

Le serveur officiel est accessible à l’adresse https://mcp.openrouter.ai/mcp. Un client compatible, comme Claude Code, Cursor ou Claude Desktop, s’y connecte via HTTP distant et permet à l’agent d’utiliser les outils OpenRouter directement dans la conversation. Il sert à étudier et tester le catalogue ; pour les appels intégrés à une application ou les opérations liées à un compte fournisseur, l’API de production ou le MCP du fournisseur reste l’outil adapté.

L’annonce officielle d’OpenRouter mentionne les données de modèles en direct, les classements, les prix, la documentation et les inférences de test. La documentation MCP fait référence pour l’endpoint, les outils et le fonctionnement de l’authentification.

Commencez par le processus, pas par l’URL du serveur

Le schéma le plus utile est le suivant : chercher, comparer, tester, vérifier. Il remplace la question vague « Quel est le meilleur modèle ? » par une décision fondée sur des contraintes explicites.

1. Chercher : demandez les modèles correspondant à une tâche, un budget, une longueur de contexte, une modalité ou un fournisseur. Utilisez list-models et list-benchmarks pour consulter le catalogue et les benchmarks actuels.
2. Comparer : appelez list-model-endpoints pour chaque candidat afin d’obtenir, lorsque ces données sont disponibles, les prix, la latence, le débit et les politiques de données par fournisseur.
3. Tester : exécutez le même prompt avec send-message et un slug de modèle nommé. Cette étape peut entraîner des frais d’inférence.
4. Vérifier : transmettez chaque ID de génération à get-generation pour récupérer le nombre de tokens, le coût et le fournisseur qui a servi la requête.

Vous pouvez utiliser ce prompt dans Claude Code ou Cursor :

Utilise OpenRouter MCP pour trouver trois modèles capables d’extraire des données
structurées depuis des documents juridiques. Exigences : au moins 100k de contexte,
appel d’outils et prix d’entrée disponible le plus bas. Compare les fournisseurs et
les politiques de données. Ensuite, utilise send-message pour exécuter exactement ce
prompt sur les deux meilleurs candidats :

"Extrais chaque date de renouvellement de contrat du texte ci-dessous. Retourne uniquement
du JSON avec un tableau nommé renewals, chaque élément contenant party, date et evidence."

Après les tests, utilise get-generation pour chaque ID de génération et indique le
coût réel ainsi que le fournisseur ayant servi la requête. N’appelle aucun modèle avant
mon approbation.

Demandez une approbation avant les tests : les recherches dans le catalogue sont en lecture seule, tandis que send-message peut générer des frais d’inférence. Pour des évaluations reproductibles, spécifiez un modèle et un fournisseur. Les suffixes comme :free, :floor, :nitro et :online expriment des préférences de routage lorsqu’ils sont disponibles ; ils ne garantissent pas un niveau de qualité fixe.

Connecter le serveur distant officiel

Aucune installation locale n’est nécessaire. Ajoutez l’endpoint distant, terminez l’OAuth dans le navigateur, puis autorisez une clé OpenRouter dédiée, distincte de vos autres clés. La valeur par défaut documentée prévoit une expiration après 7 jours et un plafond de dépenses de $10, modifiable sur l’écran d’autorisation. OpenRouter utilise OAuth avec PKCE : vous autorisez donc l’accès dans un navigateur plutôt que de coller une clé API classique dans la configuration du client.

Claude Code

Exécutez :

claude mcp add --transport http openrouter https://mcp.openrouter.ai/mcp
claude mcp login openrouter

La première commande enregistre le serveur HTTP distant ; la seconde lance le flux OAuth. Dans une session Claude Code, la documentation MCP de Claude Code prend aussi en charge /mcp : sélectionnez le serveur OpenRouter, puis authentifiez-vous.

Testez la connexion avec une demande en lecture seule, par exemple : « Utilise OpenRouter MCP pour lister deux modèles actuels avec au moins 128k de contexte et indique leurs prix d’entrée. »

Cursor

Ajoutez le serveur distant dans ~/.cursor/mcp.json :

{
  "mcpServers": {
    "openrouter": {
      "url": "https://mcp.openrouter.ai/mcp"
    }
  }
}

Redémarrez ou rechargez Cursor si le serveur n’apparaît pas. L’authentification se lance depuis les réglages MCP de Cursor ou lors de la première utilisation d’un outil. La CLI documentée est cursor-agent ; vérifiez l’entrée avec :

cursor-agent mcp list

La documentation MCP de Cursor détaille les configurations au niveau utilisateur et au niveau projet. Placez l’entrée au niveau qui correspond à votre besoin, et ne versionnez jamais une configuration d’authentification personnelle dans un dépôt partagé.

Claude Desktop et Claude Web

Si OpenRouter ne figure pas dans le répertoire de connecteurs de Claude, le guide de connexion d’OpenRouter indique comment ajouter un connecteur distant personnalisé :

1. Ouvrez Settings > Connectors > Customize > Connectors.
2. Cliquez sur +, puis choisissez Add custom connector.
3. Nommez-le OpenRouter MCP.
4. Saisissez https://mcp.openrouter.ai/mcp comme URL du serveur MCP distant.
5. Laissez les champs OAuth vides, ajoutez le connecteur, ouvrez-le et cliquez sur Connect.
6. Terminez l’autorisation OpenRouter dans le navigateur.

Certaines organisations désactivent les connecteurs personnalisés. Si l’option est absente sur un compte géré, contactez l’administrateur. La documentation MCP d’Anthropic explique les concepts du protocole côté client.

Ce que vous pouvez lui demander sans risque particulier

La plupart des outils officiels d’OpenRouter MCP effectuent des consultations en direct. Les classer selon leurs effets est plus pratique que de mémoriser toute la liste.

Pour sélectionner un modèle, formulez votre règle de décision : « Trouve le modèle le moins cher avec appel d’outils et une fenêtre de contexte de 64k, puis indique l’endpoint disponible le plus rapide. » Les filtres documentés couvrent notamment le prix, le contexte minimal, la famille du modèle, l’auteur, le fournisseur, la modalité, les paramètres pris en charge, les plages de benchmarks, le taux de réussite des appels d’outils, la disponibilité de la rétention zéro des données et la région.

Pour un test de modèle maîtrisé, indiquez un slug et rendez le prompt reproductible :

Utilise OpenRouter MCP send-message avec le modèle "openai/gpt-4o".
Envoie exactement ce message utilisateur et n’ajoute aucun prompt système :

"Retourne un objet JSON avec les clés title et risks. Analyse cette note de version :
[paste text here]"

Montre-moi la réponse et l’ID de génération. N’exécute aucun autre modèle.

Ce slug est donné à titre d’exemple : utilisez-en un dont list-models confirme la disponibilité. Pour des comparaisons auditables, exigez explicitement les outils de consultation, les valeurs renvoyées et un ID de génération, plutôt que d’accepter une recommandation de modèle non étayée.

OpenRouter MCP ou serveur MCP officiel d’un fournisseur ?

OpenRouter MCP constitue une couche transverse d’analyse et de test entre plusieurs fournisseurs. Un MCP officiel de fournisseur est généralement plus pertinent lorsqu’une action concerne directement son produit, son compte ou son plan de données.

Choisissez OpenRouter MCP pour répondre à « Quel modèle ou quel routage dois-je utiliser ? ». Préférez un MCP first-party lorsque la question est « Que puis-je faire dans le service de ce fournisseur ? ». Les deux peuvent être connectés au même agent si vous avez besoin de ces deux types de capacités.

Les serveurs MCP locaux ou multimodaux créés par la communauté forment une catégorie distincte. La page Works With OpenRouter décrit un serveur compatible avec plusieurs clients et flux texte, image, audio et vidéo ; il nécessite une clé API OpenRouter et des crédits, et ne correspond pas au service hébergé officiel à l’adresse mcp.openrouter.ai.

Les limites à connaître dans un projet réel

« @OpenRouter’s ori harness/cli has been a blessing... p.s: also thanks for openrouter mcp for quickly checking up info on models 🫰 » — @CodewithP, X, à propos d’un cas d’usage de consultation d’informations sur les modèles.

Le cookbook MCP d’OpenRouter couvre également le scénario inverse : utiliser des modèles OpenRouter comme backend LLM pour d’autres serveurs d’outils MCP, plutôt que de connecter un client de programmation à OpenRouter MCP.

Résoudre le premier appel qui échoue

1. Le serveur est visible, mais les outils échouent à l’authentification. Relancez l’étape OAuth propre au client. La clé dédiée a une durée de vie documentée de 7 jours et peut aussi être déconnectée depuis le tableau de bord OpenRouter.
2. Aucune fenêtre de navigateur ne s’ouvre. Utilisez claude mcp login openrouter, l’action /mcp de Claude Code, les réglages MCP de Cursor ou le bouton Connect du connecteur Claude.
3. Claude Desktop ne propose pas de connecteur personnalisé. Vérifiez si un administrateur de l’organisation a désactivé les connecteurs personnalisés.
4. La réponse sur un modèle semble obsolète. Demandez explicitement list-models, list-benchmarks ou list-model-endpoints, et exigez les valeurs renvoyées.
5. Un test coûte plus cher ou passe par un autre fournisseur que prévu. Consultez son ID avec get-generation, puis épinglez un fournisseur explicite pour la prochaine évaluation reproductible.

FAQ

OpenRouter MCP peut-il appeler n’importe quel modèle OpenRouter ?

Il peut tester les slugs de modèles exposés par le catalogue en direct, sous réserve de disponibilité, de capacités, de crédits et de contraintes de routage. Vérifiez d’abord le slug avec list-models.

Puis-je utiliser OpenRouter MCP simultanément avec Claude Desktop, Cursor et Claude Code ?

Vous pouvez ajouter le même endpoint officiel dans chaque client, en suivant le processus de configuration et d’authentification documenté pour chacun. Évitez d’inclure des identifiants personnels dans une configuration partagée.

Dois-je plutôt installer un package communautaire openrouter-mcp ?

Uniquement si vous avez besoin d’un flux local via stdio ou d’une orchestration multimodale que le serveur hébergé officiel ne fournit pas. Vérifiez d’abord le dépôt, la gestion des identifiants, la source du package et l’état de maintenance.

Commencez par une requête de catalogue en lecture seule ; n’autorisez un appel d’inférence contrôlé qu’une fois le modèle, le routage et la limite de dépenses clairement définis.