> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rockapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> RockAPI prend désormais en charge le Model Context Protocol. Comprenez ce que MCP change pour vos agents IA, comment ajouter le serveur MCP RockAPI dans Claude Code, Cursor, Codex ou Claude Desktop, et comment vérifier la connexion.

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](https://mintcdn.com/rockapi/H_B3LeAF53GjlC9D/images/blog/rockapi-mcp-architecture.svg?fit=max\&auto=format\&n=H_B3LeAF53GjlC9D\&q=85\&s=e510582e3dffb537393cef696ce25283)

## 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

1. **Créez une clé API.** Générez-la sur [rockapi.ai/keys](https://rockapi.ai/keys) et stockez-la dans une variable d'environnement, jamais dans un fichier versionné.
2. **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.
3. **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.
4. **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.

```bash theme={null}
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

```bash theme={null}
claude mcp add --transport http rockapi "$ROCKAPI_MCP_URL" \
  --header "Authorization: Bearer $ROCKAPI_API_KEY"
```

Vérifiez l'enregistrement :

```bash theme={null}
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 :

```toml theme={null}
[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 :

```json theme={null}
{
  "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` :

```json theme={null}
{
  "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](https://docs.rockapi.ai/fr/blog/buyers/secure-api-key-management.md).
* **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](https://docs.rockapi.ai/fr/pricing-and-billing.md) 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](https://docs.rockapi.ai/fr/quickstart.md), puis consultez [Modèles et fournisseurs](https://docs.rockapi.ai/fr/models-and-providers.md) pour choisir le modèle derrière votre agent.

> [card] [Créer une clé API et connecter votre agent](https://rockapi.ai/sign-up?utm_source=docs\&utm_medium=referral\&utm_campaign=blog_buyers_mcp_fr)
>
> Générez une clé, copiez la configuration MCP depuis votre console et vérifiez la connexion avant le trafic de production.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.