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

# Serveur MCP

> Connectez Claude, Cursor et d'autres agents à FlexInference via le protocole de contexte de modèle (MCP).

Utilisez le serveur du protocole de contexte de modèle (MCP) de FlexInference pour permettre aux agents de codage de lire la documentation et d'effectuer des actions de compte approuvées. Il s'agit d'un serveur HTTP distant et streamable, accessible à l'adresse :

```
https://mcp.flexinference.com/mcp
```

Le serveur expose deux groupes d'outils. Les outils de documentation fonctionnent sans connexion. Les outils de compte nécessitent OAuth, avec un scope par outil, avant qu'un agent puisse lire l'utilisation ou gérer les clés.

<Note>
  Le serveur MCP est distinct de l'API d'inférence située à
  `https://api.flexinference.com/v1`. Il n'exécute jamais d'inférence et ne voit
  jamais vos invites ou vos réponses. Il gère uniquement la documentation et les
  actions de compte.
</Note>

## Connexion

Ajoutez le serveur à tout client MCP prenant en charge les serveurs HTTP distants, y compris Claude et Cursor. Utilisez cette configuration :

<CodeGroup>
  ```json mcp.json theme={null}
  {
    "mcpServers": {
      "flexinference": {
        "type": "http",
        "url": "https://mcp.flexinference.com/mcp"
      }
    }
  }
  ```

  ```bash Claude Code theme={null}
  claude mcp add --transport http flexinference https://mcp.flexinference.com/mcp
  ```
</CodeGroup>

Le premier appel d'outil de compte ouvre un navigateur pour la connexion au tableau de bord, puis affiche un écran de consentement avec les scopes demandés. Approuvez ou restreignez les scopes, et le client stockera le jeton. Les outils de documentation ne nécessitent pas d'authentification.

## Outils

### Outils de documentation (pas de connexion)

| Tool                  | Arguments          | What it does                                                                                                                                 |
| --------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `search_docs`         | `query` (required) | Recherche dans la documentation FlexInference et le catalogue complet des erreurs, et renvoie les meilleures correspondances avec des liens. |
| `get_error_reference` | `code` (optional)  | Recherche la signification d'un code d'erreur FlexInference et comment le corriger. Omettez `code` pour lister tous les codes.               |

### Outils de compte (OAuth, un scope par outil)

| Tool                 | Scope          | Arguments          | What it does                                                                                                                                                    |
| -------------------- | -------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_usage_summary`  | `usage:read`   | none               | Votre utilisation flex et vos économies, ventilées par modèle.                                                                                                  |
| `list_api_keys`      | `keys:read`    | none               | Vos clés API actives par nom, les 4 derniers caractères et la date de création. Jamais la clé complète.                                                         |
| `create_api_key`     | `keys:write`   | `name` (required)  | Crée une nouvelle clé `flex_live_`. La clé complète est renvoyée une seule fois.                                                                                |
| `revoke_api_key`     | `keys:write`   | `keyId` (required) | Révoque une clé par son ID.                                                                                                                                     |
| `get_byok_status`    | `byok:status`  | none               | Indique quels fournisseurs ont une clé enregistrée, sous forme de oui ou non par fournisseur. Jamais la clé.                                                    |
| `get_billing_status` | `billing:read` | none               | Votre méthode de paiement (marque et 4 derniers caractères uniquement), le statut de votre compte, la commission accumulée et la prochaine date de facturation. |

## Authentification et scopes

Le serveur implémente OAuth 2.1 avec le même système d'identité que le tableau de bord, de sorte qu'un agent est mappé à la même organisation. Chaque outil de compte nécessite exactement un scope. L'écran de consentement vous permet d'approuver ou de restreindre les scopes demandés.

Le serveur n'utilise ni cookies ni sessions côté serveur. Chaque appel d'outil transporte son propre jeton, et chaque outil vérifie son scope avant de lire ou de modifier des données.

| Scope          | Grants                                                                                               |
| -------------- | ---------------------------------------------------------------------------------------------------- |
| `docs:read`    | Recherche dans la documentation et lecture du catalogue d'erreurs. Accordé à tous, pas de connexion. |
| `usage:read`   | Lecture de votre utilisation et de vos économies.                                                    |
| `keys:read`    | Liste de vos clés API.                                                                               |
| `keys:write`   | Création et révocation de clés API.                                                                  |
| `byok:status`  | Lecture des fournisseurs ayant une clé enregistrée.                                                  |
| `billing:read` | Lecture de votre statut de facturation.                                                              |

<Warning>
  Le serveur MCP n'accepte jamais une clé de fournisseur brute. Les clés BYOK
  sont stockées chiffrées et ne sont pas envoyées par requête. Il n'y a pas de
  scope d'écriture pour BYOK, et aucun outil n'accepte une valeur `sk-...`,
  `AIza...` ou `sk-ant-...`. `get_byok_status` indique seulement oui ou non par
  fournisseur. Ajoutez ou renouvelez les clés de fournisseur sur le [tableau de
  bord](https://www.flexinference.com/dashboard).
</Warning>