Guides · Tokens de Figma MCP
Pourquoi le serveur MCP de Figma consomme autant de tokens, et comment réduire
Mis à jour le
Le serveur MCP de Figma coûte des tokens à deux endroits. En lecture, un seul appel à
get_design_context peut renvoyer des centaines de milliers de tokens. En
écriture, l’agent écrit du code pour l’API Plugin de Figma, et ce sont des tokens de
sortie, les plus chers. Voici les chiffres publiés par Figma et ses utilisateurs, ceux
que nous avons mesurés, et ce qui les fait vraiment baisser.
En lecture : un seul appel peut dépasser le contexte
get_design_context renvoie une sélection sous forme de code, « React et
Tailwind par défaut » selon Figma, avec les styles et les ressources. Sur un grand cadre,
la réponse est énorme. La page de dépannage de Figma cite elle-même l’erreur que Claude
Code affiche dans ce cas :
Error: MCP tool "get_design_context" response (351378 tokens) exceeds maximum allowed tokens (25000).
C’est 14 fois les 25 000 tokens que Claude Code accepte par défaut d’un appel d’outil. Des
utilisateurs rapportent plus : sur le forum de Figma, l’un a mesuré environ
960 000 tokens pour un seul composant via get_design_context, là où
l’interface de Figma en estimait environ 67 000 pour le même composant (décembre 2025). Un
autre voit l’appel échouer dès qu’un conteneur atteint six instances (novembre 2025).
Quand la réponse est trop grosse, le serveur peut se rabattre sur un plan allégé et
demander à l’agent de rappeler l’outil sur chaque sous-calque : plus d’appels, qui
s’ajoutent chacun au contexte.
Figma le dit sans détour : « Les cadres volumineux et très imbriqués peuvent submerger votre agent, le ralentir ou échouer sans erreur. »
En écriture : l’agent écrit du code pour dessiner des calques
Depuis mars 2026, l’outil use_figma permet à un agent de créer et modifier
des calques dans un fichier Figma. Il le fait en écrivant du JavaScript pour l’API Plugin
de Figma : cadres, auto-layout, textes et remplissages, propriété par propriété. Ce code
est de la sortie, et les tokens de sortie sont les plus chers au prix de l’API.
Nous l’avons mesuré dans notre benchmark du 12 novembre 2026 : Claude Code a reproduit trois écrans de Wikipedia en design modifiable, trois runs par écran, une fois avec le serveur MCP de Figma, une fois avec celui de Saymock. Moyennes par run, tirées des 18 transcriptions :
| Par run | Figma MCP | Saymock |
|---|---|---|
| Design écrit par l’agent | 48 300 caractères de code API Plugin (10,6 appels à use_figma) | 22 000 caractères de HTML + Tailwind (create_frame, edit_html, update_nodes) |
| Tokens de sortie par écran (médiane) | 61 000 | 30 000 |
| Tokens traités par écran (médiane) | 2,74 M | 1,88 M |
| Coût par écran, prix de l’API | 2,69 $ | 1,70 $ |
Qualité : égalité, 82,2 pour Figma et 79,0 pour Saymock sur 100, sous le seuil de 5 points du protocole. L’écart vient du format que l’agent écrit, pas de l’agent.
Pourquoi la facture grossit plus vite que la sortie
Un agent relit tout son contexte à chaque tour. Un résultat d’outil de 40 000 tokens ou 5 000 tokens de code écrits en début de session sont relus à chacun des 30 ou 40 tours suivants. C’est pourquoi les « tokens traités » se comptent en millions pour un seul écran, et pourquoi une grosse réponse coûte bien plus que sa propre taille : on la paie à chaque tour suivant (l’entrée en cache coûte moins cher, pas rien).
Consommer moins avec le serveur MCP de Figma
-
Lire le plan d’abord.
get_metadatarenvoie « un plan XML léger » : ids, noms, types, positions et tailles des calques ; n’appelez ensuiteget_design_contextque sur les parties utiles. Figma le recommande « pour les très grands designs ». - Sélectionner moins. Le conseil de Figma : générer le code par petites sections ou composant par composant, une carte, un en-tête, une barre latérale.
- Configurer Code Connect. Quand les composants Figma sont reliés à vos composants de code, le serveur renvoie la correspondance au lieu de régénérer le code. Figma a mesuré 29,5 % de tokens en moins et des tâches 19,6 % plus courtes en médiane, sur 27 cas de test (août 2026).
-
Relever la limite n’est pas une économie.
MAX_MCP_OUTPUT_TOKENSpermet à Claude Code d’accepter de plus grosses réponses ; elles restent aussi grosses, et restent dans le contexte. - Repartir d’une session neuve. Un écran par session évite de relire les réponses précédentes à chaque tour.
Ou changer ce que l’agent écrit
L’autre levier, c’est le format. Les écrans Saymock sont du HTML avec des classes
Tailwind, un format que les modèles écrivent déjà bien : un écran tient en un appel à
create_frame, les lignes répétées s’écrivent une fois en template avec des
données, et chaque élément garde un data-id, si bien qu’un changement est une
petite retouche, pas une réécriture. La lecture est légère pour la même raison :
get_file donne le plan du board sans HTML, find_nodes renvoie
des ids, une ligne chacun.
Ce n’est pas un remplaçant pour tous les usages de Figma. Si vos designs vivent dans Figma et que l’agent doit les lire pour écrire du code, c’est le serveur de Figma qui les lit, et les étapes ci-dessus le rendent moins cher. Quand c’est l’agent qui produit le design, la comparaison est ici : Saymock face à Figma MCP.
Questions fréquentes
Combien de tokens consomme get_design_context ?
Cela dépend de la sélection. L’exemple d’erreur donné par Figma montre 351 378 tokens pour un appel, et un utilisateur a mesuré environ 960 000 tokens pour un composant. Sélectionner une partie plus petite, ou lire get_metadata d’abord, permet de rester sous la limite du client.
Pourquoi Claude Code refuse-t-il les réponses de Figma MCP ?
Claude Code accepte par défaut 25 000 tokens par réponse d’outil. Une réponse de get_design_context plus grosse est refusée ; MAX_MCP_OUTPUT_TOKENS relève la limite mais ne réduit pas la réponse.
Code Connect réduit-il les tokens ?
Oui, selon Figma : sur 27 cas de test, la consommation médiane de tokens baisse de 29,5 % et la durée médiane des tâches de 19,6 % avec les correspondances Code Connect.
Écrire dans Figma avec use_figma coûte-t-il cher ?
Dans notre benchmark, l’agent a écrit environ 48 000 caractères de code API Plugin par run avec use_figma, contre environ 22 000 caractères de HTML avec Saymock, et a utilisé deux fois plus de tokens de sortie par écran.
Sources
- Figma, Tools and prompts, Avoid large frames et MCP server FAQs (consultés le 18 novembre 2026, en anglais).
- Blog de Figma, Agents, meet the Figma canvas (24 mars 2026) et Better code, fewer tokens (5 août 2026).
- Forum de Figma, environ 960 000 tokens pour un composant (9 décembre 2025) et get_design_context qui échoue sur un conteneur qui grandit (novembre 2025).
- Saymock, benchmark face à Figma MCP (12 novembre 2026) : protocole et 18 runs ; chiffres par outil tirés des transcriptions des runs.