Guide pratique · Environ 5 minutes

Comment connecter Onplana à Windsurf

Cinq étapes. Générez un jeton, collez l’extrait mcpServers (Windsurf utilise serverUrl), actualisez Cascade, vérifiez avec un appel d’outil. Environ 5 minutes.

Ensuite, vous pouvez demander à Cascade 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 Windsurf fait le travail directement dans Onplana sans quitter l’éditeur.

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

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 Windsurf (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 la configuration MCP de Windsurf Cascade

    Dans Windsurf, ouvrez le panneau Plugins (MCP) et choisissez "View raw config". Cela ouvre mcp_config.json. Sous macOS et Linux, il se trouve dans ~/.codeium/windsurf/mcp_config.json ; sous Windows, dans le dossier .codeium\windsurf de votre profil utilisateur. Si le fichier est vide, commencez-le par {}.

  3. 3

    Coller la configuration du serveur MCP Onplana

    Ajoutez une entrée "onplana" sous la clé "mcpServers". La configuration complète : {"mcpServers": {"onplana": {"serverUrl": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}. Windsurf utilise la clé "serverUrl" pour les serveurs HTTP distants (et non "url"). Remplacez pat_paste-your-token-here par le jeton de l’étape 1, puis enregistrez.

  4. 4

    Actualiser Cascade

    Dans le panneau Plugins (MCP), cliquez sur "Refresh" (la flèche circulaire) pour que Cascade relise la configuration et effectue la négociation MCP. Le serveur onplana devrait afficher un état vert et un nombre d’outils disponibles. Cascade garde au plus 100 outils MCP actifs et Onplana en expose 346 : si des outils Onplana manquent, désactivez d’autres serveurs ou outils dont vous n’avez pas besoin.

  5. 5

    Vérifier la connexion

    Dans Cascade, demandez : « liste mes projets Onplana ». Windsurf appelle l’outil list_projects d’Onplana et affiche le résultat. En cas d’erreur, revérifiez le jeton, assurez-vous que la clé est "serverUrl" (et non "url") et que le JSON est valide.

~/.codeium/windsurf/mcp_config.json

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

Comment vérifier que ça fonctionne

Ouvrez Cascade 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. »

Cascade 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.

Pourquoi Windsurf utilise-t-il "serverUrl" au lieu de "url" ?

C’est le schéma de configuration de Windsurf pour les serveurs MCP distants en HTTP. Claude Desktop et Cursor utilisent "url" ; Windsurf Cascade utilise "serverUrl". Le reste de l’entrée (le nom du serveur onplana et l’en-tête Authorization) est identique. Utiliser "url" par erreur est la raison la plus courante pour laquelle une connexion Windsurf n’apparaît pas, sans message d’erreur.

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

Oui, MCP est une fonction livrée dans Windsurf et non plus un aperçu. La connexion Onplana est rattachée au fournisseur WINDSURF et reçoit l’ensemble des outils de lecture, de création et de mise à jour. Les réglages de Windsurf peuvent tout de même bouger d’une version à l’autre ; consultez alors docs.windsurf.com et gardez la même entrée de serveur onplana.

À quels outils Windsurf 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.

Windsurf 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.

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 Windsurf 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