Tutoriel complet Cursor MCP : connecter l'IA aux outils externes

Quand on code avec Cursor, un irritant revient souvent : pour chaque tâche liée au projet, il faut réexpliquer la structure, les tables, les API — comme un cours permanent.

L’IA est capable, mais elle ne « voit » pas les données en base, ni l’arborescence complète, et elle n’appelle pas les API seule. Copier-coller à la main, c’est lent.

Le MCP (Model Context Protocol) apporte une solution propre : un protocole standard pour connecter l’IA aux outils et sources de données. Une fois configuré, l’IA peut interroger la base, lire des fichiers et appeler des API.

Qu’est-ce que le MCP ?

Une analogie simple

En une phrase : le MCP, c’est le port USB-C de l’IA.

Avant, chaque appareil avait son connecteur — Lightning, Micro-USB, autre encore. Puis USB-C a tout unifié.

Même logique ici. Protocole ouvert d’Anthropic pour brancher des outils externes. Les applications IA n’ont plus à réinventer chaque intégration.

Pourquoi le MCP ?

Avant le MCP, connecter une base à l’IA impliquait un développement spécifique par outil — Cursor d’un côté, Claude Desktop de l’autre, incompatible entre eux. Coût et duplication.

Le MCP propose l’idée « écrire une fois, utiliser partout ». Un connecteur base de données conforme au standard fonctionne dans toutes les apps compatibles MCP.

MCP vs plugins classiques

La différence est nette. Un plugin classique étend l’application (thème VS Code, bloqueur de pub). Le MCP étend les capacités du modèle.

Point clé : l’IA choisit quand appeler un outil, sans instruction explicite à chaque fois.

Vous dites : « Montre-moi les commandes de cet utilisateur en base ». Avec MCP, l’IA enchaîne typiquement :

1. Connexion à la base
2. Recherche de l’ID utilisateur
3. Requête sur les commandes
4. Présentation des résultats

Sans « va en base » ni « exécute du SQL ».

Architecture

• MCP Host : l’application IA (Cursor, Claude Desktop)
• MCP Client : gère la connexion Host ↔ Server
• MCP Server : encapsule un service externe (base, API, fichiers)
• Protocole : JSON-RPC standard

Chaque brique a son rôle. Vous configurez les serveurs ; l’IA s’occupe du reste.

Railway - Plateforme de déploiement moderne, sans opérations complexes, en ligne en quelques minutes

Commencer →Pub

Que peut faire le MCP ?

Voici des scénarios que j’ai testés en conditions réelles.

Accès base de données

Gain de temps important.

Sur un e-commerce (utilisateurs, produits, commandes), avant il fallait copier le schéma, expliquer les relations, lister les champs. Maintenant, avec un MySQL MCP Server : « Commandes du dernier mois pour l’utilisateur 123 ». L’IA peut :

• Se connecter
• Analyser le schéma
• Générer du SQL précis
• Exécuter et formater le résultat

Le SQL repose sur votre schéma, pas sur un exemple générique.

Système de fichiers

Utile pour ranger le code.

Beaucoup d’import inutilisés après des mois de dépendances ? Avec le MCP fichiers : « Parcours le projet et supprime les import non utilisés ». L’IA peut parcourir, analyser et modifier. Précieux en refactorisation.

Intégration API

De nombreux services ont déjà un MCP Server.

GitHub MCP

Après configuration :

• « Quels Issues ouverts sont tagués bug ? »
• « Ouvre une PR pour cette branche »
• « Crée une branche feature »

Slack MCP

Notifications d’équipe, par exemple :

• « Poste dans #dev que la nouvelle version est en ligne »
• « Y a-t-il des mentions récentes dans le canal ? »

Google Workspace MCP

Gmail, Docs, Sheets, Drive, Calendar. Exemples : « Mets les stats d’hier dans une feuille Sheets », « Quel est mon agenda demain ? »

Automatisation navigateur

Chrome DevTools MCP permet à l’IA d’interagir avec le navigateur : ouvrir une page, lire le DOM, exécuter du JavaScript, analyser les perfs.

Exemple : « Ouvre notre page d’accueil et indique ce qui ralentit le premier affichage ».

Extraction web

Fetch Server convertit une page en format lisible pour l’IA. Donnez une URL : « Résume les idées principales de cet article » — sans copier-coller manuel.

Comment configurer le MCP ?

Avant de commencer

1. Version Cursor : utilisez une version récente ; le support MCP est récent.
2. Transport :
   • stdio : entrée/sortie standard, service local, géré par Cursor, usage solo
   • SSE/HTTP : réseau, serveur distant, partage multi-utilisateurs

En solo, stdio suffit presque toujours.

Méthode 1 : interface Cursor (recommandée)

Pour une première config :

1. Ouvrir Cursor
2. Raccourci réglages :
   • Windows/Linux : Ctrl+Shift+J
   • macOS : Cmd+Shift+J
3. Menu gauche : « Tools & Integrations »
4. « New MCP Servers » en bas
5. Cursor ouvre ou crée mcp.json

Interface visuelle et validation en direct en cas d’erreur.

Méthode 2 : éditer le fichier

Deux emplacements :

Alibaba Cloud - Choix n°1 des développeurs, 15 % de réduction exclusive sur Lighthouse

