RockAPI MCP : connecter vos agents IA à plus de 50 modèles avec une seule clé

RockAPI parle désormais le Model Context Protocol (MCP). Plus besoin d’écrire du code d’intégration pour chaque framework d’agent : vous ajoutez un serveur MCP à votre client et l’agent appelle RockAPI avec la clé API que vous utilisez déjà. Ce guide explique ce que MCP change réellement, les deux couches à configurer séparément, puis la procédure complète de connexion et de vérification.

Schéma de l'architecture RockAPI MCP montrant un agent IA connecté via un client MCP au serveur MCP RockAPI puis aux modèles OpenAI, Claude et Gemini

Ce que MCP change vraiment

MCP est un standard qui permet à un client IA de découvrir et d’appeler des outils exposés par un serveur. Avant MCP, chaque framework d’agent inventait son propre format de plugin : la même capacité devait être réimplémentée pour Claude Code, Cursor, Codex et les autres.

Sans MCP	Avec MCP
Une intégration sur mesure par client et par fournisseur	Une définition de serveur que tout client MCP peut charger
Des schémas d’outils recopiés dans les prompts	Des schémas découverts à l’exécution via `tools/list`
Une logique d’authentification répétée dans chaque intégration	Un point d’accès, une clé Bearer
Modèle et outils couplés dans la même configuration	Choix du modèle et accès aux outils configurés séparément

Le résultat concret : votre agent dispose d’une surface de capacités stable, et vous cessez de maintenir des intégrations parallèles.

Deux couches à configurer séparément

C’est la source de confusion la plus fréquente, alors distinguez-les avant de commencer.

Couche	Question à laquelle elle répond	Où la configurer
Couche modèle	Quel LLM produit le raisonnement et le texte ?	Réglage du modèle ou du fournisseur dans le client
Couche outils	Quels outils et données l’agent peut-il atteindre ?	Entrée du serveur MCP dans le client

RockAPI se situe sur la couche outils lorsque vous l’ajoutez comme serveur MCP. Il se situe sur la couche modèle lorsque vous l’utilisez comme fournisseur via l’API compatible OpenAI. Les deux usages peuvent coexister, mais ce sont deux entrées distinctes.

Avant de commencer

Créez une clé API. Générez-la sur rockapi.ai/keys et stockez-la dans une variable d’environnement, jamais dans un fichier versionné.
Copiez la configuration MCP. Votre console affiche le point d’accès MCP et le format d’en-tête de votre compte. Utilisez la valeur affichée plutôt qu’une URL mémorisée.
Vérifiez le support MCP du client. Claude Code, Cursor, Codex, VS Code et Claude Desktop prennent en charge MCP. Contrôlez la version du client si la commande ci-dessous est refusée.
Choisissez le modèle. Quel que soit le client, l’agent a toujours besoin d’un LLM. Sélectionnez-le dans les réglages du fournisseur, ou passez par RockAPI.

export ROCKAPI_API_KEY="sk-your-key"
export ROCKAPI_MCP_URL="<point d'accès affiché dans la console MCP>"

Ajouter le serveur MCP

La commande varie selon le client, mais les entrées sont identiques : une URL, un transport et un en-tête Authorization: Bearer.

Claude Code

claude mcp add --transport http rockapi "$ROCKAPI_MCP_URL" \
  --header "Authorization: Bearer $ROCKAPI_API_KEY"

Vérifiez l’enregistrement :

claude mcp list

Codex

Ajoutez le serveur dans ~/.codex/config.toml. Lire le jeton depuis une variable d’environnement évite de stocker le secret dans le fichier :

[mcp_servers.rockapi]
url = "https://your-mcp-endpoint-from-console"
bearer_token_env_var = "ROCKAPI_API_KEY"

Cursor et VS Code

Les deux acceptent un serveur MCP HTTP dans leur configuration JSON. Utilisez la syntaxe d’interpolation d’environnement documentée par votre client pour ne pas écrire la clé en clair :

{
  "mcpServers": {
    "rockapi": {
      "type": "http",
      "url": "${env:ROCKAPI_MCP_URL}",
      "headers": {
        "Authorization": "Bearer ${env:ROCKAPI_API_KEY}"
      }
    }
  }
}

Claude Desktop

Claude Desktop lance des serveurs de type ligne de commande : passez par le pont mcp-remote :

{
  "mcpServers": {
    "rockapi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-mcp-endpoint-from-console",
        "--header",
        "Authorization: Bearer ${ROCKAPI_API_KEY}"
      ]
    }
  }
}

Vérifier la connexion

Un serveur affiché comme connecté ne justifie pas un passage en production. Confirmez les quatre comportements ci-dessous.

