​
Qu’est-ce que MCP ?

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

​
Pourquoi utiliser MCP ?

MCP relie Cursor à des systèmes et des données externes. Au lieu d’expliquer ta structure de projet encore et encore, 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.

​
Comment ça marche

Les serveurs MCP exposent des capacités via le protocole, connectant Cursor à des outils ou à des sources de données externes. Cursor prend en charge trois méthodes de transport :
TransportEnvironnement d’exécutionDéploiementUtilisateursEntréeAuth
stdioLocalGéré par CursorUn seul utilisateurCommande shellManuel
SSELocal/DistantDéployé en tant que serveurPlusieurs utilisateursURL d’un endpoint SSEOAuth
Streamable HTTPLocal/DistantDéployé en tant que serveurPlusieurs utilisateursURL d’un endpoint HTTPOAuth

​
Prise en charge du protocole

Cursor prend en charge les capacités MCP suivantes :
FonctionnalitéPrise en chargeDescription
ToolsPris en chargeFonctions que le modèle d’IA peut exécuter
PromptsPris en chargeMessages et workflows modélisés pour les utilisateurs
RootsPris en chargeRequêtes initiées par le serveur sur les limites d’URI ou de système de fichiers dans lesquelles opérer
ElicitationPris en chargeDemandes initiées par le serveur pour obtenir des informations supplémentaires auprès des utilisateurs

​
Installation des serveurs MCP

​
Installation en un clic

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

Parcourir les outils MCP

Parcours les serveurs MCP disponibles

Bouton « Add to Cursor »

Crée un bouton « Add to Cursor »

​
Utiliser mcp.json

Configure des serveurs MCP personnalisés avec un fichier JSON : 
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

​
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 enterprise et les workflows d’installation automatisés.

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

Apprends à enregistrer des serveurs MCP par programmation avec vscode.cursor.mcp.registerServer()

​
Emplacements de configuration

Configuration du projet

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

Configuration globale

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

​
Authentification

Les serveurs MCP utilisent des variables d’environnement pour l’authentification. Passe les clés d’API et les jetons via la config. Cursor prend en charge OAuth pour les serveurs qui en ont besoin.

​
Utiliser MCP dans le chat

Le Composer Agent utilise automatiquement les outils MCP répertoriés sous Available Tools quand c’est pertinent. 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/désactiver des outils

Active ou désactive des 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 des outils MCP. Clique sur la flèche à côté du nom de l’outil pour voir les arguments.

​
Exécution automatique

Active l’exécution automatique pour que l’Agent utilise des outils MCP sans demander. Ça fonctionne comme des commandes de terminal. Lis-en plus sur le mode Yolo ici.

​
Réponse de l’outil

Cursor affiche la réponse dans le chat avec des vues extensibles des arguments et des 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...";
// ^ base64 complet tronqué pour la lisibilité

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 d’implémentation. Cursor joint les images renvoyées au chat. 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 : Installe des serveurs MCP uniquement 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 va consulter
  • Limite les clés d’API : Utilise des clés d’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 de bien comprendre ce que fait un serveur avant de l’installer.

​
Exemples concrets

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

​
FAQ