Guide pratique · Environ 5 minutes

Comment connecter Onplana à Cursor

Cinq étapes. Générez un jeton, collez l’extrait mcpServers, rechargez Cursor, vérifiez avec un appel d’outil. Environ 5 minutes.

Ensuite, vous pouvez demander à l’Agent de Cursor par exemple « crée un plan de projet pour le lancement du Q3 avec des jalons hebdomadaires » ou « résume les risques de la semaine sur tous les projets actifs », et Cursor fait le travail directement dans Onplana sans quitter l’éditeur.

Ouvrir Onplana → Paramètres → Agents Documentation MCP de Cursor

Les cinq étapes

  1. 1

    Générer un jeton de connexion Onplana

    Connectez-vous à Onplana sur app.onplana.com. Allez dans Paramètres → Agents → Connecter un agent, choisissez la tuile Cursor (ou Custom MCP client), puis Jeton d’accès personnel et enfin Générer le jeton + afficher l’extrait de connexion. Copiez le jeton d’accès personnel (il commence par pat_). Le jeton n’a que la portée MCP_AGENT : il peut appeler des outils MCP, mais pas créer d’autres jetons, modifier la facturation ni toucher quoi que ce soit hors de la surface MCP.

  2. 2

    Ouvrir les réglages MCP de Cursor

    Dans Cursor, ouvrez Settings (Cmd+Maj+J sous macOS, Ctrl+Maj+J sous Windows ou Linux), allez dans Tools & MCP et choisissez New MCP Server. Cursor lit aussi directement une configuration JSON : pour le projet dans .cursor/mcp.json à la racine de votre dépôt, ou globale dans ~/.cursor/mcp.json. Modifier le JSON donne le même résultat que l’interface.

  3. 3

    Coller la configuration du serveur MCP Onplana

    Ajoutez une entrée "onplana" sous la clé "mcpServers". La configuration complète : {"mcpServers": {"onplana": {"url": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}. Remplacez pat_paste-your-token-here par le jeton de l’étape 1. Enregistrez le fichier.

  4. 4

    Recharger Cursor

    Rechargez la fenêtre de Cursor (Cmd+Maj+P ou Ctrl+Maj+P, puis "Reload Window"), ou désactivez puis réactivez le serveur onplana dans Settings, puis Tools & MCP. Les outils Onplana apparaissent dans la liste d’outils de l’Agent avec un point d’état vert dès que la négociation réussit.

  5. 5

    Vérifier la connexion

    Dans le chat de l’Agent de Cursor, demandez : « liste mes projets Onplana ». Cursor appelle l’outil list_projects d’Onplana et affiche le résultat. En cas d’erreur, revérifiez le jeton et assurez-vous que le fichier de configuration est un JSON valide.

.cursor/mcp.json (projet) ou ~/.cursor/mcp.json (global)

{
  "mcpServers": {
    "onplana": {
      "url": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      }
    }
  }
}

Comment vérifier que ça fonctionne

Ouvrez le chat de l’Agent de Cursor et essayez l’une de ces demandes :

  • « Liste mes projets Onplana. »
  • « Qu’est-ce qui est en retard dans mon compte Onplana ? »
  • « Crée une tâche Onplana dans le projet X appelée ‘Migrer Postgres vers Aurora’. »
  • « Génère un rapport d’avancement pour le projet Y. »

Cursor affiche l’appel d’outil avant de l’exécuter, vous voyez donc quelles données sont lues ou écrites. Les modifications s’appliquent sur tous les forfaits ; sur Free, certaines actions d’écriture ont un plafond mensuel (aucun à partir du forfait Professional), et l’agent peut demander un aperçu qui n’enregistre rien grâce à son option dryRun.

Questions fréquentes

Quel forfait Onplana inclut MCP ?

MCP est inclus sur tous les forfaits, y compris le forfait gratuit. Le nombre de connexions d’agents simultanées augmente avec le forfait (Free 2, Professional 3, Business 5, Enterprise 10, Enterprise+ illimité), et votre solde de jetons IA (une allocation mensuelle sur les forfaits payants, un bonus unique sur Free, plus le crédit acheté) est ce qui borne l’usage réel de l’IA. Vous changez de forfait à tout moment sur app.onplana.com/billing.

La prise en charge de MCP dans Cursor est-elle stable ?

Oui, MCP est une fonction livrée dans Cursor et non plus un aperçu. La connexion Onplana est rattachée au fournisseur CURSOR et reçoit l’ensemble des outils de lecture, de création et de mise à jour. Les réglages de Cursor peuvent tout de même bouger d’une version à l’autre ; dans ce cas, retrouvez leur emplacement actuel sur docs.cursor.com et gardez la même entrée de serveur onplana.

Configuration du projet ou globale ?

Au choix. .cursor/mcp.json à la racine d’un dépôt limite la connexion à ce projet (pratique quand différents dépôts correspondent à différentes organisations Onplana avec des jetons distincts). ~/.cursor/mcp.json applique la connexion à toutes les fenêtres de Cursor. Si les deux définissent un serveur "onplana", celle du projet l’emporte.

À quels outils Cursor a-t-il accès ?

Au même catalogue de 346 outils que voit tout client MCP : lecture (list_projects, get_project, list_tasks, list_my_tasks, list_overdue, list_risks, search_org_knowledge, summarize_project, generate_status_report), écriture (create_project, create_task, update_task, assign_task, create_milestone, create_comment, bulk_update_tasks, create_sprint_with_tasks, link_dependency) et les domaines gouvernance, maîtrise des changements, conformité, documents et workflows. Le forfait ouvre certains outils ; le catalogue complet est sur onplana.com/mcp.

Cursor peut-il supprimer des projets ou des tâches via MCP ?

Oui, de façon récupérable, sauf si un administrateur l’a désactivé. Les outils de suppression via MCP sont : supprimer une tâche, un projet, une liste ou un document. Chacun est un interrupteur par espace de travail, activé jusqu’à ce qu’un administrateur enregistre un choix, et l’appelant a toujours besoin de la permission qu’il lui faudrait de toute façon. Tous suppriment de façon réversible vers la corbeille, et une tâche ou un projet supprimé est conservé avec toute son arborescence et restauré sous ses identifiants d’origine, si bien que les dépendances et la hiérarchie survivent. Les sprints, jalons, epics et objectifs n’ont aucun outil de suppression via MCP.

OAuth est-il possible au lieu de coller un jeton ?

Onplana publie des métadonnées de découverte OAuth 2.1 (RFC 9728 et RFC 8414) sur mcp.onplana.com/.well-known/. Que Cursor les utilise automatiquement dépend de la prise en charge de l’authentification MCP par votre version de Cursor ; le parcours avec le jeton dans l’en-tête décrit ici fonctionne sur toutes les versions qui acceptent les serveurs MCP distants.

Où révoquer la connexion ?

Dans Onplana, Paramètres, puis Agents, puis Connexions, et Révoquer sur la ligne du jeton. C’est immédiat ; le prochain appel d’outil de Cursor renvoie 401. À partir du forfait Enterprise, un propriétaire ou un administrateur de l’organisation voit chaque appel du jeton sur la page Audit Logs, sous Agent Activity.

À lire aussi