Model Context Protocol (MCP)

Connecte des outils externes et des sources de données à Cursor via MCP

Qu’est-ce que MCP ?

Le Model Context Protocol (MCP) permet à Cursor de se connecter à des outils et à des sources de données externes.

Pourquoi utiliser MCP ?

MCP connecte Cursor à des systèmes et des données externes. Plutôt que de réexpliquer la structure de ton projet, intègre-toi directement à tes outils.

Écris des serveurs MCP dans n’importe quel langage capable d’écrire sur stdout ou d’exposer un endpoint HTTP — Python, JavaScript, Go, etc.

Fonctionnement

Les serveurs MCP exposent leurs fonctionnalités via le protocole, reliant Cursor à des outils externes ou à des sources de données.

Cursor prend en charge trois méthodes de transport :

Transport	Environnement d’exécution	Déploiement	Utilisateurs	Entrée	Auth
stdio	Local	Géré par Cursor	Utilisateur unique	Commande shell	Manuel
SSE	Local/Distant	Déployé en tant que serveur	Utilisateurs multiples	URL d’un endpoint SSE	OAuth
Streamable HTTP	Local/Distant	Déployé en tant que serveur	Utilisateurs multiples	URL d’un endpoint HTTP	OAuth

Prise en charge du protocole

Cursor prend en charge les fonctionnalités suivantes du protocole MCP :

Fonctionnalité	Prise en charge	Description
Tools	Pris en charge	Fonctions que le modèle d’IA peut exécuter
Prompts	Pris en charge	Messages et workflows modélisés pour les utilisateurs
Resources	Pris en charge	Sources de données structurées pouvant être lues et référencées
Roots	Pris en charge	Requêtes initiées par le serveur sur les limites d’URI ou de système de fichiers dans lesquelles opérer
Elicitation	Pris en charge	Demandes initiées par le serveur pour obtenir des informations supplémentaires auprès des utilisateurs

Installation de serveurs MCP

Installation en un clic

Installe des serveurs MCP depuis notre collection et authentifie-toi via OAuth.

Parcourir les outils MCP

Parcours les serveurs MCP disponibles

Bouton « Ajouter à Cursor »

Crée un bouton « Ajouter à Cursor »

Utiliser mcp.json

Configure des serveurs MCP personnalisés avec un fichier JSON :

CLI Server - Node.js

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

Configuration du serveur STDIO

Pour les serveurs STDIO (serveurs locaux en ligne de commande), configure ces champs dans ton mcp.json :

Champ	Requis	Description	Exemples
type	Oui	Type de connexion au serveur	"stdio"
command	Oui	Commande pour lancer l’exécutable du serveur. Elle doit être disponible dans ton PATH système ou inclure son chemin complet.	"npx", "node", "python", "docker"
args	Non	Tableau d’arguments transmis à la commande	["server.py", "--port", "3000"]
env	Non	Variables d’environnement du serveur	{"API_KEY": "${input:api-key}"}
envFile	Non	Chemin vers un fichier d’environnement pour charger d’autres variables	".env", "${workspaceFolder}/.env"

Utiliser l’API d’extension

Pour enregistrer des serveurs MCP par code, Cursor fournit une API d’extension qui permet une configuration dynamique sans modifier les fichiers mcp.json. C’est particulièrement utile pour les environnements d’entreprise et les workflows d’installation automatisés.

Référence de l’API d’extension MCP

Découvre comment enregistrer des serveurs MCP par code avec vscode.cursor.mcp.registerServer()

Emplacements de configuration

Configuration du projet

Crée .cursor/mcp.json dans ton projet pour des outils propres au projet.

Configuration globale

Crée ~/.cursor/mcp.json dans ton répertoire personnel pour des outils disponibles partout.

Interpolation de configuration

Utilise des variables dans les valeurs de mcp.json. Cursor résout les variables dans ces champs : command, args, env, url et headers.

Syntaxe prise en charge :

• ${env:NAME} variables d’environnement
• ${userHome} chemin vers ton dossier personnel
• ${workspaceFolder} racine du projet (le dossier qui contient .cursor/mcp.json)
• ${workspaceFolderBasename} nom de la racine du projet
• ${pathSeparator} et ${/} séparateur de chemins du système

Exemples