Vérification	Comment la lancer	Résultat attendu
Serveur enregistré	`claude mcp list` ou le panneau MCP du client	Le serveur apparaît connecté, sans erreur
Outils découverts	Demandez à l’agent de lister les outils disponibles	Une liste non vide, sans erreur 401
Appel réussi	Demandez une action en lecture seule	Un résultat structuré, pas un délai dépassé
Erreur lisible	Utilisez temporairement une clé erronée	Une erreur d’authentification explicite, pas une réponse vide

Si le serveur se connecte mais que les appels échouent, le problème vient presque toujours du jeton, pas du transport. Faites tourner la clé et retestez avant toute autre investigation.

Règles d’exploitation qui évitent les incidents

Limitez la portée de la clé. Utilisez une clé dédiée à l’intégration MCP plutôt que votre clé de production principale : vous pouvez en révoquer une sans casser l’autre.
Commencez en lecture seule. N’accordez que la capacité minimale nécessaire, puis élargissez quand un workflow réel l’exige.
Suivez la dépense séparément. Un agent piloté par outils émet beaucoup d’appels courts. Une clé distincte rend le coût par agent visible dans le tableau de bord.
Gardez les secrets dans l’environnement. Une clé collée dans un fichier versionné est la fuite la plus fréquente des configurations d’agents. Voir gestion sécurisée des clés API.
Journalisez les appels d’outils. En cas de comportement inattendu, la séquence d’appels explique la situation plus vite que la réponse finale.

FAQ

MCP est-il équivalent à une API compatible OpenAI ?

Non. Une API compatible OpenAI standardise la façon dont votre code appelle un modèle. MCP standardise la façon dont un client IA découvre et appelle des outils. RockAPI propose les deux, et ils se configurent à des endroits différents.

Faut-il encore une clé API avec MCP ?

Oui. Le serveur MCP est joignable, mais la clé identifie votre compte, applique vos limites de débit et enregistre l’usage facturé.

Un serveur MCP peut-il servir plusieurs agents ?

Oui, c’est tout l’intérêt. La même entrée de serveur fonctionne dans plusieurs clients : une session Claude Code et une session Cursor atteignent le même ensemble de capacités avec la même clé.

MCP change-t-il la facturation des modèles ?

Non. La facturation suit les appels de modèles sous-jacents. Consultez tarifs et facturation pour le détail du comptage.

Et si mon client ne gère pas encore les serveurs MCP HTTP ?

Utilisez le pont mcp-remote présenté dans l’exemple Claude Desktop. Il convertit le point d’accès HTTP en processus stdio local, que tout client en ligne de commande peut lancer.

Étape suivante

Si vous n’avez encore envoyé aucune requête, commencez par le Quickstart, puis consultez Modèles et fournisseurs pour choisir le modèle derrière votre agent.

Créer une clé API et connecter votre agent

Générez une clé, copiez la configuration MCP depuis votre console et vérifiez la connexion avant le trafic de production.

Vue d’ensemble

Pour les acheteurs

Pour les vendeurs

RockAPI MCP : connecter vos agents IA à plus de 50 modèles avec une seule clé

Ce que MCP change vraiment

Deux couches à configurer séparément

Avant de commencer

Ajouter le serveur MCP

Claude Code

Codex

Cursor et VS Code

Claude Desktop

Vérifier la connexion

Règles d’exploitation qui évitent les incidents

FAQ

MCP est-il équivalent à une API compatible OpenAI ?

Faut-il encore une clé API avec MCP ?

Un serveur MCP peut-il servir plusieurs agents ?

MCP change-t-il la facturation des modèles ?

Et si mon client ne gère pas encore les serveurs MCP HTTP ?

Étape suivante

Créer une clé API et connecter votre agent

​Ce que MCP change vraiment

​Deux couches à configurer séparément

​Avant de commencer

​Ajouter le serveur MCP

​Claude Code

​Codex

​Cursor et VS Code

​Claude Desktop

​Vérifier la connexion

​Règles d’exploitation qui évitent les incidents

​FAQ

​MCP est-il équivalent à une API compatible OpenAI ?

​Faut-il encore une clé API avec MCP ?

​Un serveur MCP peut-il servir plusieurs agents ?

​MCP change-t-il la facturation des modèles ?

​Et si mon client ne gère pas encore les serveurs MCP HTTP ?

​Étape suivante

Créer une clé API et connecter votre agent

Ce que MCP change vraiment

Deux couches à configurer séparément

Avant de commencer

Ajouter le serveur MCP

Claude Code

Codex

Cursor et VS Code

Claude Desktop

Vérifier la connexion

Règles d’exploitation qui évitent les incidents

FAQ

MCP est-il équivalent à une API compatible OpenAI ?

Faut-il encore une clé API avec MCP ?

Un serveur MCP peut-il servir plusieurs agents ?

MCP change-t-il la facturation des modèles ?

Et si mon client ne gère pas encore les serveurs MCP HTTP ?

Étape suivante