Wroket
← Tous les guides

Guide agents MCP

Wroket expose un serveur MCP distant : vos agents (Cursor, Claude Desktop…) listent et créent des tâches, projets, notes et créneaux — sans IA hébergée dans Wroket.

Dernière mise à jour : 2026-08-09

Pourquoi l'utiliser

  • Utilisez l’IA que vous payez déjà ; Wroket fournit les actions PMO sécurisées.
  • Clés API personnelles (`wrk_live_…`), scopes todos / projets / notes / calendrier, révocation immédiate.
  • Même logique métier que l’app (move, conflits de créneau, droits).

Prérequis

  • Compte Wroket avec accès produit (pas uniquement workspace-admin).
  • Client MCP compatible (Cursor, Claude Desktop, ou autre).

Étapes

  1. 1.Créer une clé API

    Paramètres › Intégrations › Connecter votre agent. Donnez un libellé (ex. « Cursor laptop »), créez la clé, puis copiez le secret immédiatement — il n’est plus réaffiché.

    Limites : Free = 1 clé active ; Small teams ou supérieur = jusqu’à 5. Seul le hash SHA-256 est stocké côté serveur.

  2. 2.Configurer Cursor ou Claude

    Endpoint production : `https://api.wroket.com/mcp`. Dans `mcp.json` (Cursor) ou la config MCP Claude, ajoutez le serveur avec l’en-tête `Authorization: Bearer wrk_live_…`. Un snippet prêt à coller apparaît dans Paramètres après création de la clé.

  3. 3.Outils disponibles

    Tâches : list / get / create / update / move. Projets & phases : list / get. Notes : list / get / create / update. Commentaires : list / add. Agenda : propose_slots, book_task_slot, clear_task_slot.

    En cas de conflit de créneau, `book_task_slot` renvoie un conflit structuré ; réessayez avec `force=true` (comme dans l’Agenda) ou choisissez un autre créneau.

  4. 4.Limites et hors périmètre

    Rate limit : 60 requêtes / minute / clé. Hors périmètre actuel : chat intégré Wroket, pièces jointes, sync Notion/Monday, billing/admin. Révoquez une clé dès qu’elle n’est plus utile.

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ême règles que l’UI).
Connecter votre agent