​
Qu’est-ce que MCP ?

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

​
Pourquoi utiliser MCP ?

MCP connecte Cursor aux systèmes externes et aux données. Au lieu d’expliquer répétitivement la structure de votre projet, intégrez-vous directement avec vos outils. Écrivez des serveurs MCP dans n’importe quel langage capable d’imprimer vers stdout ou de servir un endpoint HTTP - Python, JavaScript, Go, etc.

​
Comment ça fonctionne

Les serveurs MCP exposent des capacités à travers le protocole, connectant Cursor aux outils externes ou aux sources de données. Cursor prend en charge trois méthodes de transport :
TransportEnvironnement d’exécutionDéploiementUtilisateursEntréeAuthentification
stdioLocalCursor gèreUtilisateur uniqueCommande shellManuel
SSELocal/DistantDéployer comme serveurUtilisateurs multiplesURL vers un endpoint SSEOAuth
Streamable HTTPLocal/DistantDéployer comme serveurUtilisateurs multiplesURL vers un endpoint HTTPOAuth

​
Installation des serveurs MCP

​
Installation en un clic

Installez des serveurs MCP depuis notre collection et authentifiez-vous avec OAuth.

Parcourir les outils MCP

Parcourir les serveurs MCP disponibles

Bouton Ajouter à Cursor

Créer un bouton « Ajouter à Cursor »

​
Utilisation de mcp.json

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

​
Emplacements de configuration

Configuration de projet

Créez .cursor/mcp.json dans votre projet pour des outils spécifiques au projet.

Configuration globale

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

​
Authentification

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

​
Utilisation de MCP dans le chat

Le Composer Agent utilise automatiquement les outils MCP listés sous Outils disponibles lorsque c’est pertinent. Demandez un outil spécifique par son nom ou décrivez ce dont vous avez besoin. Activez ou désactivez les outils depuis les paramètres.

​
Basculer les outils

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

​
Approbation des outils

L’Agent demande l’approbation avant d’utiliser les outils MCP par défaut. Cliquez sur la flèche à côté du nom de l’outil pour voir les arguments.

​
Exécution automatique

Activez l’exécution automatique pour que l’Agent utilise les outils MCP sans demander. Fonctionne comme les commandes de terminal. En savoir 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 retourner des images - captures d’écran, diagrammes, etc. Retournez-les sous forme de chaînes encodées en base64 : 
const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ base64 complète tronquée pour la lisibilité

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});
Voir cet exemple de serveur pour les détails d’implémentation. Cursor attache les images retournées au chat. Si le modèle prend en charge les images, il les analyse.

​
Considérations de sécurité

Lors de l’installation de serveurs MCP, considérez ces pratiques de sécurité :
  • Vérifiez la source : N’installez que des serveurs MCP provenant de développeurs et de dépôts de confiance
  • Examinez les permissions : Vérifiez quelles données et API le serveur va accéder
  • Limitez les clés API : Utilisez des clés API restreintes avec les permissions minimales requises
  • Auditez le code : Pour les intégrations critiques, examinez le code source du serveur
Rappelez-vous que les serveurs MCP peuvent accéder à des services externes et exécuter du code en votre nom. Comprenez toujours ce qu’un serveur fait avant l’installation.

​
Exemples concrets

Pour des exemples pratiques de MCP en action, consultez notre guide de développement Web qui démontre l’intégration des outils Linear, Figma et de navigateur dans votre flux de travail de développement.

​
FAQ