# Envelopper les serveurs MCP

> tokenade mcp-wrap fait passer vos serveurs MCP tiers par Tokenade, qui compacte leurs résultats d'outils et réduit les grandes captures d'écran.

Source: https://tokenade.net/fr/docs/mcp-wrap · Updated: 2026-10-07

`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

```text
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`](https://tokenade.net/fr/docs/compaction). 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](https://tokenade.net/fr/docs/compaction) 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.

```bash
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](https://tokenade.net/fr/docs/claude-code).

## report

```text
$ 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`](https://tokenade.net/fr/docs/gain-dashboard-receipt).

## Vérifier et annuler

```bash
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

- [Récupérer une sortie repliée](https://tokenade.net/fr/docs/expand-ref-disclose)
- [Le proxy LLM](https://tokenade.net/fr/docs/llm-proxy)
- [Comment les hooks interceptent les appels d'outils](https://tokenade.net/fr/docs/hooks)
- [Commandes de maintenance](https://tokenade.net/fr/docs/maintenance)