Obtenir -15 % →Pub

• Projet : .cursor/mcp.json (projet courant uniquement)
• Global : ~/.cursor/mcp.json (tous les projets)

Je mets GitHub et Fetch en global, la base en config projet.

Structure du fichier

{
  "mcpServers": {
    "nom-du-serveur": {
      "command": "commande",
      "args": ["liste-d-args"],
      "env": {
        "VAR_ENV": "valeur"
      }
    }
  }
}

• command : ex. npx, node, python
• args : nom du paquet ou chemin du script MCP
• env : tokens API, mots de passe base, etc.

Cas 1 : GitHub MCP

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

• npx : pas d’installation globale
• -y : confirmation automatique
• @modelcontextprotocol/server-github : paquet officiel
• GITHUB_PERSONAL_ACCESS_TOKEN : personal access token GitHub

Obtenir le token :

1. GitHub → Settings
2. Developer settings
3. Personal access tokens → Tokens (classic)
4. Generate new token
5. Cocher au minimum repo
6. Copier le token dans la config

Le token n’est affiché qu’une fois — conservez-le.

Cas 2 : Fetch Server

Sans token :

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"]
    }
  }
}

Ensuite, l’IA peut récupérer le contenu de pages web.

Cas 3 : base de données

Exemple MySQL (serveur MCP à installer ou à récupérer en communauté) :

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql-mcp-server/index.js"],
      "env": {
        "DB_HOST": "localhost",
        "DB_USER": "root",
        "DB_PASSWORD": "your_password",
        "DB_NAME": "your_database"
      }
    }
  }
}

À noter :

• Remplacer le chemin du script
• Éviter les mots de passe en dur ; préférer des variables d’environnement
• DB_HOST vers l’hôte distant si la base n’est pas locale

Exemple multi-serveurs

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    },
    "fetch": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"]
    },
    "mysql": {
      "command": "node",
      "args": ["/Users/your-name/mcp-servers/mysql/index.js"],
      "env": {
        "DB_HOST": "localhost",
        "DB_USER": "root",
        "DB_PASSWORD": "your_password",
        "DB_NAME": "your_database"
      }
    }
  }
}

Vérifier la configuration

1. Redémarrer Cursor après modification
2. Tester dans le chat :
   • GitHub : « Montre-moi mes dépôts GitHub »
   • Fetch : « Récupère le contenu principal de https://example.com »
3. Réponse de l’IA : appel d’outil MCP = succès

Messages du type « pas d’accès » ou « impossible de se connecter » → revoir la config.

Dépannage courant

1. JSON invalide

Symptôme : erreur au démarrage ou MCP inactif.

• Virgules, guillemets, accolades
• Validateur JSON
• Pas de virgule après le dernier élément

2. Permissions token insuffisantes

Symptôme : connexion OK, certaines actions échouent.

• Vérifier les scopes du token
• GitHub : au minimum repo

3. Port occupé

Symptôme : échec au lancement du serveur.

• stdio : rare
• SSE : changer de port si conflit

4. Variables d’environnement ignorées

Symptôme : le serveur ne lit pas env.

• Orthographe des noms
• Fichier bien enregistré
• Windows : antislash doublés ou slashes

Usage avancé

Choisir le transport

stdio :

KiloClaw - OpenClaw managé pour l’entreprise : orchestration d’agents IA et routage intelligent

Commencer →Pub

• Développement local
• Usage solo
• Mise en place rapide

SSE/HTTP :

• Équipe sur le même serveur MCP
• Base ou services distants
• Supervision centralisée

Perso : stdio pour GitHub/Fetch ; SSE pour une base partagée.

Gérer plusieurs serveurs

• Global : GitHub, Fetch, Slack
• Projet : base, API interne
• Désactiver : commenter les serveurs inutilisés pour alléger le démarrage

Sécurité

Ne pas committer les tokens :

• .cursor/mcp.json dans .gitignore
• ou variables d’environnement système

Renouveler les tokens régulièrement.

Principe du moindre privilège :

• GitHub : scopes minimaux
• Base : lecture seule si suffisant

Serveurs recommandés

Outils dev :

• @modelcontextprotocol/server-github
• @modelcontextprotocol/server-gitlab

Bases :

• PostgreSQL, MySQL, MongoDB MCP Server

Collaboration :

• Google Workspace MCP
• Slack MCP

Données :

• @modelcontextprotocol/server-fetch
• Firecrawl MCP Server

Navigateur :

• Chrome DevTools MCP

Performance

• N’activer que les serveurs utiles
• Latence réseau pour serveurs distants
• Configurer des timeouts si le serveur le permet

Synthèse

MCP : protocole standard pour brancher outils et données à l’IA — son « USB-C ».

Capacités :

• Bases : SQL généré et exécuté
• Fichiers : traitement par lot
• GitHub, Slack, Google Workspace
• Navigateur et extraction web

Configuration :

• Interface Cursor ou mcp.json
• Champs command, args, env
• Commencer par Fetch, puis GitHub, base, etc.

Conseil : démarrez avec Fetch, sentez l’effet, puis ajoutez selon le besoin. L’écosystème MCP évolue vite ; l’idée « écrire une fois, utiliser partout » progresse — changer d’outil IA ne devrait plus tout refaire à la main.