De la préparation
à votre première connexion.

01 / Installer l’extension VS Code

Dans le Marketplace VS Code, recherchez Claude Code Config Helper, et vérifiez l’éditeur : liliangshan. La version publiée fait foi ; les versions de test locales peuvent différer.

Installation VSIX possible

Avec un VSIX local, choisissez Extensions → … → Installer depuis VSIX. Rechargez au moment opportun : cela interrompt les tâches CLI.

02 / Terminer les trois étapes

1. Choisir la langue et préparer le CLITéléchargez et validez le CLI ou choisissez un exécutable existant. Source officielle par défaut, miroir chinois sur choix explicite.
2. Ajouter fournisseurs et modèlesConfigurez adresse, authentification et clé API, puis récupérez ou ajoutez les modèles. Aucun message de test payant n’est requis.
3. Choisir les modèles et ouvrir le chatRéglez modèle principal, modèles optionnels et réflexion. Session principale à droite ; session parallèle indépendante à gauche.

03 / Choisir l’outil et copier la configuration

Génération d’exemples locaux uniquement : ni connexion, ni collecte de mots de passe, ni installation. Remplacez adresses et chemins ; configurez les secrets dans le client.

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@liangshanli/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "db.example.com",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "ai_reader",
        "MYSQL_PASSWORD": "${MYSQL_PASSWORD}",
        "MYSQL_DATABASE": "app_db",
        "MYSQL_SSL": "true",
        "READONLY": "true",
        "ALLOW_DDL": "false",
        "ALLOW_DROP": "false",
        "ALLOW_DELETE": "false"
      }
    }
  }
}

L’exemple MySQL active lecture seule et TLS. Utilisez un compte en lecture seule et un nom d’hôte conforme au certificat.

Variables et formats de configuration

• Claude Code：Utilise mcpServers, à la racine du projet dans .mcp.json. Les variables telles que ${MYSQL_PASSWORD} dépendent de l’environnement au lancement. Vérifiez les règles du client.
• MCP natif VS Code :Utilise servers, stocké dans .vscode/mcp.json. Le mot de passe utilise l’invite VS Code, pas un champ du site.
• Cursor：Stocker dans .cursor/mcp.json, avec mcpServers. L’expansion dépend de la version. Un espace réservé non résolu n’est pas un mot de passe.
• Cette extension :Le fichier natif .mcp.json est découvert par le CLI ;--strict-mcp-config limite les sources. Lire la configuration VS Code ne résout pas ses variables natives. Préférez le format Claude Code ici.

Fusionnez uniquement les serveurs nécessaires sans écraser le fichier. Si npx échoue sous Windows, utilisez le chemin absolu de Node.js et le point d’entrée du paquet ; voir npm.

04 / Vérifier les outils

1. Vérifier l’environnement localInstallez une version Node.js compatible : SSH exige 20+. Voir npm pour les autres. Le client doit trouver node / npx.
2. Reconnecter MCP ou redémarrer le CLIRechargez les outils après sauvegarde. Redémarrez le CLI du côté concerné, sans tâche importante en cours.
3. Commencer par des actions à faible impactListez les outils et testez la connexion, puis consultez schémas, clés Redis de test ou GET sur votre API.

Exemple de demande :

Vérifiez que les outils MCP sont disponibles.
Lisez seulement le schéma de test et expliquez les relations.
Ne modifiez rien ; signalez d’abord toute connexion ou permission manquante.

05 / Définir les limites avant les capacités

06 / Outils MCP absents ?

• Vérifiez nom, dossier et champs racine selon le client.
• Vérifiez JSON, noms des paquets et commande de lancement.
• Vérifiez confiance, approbation MCP, mode strict et contrôles d’outils.
• Vérifiez adresses, réseau, identifiants et droits serveur.
• Redémarrez le CLI concerné et lisez les journaux. Ne publiez jamais de configuration contenant des secrets.