Connecter Cursor à votre studio

De quoi s’agit-il

Cursor est un éditeur avec une IA intégrée. Grâce au connecteur d’IA, le chat de Cursor consulte les données de votre studio (ventes, clients, agenda, finances) lorsque vous posez une question, avec les autorisations de l’utilisateur associé à la clé. Il ne fait que consulter les données : il ne modifie rien dans le système.

Quand l’utiliser

Vous développez une intégration ou un site et souhaitez consulter les données réelles du studio sans quitter l’éditeur.
Vous utilisez le chat de Cursor au quotidien et souhaitez poser des questions sur l’activité du studio.

Avant de commencer

Munissez-vous de l’adresse du connecteur et d’une clé API avec l’option « Autoriser l’utilisation comme connecteur d’IA », créées en suivant l’article Connecteur d’IA.

Étape par étape

Étape 1 — Ajouter le connecteur

Ouvrez (ou créez) le fichier ~/.cursor/mcp.json et ajoutez l’extrait ci-dessous, en remplaçant l’adresse par celle que vous avez copiée avec Copier l’adresse et hk_... par votre clé :

{
  "mcpServers": {
    "heya": {
      "url": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

Étape 2 — Vérifier la connexion

Dans les paramètres de Cursor, ouvrez la section MCP. Le connecteur heya doit apparaître comme actif, avec les outils listar_areas, buscar_ferramentas et executar_consulta.

Étape 3 — Poser une question

Dans le chat de Cursor, posez par exemple la question suivante : « Quels clients ont été reçus aujourd’hui au studio ? »

Et ensuite

Cursor trouve la requête correspondant à la question, l’exécute et répond avec les chiffres du système.
La clé apparaît dans l’onglet API Key, avec la Dernière utilisation mise à jour.
Pour couper l’accès, révoquez la clé dans l’onglet API Key : Cursor perdra l’accès sous 30 secondes.

Erreurs fréquentes et questions

Q : Le connecteur affiche une erreur dans les paramètres de Cursor. Que faire ? R : Vérifiez que l’adresse se termine par /mcp et que la clé a été collée en entier, avec Bearer suivi d’une espace. Après avoir modifié le fichier mcp.json, désactivez puis réactivez le connecteur dans les paramètres de Cursor.

Q : Puis-je utiliser une variable d’environnement à la place de la clé ? R : Certaines versions de Cursor ne remplacent pas la variable par sa valeur dans l’en-tête et envoient le texte tel quel. Si le connecteur ne se connecte pas avec la variable, saisissez directement la clé dans le fichier de votre utilisateur.

Q : Puis-je mettre la configuration dans le fichier .cursor/mcp.json du projet ? R : Évitez de le faire : ce fichier est généralement ajouté au contrôle de version et la clé serait exposée. Utilisez le fichier de votre utilisateur (~/.cursor/mcp.json).

Q : Cursor indique que la clé doit avoir l’option « Autoriser l’utilisation comme connecteur d’IA ». Pourquoi ? R : La clé a été créée sans cette option. Modifiez la clé dans l’onglet API Key et cochez Autoriser l’utilisation comme connecteur d’IA.

Q : Cursor a ouvert une page de connexion au lieu d’utiliser la clé. Que faire ? R : Vérifiez que le bloc headers contenant la clé figure dans le fichier mcp.json. Avec la bonne clé, le système répond directement et la connexion n’est pas nécessaire. Si Cursor insiste pour se connecter et que la connexion échoue, utilisez la clé dans Claude Code ou Gemini CLI, ou contactez l’assistance.

Q : Cursor peut-il modifier les données du système via le connecteur ? R : Non. Le connecteur ne fait que consulter les données. Les modifications se font dans le système.