{
  "mcpServers": {
    "local-server": {
      "command": "python",
      "args": ["${workspaceFolder}/tools/mcp_server.py"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "remote-server": {
      "url": "https://api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
      }
    }
  }
}

Authentification

Les serveurs MCP utilisent des variables d’environnement pour l’authentification. Passe les clés API et les jetons via la config.

Cursor prend en charge OAuth pour les serveurs qui l’exigent.

Utiliser MCP dans le chat

Le Composer Agent utilise automatiquement les outils MCP répertoriés sous Available Tools lorsqu’ils sont pertinents. Demande un outil précis par son nom ou décris ce dont tu as besoin. Active ou désactive des outils dans les paramètres.

Activer ou désactiver des outils

Active ou désactive les outils MCP directement depuis l’interface de chat. Clique sur le nom d’un outil dans la liste pour le basculer. Les outils désactivés ne seront pas chargés dans le contexte ni disponibles pour l’Agent.

Approbation des outils

Par défaut, l’agent demande une approbation avant d’utiliser les outils MCP. Clique sur la flèche à côté du nom de l’outil pour afficher les arguments.

Exécution automatique

Active l’exécution automatique pour permettre à Agent d’utiliser les outils MCP sans te demander. Fonctionne comme des commandes de terminal. En savoir plus sur les paramètres d’exécution automatique ici.

Réponse de l’outil

Cursor affiche la réponse dans le chat avec des vues déroulantes pour les arguments et les réponses :

Images comme contexte

Les serveurs MCP peuvent renvoyer des images — captures d’écran, schémas, etc. Renvoye-les sous forme de chaînes encodées en base64 :

const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ full base64 clipped for readability

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});

Consulte cet exemple de serveur pour les détails de l’implémentation. Cursor joint les images renvoyées à la discussion. Si le modèle prend en charge les images, il les analyse.

Considérations de sécurité

Quand tu installes des serveurs MCP, garde ces pratiques de sécurité en tête :

• Vérifie la source : N’installe des serveurs MCP que depuis des développeurs et des dépôts de confiance
• Passe en revue les autorisations : Vérifie à quelles données et à quelles API le serveur aura accès
• Limite les clés API : Utilise des clés API restreintes avec les autorisations minimales nécessaires
• Audite le code : Pour les intégrations critiques, examine le code source du serveur

Souviens-toi que les serveurs MCP peuvent accéder à des services externes et exécuter du code en ton nom. Assure-toi toujours de comprendre ce que fait un serveur avant de l’installer.

Exemples concrets

Pour des exemples pratiques de MCP en action, consulte notre guide de développement web, qui montre comment intégrer Linear, Figma et des outils de navigation à ton workflow de développement.

FAQ

À quoi servent les serveurs MCP ?

Les serveurs MCP connectent Cursor à des outils externes comme Google Drive, Notion et d’autres services pour intégrer des docs et des exigences directement dans ton workflow de code.

Comment déboguer des problèmes de serveur MCP ?

Consulte les logs MCP en procédant ainsi : 1. Ouvre le panneau Output dans Cursor (Ctrl+Shift+U) 2. Sélectionne « MCP Logs » dans le menu déroulant 3. Vérifie les erreurs de connexion, les problèmes d’authentification ou les crashs serveur. Les logs affichent l’initialisation du serveur, les appels d’outils et les messages d’erreur.

Puis-je désactiver temporairement un serveur MCP ?

Oui ! Active/désactive des serveurs sans les supprimer : 1. Ouvre Settings (Ctrl+Shift+J) 2. Va dans Features → Model Context Protocol 3. Clique sur l’interrupteur à côté de n’importe quel serveur pour l’activer/désactiver. Les serveurs désactivés ne se chargent pas et n’apparaissent pas dans le chat. C’est utile pour le dépannage ou pour réduire l’encombrement des outils.

Que se passe-t-il si un serveur MCP plante ou dépasse le délai ?

Si un serveur MCP échoue : Cursor affiche un message d’erreur dans le chat, l’appel d’outil est marqué comme ayant échoué, tu peux réessayer l’opération ou consulter les logs pour plus de détails, et les autres serveurs MCP continuent de fonctionner normalement. Cursor isole les pannes de serveur pour éviter qu’un serveur n’affecte les autres.

Comment mettre à jour un serveur MCP ?

Pour les serveurs basés sur npm : 1. Retire le serveur des paramètres 2. Vide le cache npm : npm cache clean --force 3. Réajoute le serveur pour obtenir la dernière version. Pour les serveurs personnalisés, mets à jour tes fichiers locaux et redémarre Cursor.

Puis-je utiliser des serveurs MCP avec des données sensibles ?

Oui, mais suis les bonnes pratiques de sécurité : Utilise des variables d’environnement pour les secrets, ne les code jamais en dur, exécute les serveurs sensibles en local avec le transport stdio, limite les permissions des clés API au strict nécessaire, passe en revue le code du serveur avant de le connecter à des systèmes sensibles, et envisage d’exécuter les serveurs dans des environnements isolés.