← Tous les guides

Connecter un agent (MCP)

Laissez Cursor ou Claude Desktop agir sur vos tâches et projets Wroket. Pas d’IA hébergée dans Wroket : vous branchez l’agent que vous utilisez déjà.

Dernière mise à jour : 2026-11-14

Pourquoi l'utiliser

  • 4 étapes : créer une clé, copier le secret, coller le snippet, tester « liste mes tâches ».
  • Clés personnelles (`wrk_live_…`), révocation immédiate, une clé par machine.
  • Mêmes droits et règles que l’app (projets, créneaux, conflits).
  • Complète Assist in-app : l’agent externe pour le quotidien, Assist pour comité / semaine / risques dans Wroket.

Prérequis

  • Compte Wroket avec accès produit (pas uniquement admin d’espace).
  • Client MCP compatible : Cursor, Claude Desktop, ou équivalent.

Étapes

  1. 1.1. Créer une clé

    Paramètres › Intégrations › Connecter votre agent. Libellé clair (ex. « Cursor laptop »), créez la clé, puis copiez le secret tout de suite — il n’est plus réaffiché.

    Limites : Free = 1 clé active ; Small teams+ / early bird = jusqu’à 5. Ne committez jamais le secret dans Git.

  2. 2.2. Coller le snippet MCP

    Endpoint production : `https://api.wroket.com/mcp`. Après création, Paramètres affiche un snippet prêt à coller (Cursor `mcp.json` ou config Claude) avec `Authorization: Bearer wrk_live_…`.

    Redémarrez ou rechargez le client MCP si les outils n’apparaissent pas tout de suite.

  3. 3.3. Tester avec l’agent

    Demandez par exemple : « liste mes tâches actives », « santé du projet X », « propose un créneau pour cette tâche », « résume ma semaine ».

    Prompts MCP intégrés utiles : `/plan-my-week`, `/prepare-steering-committee`, `/triage-overdue` (selon le client).

  4. 4.Ce que l’agent peut faire

    MCP v2 : tâches (CRUD, move, templates), projets / phases / jalons, notes & commentaires, agenda (proposer / réserver / réunion), digests PMO, équipes & assignations, timer / temps, OKR, bases & contacts, liens de partage et portails.

    Conflit de créneau : l’outil renvoie un conflit structuré — comme dans l’Agenda, réessayez avec force ou un autre créneau.

  5. 5.Assist in-app vs MCP

    Assist (Dashboard / projet) : commandes déterministes (comité, planifie ma semaine, risques) avec confirmation dans l’UI — sans LLM hébergé.

    MCP : votre agent externe pilote Wroket au quotidien. Les deux coexistent ; choisissez selon le contexte.

  6. 6.Sécurité et limites

    Rate limit 60 req/min/clé. Révoquez une clé dès qu’elle n’est plus utile. Hors périmètre : chat génératif hébergé Wroket, pièces jointes, sync Notion/Monday, billing/admin via MCP.

Dépannage

L’agent reçoit 401
Clé révoquée, mal collée, ou Bearer manquant. Recréez une clé dans Paramètres et mettez à jour la config MCP.
Outil refusé (scope / droits)
Les nouvelles clés ont tous les scopes par défaut. Vérifiez aussi les droits Wroket sur la tâche ou le projet (mêmes règles que l’UI).
Aucun outil Wroket dans le client
Vérifiez l’URL `https://api.wroket.com/mcp`, le header Authorization, puis rechargez MCP / redémarrez le client. Le snippet dans Paramètres est la source de vérité.