tokenade
GitHubenfr
Installer

Envelopper les serveurs MCP

Mis à jour le

TL;DR — tokenade install enveloppe automatiquement vos serveurs MCP tiers. tokenade mcp-wrap install [<server>] le fait à la main, mcp-wrap report montre les économies par outil, et tokenade unwrap-mcps restaure les originaux. Les résultats d'outils sont compactés (avec des compacteurs dédiés pour les serveurs GitHub, base de données, système de fichiers et navigateur) ; ce qui dépasse encore 25k tokens environ est rangé dans le stash et remplacé par un résumé.

tokenade mcp-wrap place Tokenade entre votre agent et chaque serveur MCP tiers. Le serveur fonctionne exactement comme avant ; Tokenade compacte les résultats d'outils qu'il renvoie et réduit les captures d'écran plus grandes que nécessaire. Tous les outils restent disponibles : l'enveloppe change ce que coûtent les résultats, pas les outils que voit l'agent. tokenade install le met en place pour chaque agent qu'il configure ; vous aurez donc rarement à le lancer vous-même.

Utilisation

tokenade mcp-wrap install [<server>] # route configured MCP server(s) through the proxy (no name = all)
tokenade mcp-wrap uninstall [<server>] # restore original launch command (no name / --all = every wrapped)
tokenade mcp-wrap report # per-tool savings table (+ real $)
tokenade mcp-wrap -- <bin> [<args>…] # run as the proxy (agents do this)
tokenade mcp-wrap <bin> [<args>…] # leading `--` is optional

Alias : mcp_wrap, mcp-proxy, mcp_proxy. mcp-proxy est l'ancien nom, conservé parce que des configurations existantes le lancent encore.

Ce qui arrive à un appel d'outil

  1. Votre agent lance tokenade mcp-wrap -- <commande d'origine> au lieu du serveur.
  2. Tokenade démarre le vrai serveur et lui relaie les requêtes sans modification.
  3. Chaque élément texte d'un résultat d'outil est compacté. Les serveurs connus ont un compacteur dédié, choisi d'après le nom que le serveur se donne : les réponses des API GitHub et GitLab perdent leurs URL et métadonnées superflues, les résultats de requêtes en base deviennent des lignes compactes, le directory_tree du serveur de fichiers devient une arborescence indentée, et les serveurs de navigateur (Playwright, Chrome) voient leurs journaux de console et le contenu des pages repliés. Le reste passe par le même compacteur à détection automatique que tokenade read. Les résultats de capture d'écran sont laissés tels quels.
  4. Un résultat qui dépasse encore 25k tokens environ (le seuil des lectures de fichier, TOKENADE_READ_DISCLOSE_THRESHOLD, puisque votre agent a demandé ce contenu) est écrit dans le stash et remplacé par un résumé. L'agent peut creuser avec tokenade expand-ref <hash>. Les identifiants sont masqués dans chaque résultat.
  5. Les images dont le grand côté dépasse le plafond sont redimensionnées et réencodées. Le contenu n'est remplacé que s'il a réellement diminué, et un élément texte est ajouté pour indiquer la nouvelle taille et comment désactiver la réduction.

Un proxy tourne par serveur et par session d'agent ; il s'arrête quand l'agent ferme son entrée standard.

Pour garder les captures en pleine résolution, définissez TOKENADE_IMAGE_MAX_EDGE=0 dans l'environnement du serveur enveloppé.

La liste des outils

La réponse tools/list du serveur passe avec tous ses outils. Tokenade retire seulement de chaque schéma d'entrée les mots-clés inertes (title, $comment, examples, markdownDescription), qui n'apprennent jamais à l'agent comment appeler un outil. Les champs description des paramètres sont conservés par défaut, car environ un sur cinq énonce une contrainte que rien d'autre dans le schéma n'exprime. Définissez TOKENADE_MCP_LEAN_SCHEMA=1 pour les retirer aussi : la liste d'outils devient bien plus courte, à ce risque près.

Tokenade ne charge pas les outils à la demande : l'agent voit les mêmes outils que sans l'enveloppe. Les agents qui diffèrent eux-mêmes le chargement des définitions d'outils (la recherche d'outils de Claude Code, par exemple) continuent de le faire.

install et uninstall

install et uninstall modifient sur place la configuration MCP de vos agents : Claude, Cursor, Codex, Copilot, Windsurf, Cline et VS Code, avec les chemins Linux, macOS et Windows. Ils écrivent d'abord une copie .bak horodatée, réécrivent de façon atomique, et sont idempotents et entièrement réversibles.

tokenade mcp-wrap install # wrap every configured third-party server
tokenade mcp-wrap install github # wrap one server by name
tokenade mcp-wrap uninstall github # restore that one

Les serveurs qui font partie de l'installation d'une application (par exemple le serveur de navigation et de pilotage de l'ordinateur ajouté par l'app de bureau Codex) ne sont pas touchés, car l'application change leur chemin à chaque mise à jour.

Les économies des applications de bureau leur sont attribuées : chaque serveur enveloppé porte le nom de l'application, si bien que Claude Desktop, l'app Codex ou Cursor apparaissent sous leur propre nom dans le dashboard.

Claude Desktop, onglet Chat

Le Chat de Claude Desktop n'exécute ni commande locale ni lecture de fichier : l'optimisation MCP est la seule partie de Tokenade qui s'y applique. Lancez tokenade mcp-wrap install pour envelopper les serveurs de sa configuration. L'onglet Code de Claude Desktop, lui, est Claude Code et reçoit l'ensemble des hooks ; voir Claude Code.

report

$ tokenade mcp-wrap report
No wrapped-MCP tool activity recorded yet. Wrap a server with `tokenade mcp-wrap install <server>` and use it, then re-run.

Une fois les serveurs enveloppés utilisés, report affiche les économies par outil, valorisées aux mêmes tarifs par modèle que tokenade dashboard.

Vérifier et annuler

tokenade healthcheck # lists each wrapped entry and the original it wraps
tokenade unwrap-mcps --dry-run # show which configs would be restored
tokenade unwrap-mcps # flip every wrapped entry back

unwrap-mcps parcourt toutes les configurations d'agents connues et remet chaque entrée enveloppée sur son command et ses args d'origine. La commande est idempotente et laisse le reste de Tokenade (hooks, consignes, binaire) en place. tokenade uninstall exécute d'abord ce même passage, puis retire tout le reste.

Pour que tokenade install n'enveloppe pas les serveurs du tout, passez --no-wrap-mcps.

Pièges

  • healthcheck signale les entrées enveloppées qui pointent vers un ancien chemin du binaire (wrapped_mcps). Relancez tokenade install ou tokenade mcp-wrap install pour les corriger.
  • Les gros résultats sont remplacés par un résumé et un hash, pas supprimés. Si votre agent a besoin d'un détail, il interroge le stash avec expand-ref.
  • Sur Claude Code, les résultats MCP sont aussi repliés par un hook PostToolUse, que vous pouvez désactiver avec TOKENADE_NO_MCP_HOOK=1.

Voir aussi