Guide pratique · Environ 5 minutes

Comment connecter Onplana à Claude Desktop

Cinq étapes. Générez un jeton, collez l’extrait de configuration, redémarrez Claude Desktop, vérifiez avec un appel d’outil. Environ 5 minutes au total.

Ensuite, vous pouvez demander à Claude 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 Claude fait le travail directement dans Onplana.

Ouvrir Onplana → Paramètres → Agents Télécharger Claude Desktop

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 Claude Desktop (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 de Claude Desktop

    Dans Claude Desktop, cliquez sur Settings → Developer → Edit Config. Cela ouvre claude_desktop_config.json dans votre éditeur par défaut. Sous macOS, il se trouve dans ~/Library/Application Support/Claude/claude_desktop_config.json ; sous Windows, dans %APPDATA%\Claude\claude_desktop_config.json. Si le fichier est vide ou absent, créez-le avec `{}`.

  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 copié à l’étape 1. Enregistrez le fichier.

  4. 4

    Redémarrer Claude Desktop

    Quittez complètement Claude Desktop (Cmd+Q sous macOS, fermeture complète sous Windows), puis rouvrez-le. L’outil Onplana devrait apparaître dans le sélecteur d’outils.

  5. 5

    Vérifier la connexion

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

claude_desktop_config.json

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

Comment vérifier que ça fonctionne

Ouvrez une nouvelle conversation dans Claude Desktop 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. »

Claude affiche l’appel d’outil dans la conversation 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.

OAuth est-il possible à la place du jeton ?

Oui. Onplana figure dans le répertoire Connectors de Claude : dans Claude Desktop (ou sur claude.ai), ouvrez Settings, trouvez Connectors, parcourez le répertoire, choisissez Onplana et approuvez la connexion dans le navigateur, sans rien coller. En dessous, c’est OAuth 2.1 avec PKCE, et Onplana publie des métadonnées de découverte selon les RFC 9728 et RFC 8414 sur https://mcp.onplana.com/.well-known/oauth-protected-resource et oauth-authorization-server. Le parcours avec jeton collé décrit ici sert quand vous voulez le fichier de configuration ; OAuth convient à qui préfère ne pas gérer de jetons de longue durée.

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

346 outils : lecture (par ex. list_projects, get_project, list_tasks, list_my_tasks, list_overdue, list_risks, search_org_knowledge, summarize_project, analyze_project_risks, generate_status_report), écriture (par ex. create_project, create_task, update_task, assign_task, create_milestone, create_comment, bulk_update_tasks, create_sprint_with_tasks, submit_timesheet, link_dependency, move_task_to_sprint) et l’ensemble des domaines gouvernance, maîtrise des changements, conformité, documents et workflows. Le forfait ouvre certains outils ; le catalogue complet est sur onplana.com/mcp.

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

Puis-je utiliser Claude Code (CLI) au lieu de Claude Desktop ?

Oui. Claude Code intègre la prise en charge de MCP. Installation en une ligne : `claude mcp add onplana --transport http https://mcp.onplana.com/mcp`. Claude Code lance OAuth au premier appel d’outil (aucun jeton à coller), ouvre un navigateur pour vous connecter à Onplana et mène le consentement ; ensuite, toute session `claude` dans ce projet voit le catalogue d’outils Onplana. Pour utiliser un jeton plutôt qu’OAuth, ajoutez `--header "Authorization: Bearer pat_…"` à la commande. Vérifiez avec `claude mcp list`. Fonctionne sous macOS, Linux et WSL sous Windows.

Où révoquer la connexion ?

Dans Onplana, Paramètres → Agents → Connexions liste chaque connexion, jetons d’accès personnels comme connexions par navigateur : choisissez Révoquer sur la ligne. C’est immédiat ; le prochain appel d’outil de Claude renvoie 401 et Claude vous invite à vous reconnecter.

Que se passe-t-il si mon jeton fuit ?

Révoquez-le immédiatement (voir ci-dessus) et générez-en un nouveau dans le même panneau. Le jeton compromis cesse de fonctionner dès son prochain appel. À partir du forfait Enterprise, un propriétaire ou un administrateur de l’organisation voit chaque appel du jeton divulgué sur la page Audit Logs, sous Agent Activity, pour vérifier ce que l’attaquant a pu voir ou modifier.

Est-ce que ça fonctionne sous Linux ?

Claude Desktop n’existe pour l’instant que pour macOS et Windows. Sous Linux, utilisez un autre client MCP comme le MCP Inspector officiel (npx @modelcontextprotocol/inspector) ou Cursor (compatible Linux), ou intégrez la connexion Onplana dans un script d’agent local avec le SDK client TypeScript typé d’Onplana.

À lire aussi