Configuration Corcava MCP pour Cursor : connecter tâches et projets à votre éditeur

Connectez Cursor à Corcava via MCP pour avoir la gestion de projet directement dans votre IDE. Ce guide explique comment ajouter Corcava comme serveur MCP, redémarrer ou recharger, et tester avec votre premier workflow.

Prérequis

Cursor installé sur votre système
Un compte Corcava avec accès clé API
Connaissance de base de l'édition de fichiers JSON

Étape 1 : Obtenir votre clé API Corcava

Connectez-vous à Corcava
Allez dans Paramètres → Intégrations
Repérez la section API publique
Cliquez sur Ajouter une clé API
Copiez la clé immédiatement (elle n'est affichée qu'une fois)
Conservez-la en lieu sûr — vous en aurez besoin à l'étape suivante

💡 Astuce

Donnez un nom explicite à votre clé API (ex. « Cursor – PC bureau ») pour gérer plusieurs clés facilement.

Étape 2 : Localiser le fichier de configuration MCP

Cursor enregistre la configuration des serveurs MCP dans un seul fichier sur toutes les plateformes :

Emplacement du fichier de configuration

~/.cursor/mcp.json

Le symbole ~ désigne votre répertoire personnel :

macOS/Linux : /Users/votrenom/.cursor/mcp.json
Windows : C:\Users\votrenom\.cursor\mcp.json

Si le fichier n'existe pas

Si ~/.cursor/mcp.json n'existe pas :

Créez le dossier .cursor dans votre répertoire personnel (s'il n'existe pas)
Créez un fichier nommé mcp.json
Commencez avec un objet JSON vide : {}

Étape 3 : Ajouter la configuration du serveur MCP Corcava

Ouvrez ~/.cursor/mcp.json dans un éditeur de texte et ajoutez la configuration du serveur MCP Corcava.

Si c'est votre premier serveur MCP

Si le fichier est vide ou n'a pas de section mcpServers, utilisez cette structure :

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Si vous avez déjà d'autres serveurs MCP

Si vous avez déjà des serveurs MCP configurés, ajoutez Corcava à l'objet mcpServers existant :

{
  "mcpServers": {
    "existing-server": {
      ...
    },
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

⚠️ Important

Remplacez YOUR_API_KEY par la clé API que vous avez copiée à l'étape 1
Il doit y avoir un espace entre « Bearer » et votre clé API
Ne mettez pas de guillemets autour de la clé API dans la valeur du header
Vérifiez que le JSON est valide (pas de virgule en trop, guillemets corrects)

Étape 4 : Enregistrer et redémarrer Cursor

Enregistrez le fichier mcp.json
Quittez complètement Cursor (pas seulement fermer la fenêtre)
Redémarrez Cursor
Attendez que Cursor soit entièrement initialisé

Alternative : Recharger la fenêtre

Certaines versions de Cursor permettent de recharger sans redémarrage complet :

Appuyez sur Cmd+Shift+P (macOS) ou Ctrl+Shift+P (Windows/Linux)
Tapez « Recharger la fenêtre » et sélectionnez l'option

Note : Un redémarrage complet est plus fiable. N'utilisez le rechargement que si le redémarrage ne fonctionne pas.

Étape 5 : Vérifier que les outils sont disponibles

Après le redémarrage, vérifiez que l'IA de Cursor voit bien les outils MCP Corcava :

Invite de vérification

Dans le chat de Cursor, demandez :

"Quels outils MCP Corcava sont disponibles ?"

Réponse attendue :

L'IA doit lister des outils comme :

list_tasks
get_task
create_task
update_task
list_projects
start_time_tracking
Et d'autres…

Étape 6 : Premier workflow de test

Essayez ces workflows pour tester la connexion :

1. Lister les tâches

Invite :

"What tasks do I have in Corcava?"

Attendu : L'IA liste vos tâches ou indique qu'il n'y en a pas.

2. Ouvrir une tâche

Invite :

"Show me details for the [task name] task"

Attendu : L'IA récupère et affiche les détails de la tâche (description, statut, commentaires).

3. Ajouter un commentaire d'avancement

Invite :

"Add a comment to task [task name] that says 'API changes completed, ready for review'"

Attendu : L'IA ajoute le commentaire à la tâche.

Note : C'est une opération d'écriture. L'IA peut demander confirmation avant d'ajouter le commentaire.

Workflows centrés sur l'IDE

L'intégration de Cursor avec Corcava permet des workflows IDE puissants :

Lier le code aux tâches

Reliez vos changements de code aux tâches Corcava :

"I'm working on the login feature task. Help me implement it and then add a comment when done."

Contexte de tâche dans l'éditeur

Obtenez les critères d'acceptation pendant que vous codez :

"What are the acceptance criteria for the dashboard task?"

Mises à jour d'avancement

Enregistrez l'avancement directement depuis votre éditeur :

"Update the API refactor task status to in progress and add a comment about the changes I made."

Dépannage

❌ Échec de connexion ou d'authentification

Causes possibles :

Clé API invalide ou format du header incorrect
Clé API révoquée
Problème de connectivité réseau

Solution :

Vérifiez que la clé API est active dans Corcava → Paramètres → Intégrations
Vérifiez le format du header : "Authorization": "Bearer YOUR_API_KEY"
Assurez-vous qu'il y a un espace après « Bearer »
Essayez de régénérer la clé API

Guide dépannage 401 →

Guide dépannage connexion →

❌ Modifications non prises en compte après édition de la config

Causes possibles :

Cursor n'a pas été complètement redémarré
Fichier de config au mauvais emplacement
Erreurs de syntaxe JSON

Solution :

Vérifiez que le fichier est bien ~/.cursor/mcp.json
Validez la syntaxe JSON
Quittez complètement Cursor et redémarrez-le (pas seulement recharger)
Consultez les logs Cursor pour les messages d'erreur

Dépannage rechargement Cursor →

❌ Les outils n'apparaissent pas

Causes possibles :

Échec de connexion au serveur MCP
Échec d'auth malgré une connexion établie
Problème de cache côté client

Solution :

Vérifiez d'abord la connexion et l'authentification
Essayez un redémarrage complet (pas seulement recharger)
Vérifiez que l'URL du endpoint est correcte

Guide dépannage liste d'outils →

Suite

Workflows Cursor

Planification hebdo, rapports de statut et suivi du temps depuis votre IDE

Workflows éditeur

Implémenter des tâches et enregistrer l'avancement dans Corcava

Connecter Cursor à Corcava

La gestion de projet directement dans votre IDE

Commencer l'essai gratuit → Workflows Cursor

Aucune carte bancaire requise