Envelopper les serveurs MCP

tokenade mcp-wrap place Tokenade entre votre agent et chaque serveur MCP tiers. Le serveur fonctionne exactement comme avant ; Tokenade ne réécrit que les résultats d'outils trop volumineux et les captures d'écran plus grandes que nécessaire. 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

Votre agent lance tokenade mcp-wrap -- <commande d'origine> au lieu du serveur.
Tokenade démarre le vrai serveur et relaie les messages dans les deux sens, sans modification.
Tout résultat d'outil textuel de plus de 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 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é.

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.