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