Brancher votre agent IA

Donnez à Cursor ou Claude Code l'accès aux diagnostics Wakoo via MCP, avec un jeton d'accès personnel que vous contrôlez.

Votre agent IA est très bon pour écrire le correctif. Wakoo lui donne la cause, avec la preuve, toujours la même, puis vérifie que le correctif a tenu. Les deux se rejoignent via le serveur MCP de Wakoo.

Ce que l'agent peut et ne peut pas faire

Il lit les diagnostics : causes, preuves, correctifs classés.
Avec le droit follows:write, il peut créer ou modifier des suivis (des correctifs que Wakoo revérifie).
Il ne peut jamais lancer un correctif sur votre base via Wakoo. Wakoo est en lecture seule sur vos bases, toujours. Si l'agent applique un correctif, il le fait avec ses propres accès, après votre confirmation.

Jetons d'accès personnels

L'agent s'authentifie avec un jeton d'accès personnel. Créez-le dans Compte, Jetons d'accès et MCP.

Réglage	Options
Espace de travail	Le jeton ne fonctionne que sur un espace de travail
Droits	`read` (diagnostics) ou `follows:write` (inclut `read`)
Expiration	30 jours, 90 jours (par défaut), 1 an, ou jamais

Bon à savoir :

Les jetons commencent par wk_pat_. La valeur complète n'est affichée qu'une fois, à la création. Wakoo n'en garde qu'une empreinte (hash).
Vous recevez un e-mail à chaque création de jeton sur votre compte (nom et préfixe seulement).
Révoquez un jeton à tout moment depuis la même page. Les jetons sont aussi révoqués automatiquement quand vous quittez l'espace de travail ou en êtes retiré, ou quand l'espace est supprimé.
Un jeton ne peut pas servir à créer un autre jeton.
Limites : 50 jetons actifs par personne, 10 nouveaux jetons par heure.

Le préfixe wk_pat_ et la longueur fixe permettent aux scanners de secrets de repérer facilement un jeton qui aurait fuité.

Enregistrez le jeton une fois

Pour que le jeton n'apparaisse ni à l'écran ni dans l'historique du shell, gardez-le dans une variable d'environnement. Lancez ceci, puis collez le jeton quand il est demandé :

read -rs WAKOO_TOKEN && export WAKOO_TOKEN

Claude Code

Ajoutez Wakoo une fois :

claude mcp add --transport http wakoo https://mcp.wakoo.ai/mcp --header "Authorization: Bearer $WAKOO_TOKEN"

Cursor

Ajoutez Wakoo au fichier .cursor/mcp.json du projet :

{
  "mcpServers": {
    "wakoo": {
      "url": "https://mcp.wakoo.ai/mcp",
      "headers": { "Authorization": "Bearer ${env:WAKOO_TOKEN}" }
    }
  }
}

Le jeton reste hors du fichier : le fichier peut aller dans git. Cursor lit la variable du terminal depuis lequel il démarre : ouvrez Cursor depuis ce même terminal, par exemple avec cursor ..

La CLI

La CLI wakoo n'a pas besoin d'un jeton copié à la main : wakoo login obtient le sien. Voir Installer le client.

Plus tard

La connexion au serveur MCP sans coller de jeton (OAuth) est prévue. Les jetons d'accès personnels continueront de fonctionner.