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

# Configuration MCP pour Claude Code

> Configuration du MCP distant natif, autorisation dans le navigateur, vérification des outils et dépannage

Cette page traite du MCP natif dans Claude Code. Le service distant utilise Streamable HTTP et OAuth dans le navigateur, sans nécessiter EvoLink CLI. Pour l’exécution par commandes et par compétence, utilisez le [guide CLI](https://evolink.ai/docs/fr/cli/claude-code.md) distinct.

## Connecter le MCP distant

Pour les outils natifs, utilisez **Streamable HTTP + OAuth** avec cette URL de serveur :

```text theme={null}
https://mcp.evolink.ai/mcp
```

L’installation de la CLI n’est pas nécessaire. Sauvegardez la configuration existante, ne fusionnez que la partie EvoLink et préservez les autres services. Choisissez l’enregistrement par commande ou l’enregistrement manuel.

**1. Ajouter le serveur HTTP**

Dans un terminal où Claude Code est installé, exécutez :

```bash theme={null}
claude mcp add --transport http --scope user evolink https://mcp.evolink.ai/mcp
```

`--scope user` rend cette connexion disponible dans tous les projets de l’utilisateur actuel. L’ajout confirme seulement que la configuration a été écrite.

**2. Se connecter dans Claude Code**

Dans la conversation Claude Code, saisissez la commande de session suivante et sélectionnez l’action d’authentification d’EvoLink :

```text theme={null}
/mcp
```

Effectuez la connexion et l’autorisation dans le navigateur, puis vérifiez la connexion dans Claude Code. Cette commande de session n’est pas une commande shell ordinaire.

**3. Contrôler les outils et vérifier gratuitement**

```bash theme={null}
claude mcp list
```

Si vous y êtes invité, approuvez dans Claude Code une connexion de projet en attente. Dans une nouvelle session, envoyez le prompt de vérification ci-dessous et confirmez que vous obtenez un solde et des modèles réels.

Pour une configuration de projet, fusionnez ceci dans `.mcp.json` :

```json theme={null}
{
  "mcpServers": {
    "evolink": {
      "type": "http",
      "url": "https://mcp.evolink.ai/mcp"
    }
  }
}
```

Ne placez pas ce bloc dans `.claude/settings.local.json` ; la commande ci-dessus gère la portée utilisateur. Consultez la [documentation de Claude Code](https://code.claude.com/docs/en/mcp).

Après l’autorisation, envoyez ceci dans la conversation de l’agent :

```text theme={null}
Utilise EvoLink pour vérifier le solde de mon compte et rechercher les modèles d’image disponibles. Ne génère rien pour le moment.
```

**Réussite** : des appels réels à `check_balance` et `search_models` renvoient des résultats. Vérifiez ces outils dans la connexion MCP réellement utilisée.

## Mises à jour, déconnexion et dépannage

EvoLink met à jour le serveur MCP hébergé. Après une modification de la configuration, actualisez la session réelle du client. Si nécessaire, renouvelez l’autorisation au moyen de l’action OAuth de ce client. Pour déconnecter EvoLink, désactivez-le, déconnectez-vous ou supprimez-le dans les paramètres MCP de l’hôte ; conservez les autres serveurs.

| Symptôme | Action |
| - | - |
| URL ajoutée mais aucun outil | Activez la connexion, terminez l’autorisation, actualisez et vérifiez la politique de l’organisation |
| 401 ou authentification requise | Renouvelez l’autorisation de cette connexion MCP et conservez les identifiants des tâches initiales |
| 403 ou outil refusé | Vérifiez les permissions de l’hôte, l’état du compte ou de la clé et les erreurs réseau |
| Délai dépassé ou réponse perdue | Interrogez et reprenez l’opération initiale au lieu de générer à nouveau |
| Résultat réduit à un lien ou aperçu gris | Ouvrez et livrez l’original sans le refaire automatiquement |

Consultez [Coûts, accès et dépannage MCP](https://evolink.ai/docs/fr/mcp/billing.md#faq). Lisez le [flux de travail de création](https://evolink.ai/docs/fr/mcp/overview.md#workflows) avant de soumettre ; la forme des appels est décrite dans la [référence des outils MCP](https://evolink.ai/docs/fr/mcp/tools.md).


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