« Figma MCP » désignait autrefois une seule chose : un serveur qui permettait à un agent de codage de lire une maquette et de la transformer en code. En 2026, cela signifie davantage. Le serveur officiel de Figma s'exécute désormais à distance aussi bien que dans l'application de bureau, il peut écrire sur le canevas, et les limites sur la fréquence à laquelle vous pouvez l'appeler dépendent de votre offre et de votre siège d'une manière qui surprend les gens après vingt appels.
Ce guide est construit à partir de la documentation développeur de Figma, du Help Center et du blog, du dépôt figma/mcp-server-guide, et du code des projets communautaires, tous consultés le 14 novembre 2026. Nous avons également sondé le point de terminaison distant et exécuté Framelink via MCP Inspector. Nous n'avons pas connecté de compte Figma payant, nous rapportons donc les limites annoncées par Figma plutôt que celles que nous aurions atteintes.
Serveur distant ou serveur de bureau
| Serveur distant | Serveur de bureau | |
|---|---|---|
| Adresse | https://mcp.figma.com/mcp |
http://127.0.0.1:3845/mcp |
| Nécessite l'application Figma | Non | Oui, avec un fichier Design ouvert |
| Connexion | Compte Figma, OAuth dans le navigateur | L'application dans laquelle vous êtes connecté |
| Offres | Toutes les offres, avec des limites de lecture | Siège Dev ou Full sur Professional, Education, Organization, Government ou Enterprise |
| Choix de ce qu'il faut lire | Collez un lien vers un calque | Sélectionnez le calque dans l'application |
| Écriture sur le canevas | Oui, en bêta | Non |
| Xcode | Pris en charge | Non pris en charge |
| Figma for Government | Non pris en charge | La seule option |
Figma recommande le serveur distant et lui attribue « l'ensemble de fonctionnalités le plus large ». Le serveur de bureau existe pour les organisations ayant des besoins spécifiques ; Figma for Government, par exemple, ne peut utiliser que celui-ci. Sauf si vous faites partie de ce groupe, commencez par le serveur distant.
Nous avons vérifié comment le serveur distant se présente. Une requête nue est refusée, et ses métadonnées OAuth désignent api.figma.com comme serveur d'autorisation avec une seule portée, mcp:connect. C'est le flux que votre client exécute lorsqu'il ouvre un navigateur et vous demande d'autoriser l'accès.
Forfaits et limites
C'est de là que proviennent la plupart des signalements « ça ne marche plus ». Figma limite les outils qui lisent les données, par siège et par forfait :
| Siège | Starter | Professional | Organization | Enterprise |
|---|---|---|---|---|
| View ou Collab | 20 par mois | 20 par mois | 20 par mois | 20 par mois |
| Full ou Dev | non proposé | 200 par jour, 10 par minute | 200 par jour, 15 par minute | 600 par jour, 20 par minute |
Les forfaits Education bénéficient des chiffres de Professional. Le plafond par minute s'applique en plus de celui par jour, et Figma indique qu'il peut modifier les limites à tout moment. Les outils d'écriture ne sont pas comptés, pas plus que les actions qui consomment des crédits Figma AI.
Vingt appels par mois partent vite. Un agent qui implémente un seul écran appelle souvent le contexte de design, les variables, une capture d'écran et parfois les métadonnées ; un compte gratuit peut donc épuiser ses appels après quelques écrans. Si vous travaillez quotidiennement avec Figma, le serveur est en pratique une fonctionnalité réservée aux sièges Full ou Dev.
Un chiffre obsolète à ignorer : le README du dépôt mcp-server-guide de Figma indique encore six appels par mois pour les sièges Starter et View. La documentation développeur et le Help Center indiquent tous deux 20.
L'installer
Claude Code. Le plugin de Figma est disponible dans le marketplace officiel d'Anthropic et apporte le serveur ainsi que les skills de Figma :
claude plugin install figma@claude-plugins-official
Si votre organisation bloque les plugins, ajoutez uniquement le serveur :
claude mcp add --scope user --transport http figma https://mcp.figma.com/mcp
Ensuite, exécutez /mcp dans Claude Code, sélectionnez figma, choisissez Authenticate, puis cliquez sur Allow access dans le navigateur.
Cursor. Tapez /add-plugin figma dans le chat, ou ajoutez le serveur dans Settings, Tools & MCP :
{
"mcpServers": {
"figma": {
"url": "https://mcp.figma.com/mcp"
}
}
}
Cliquez sur Connect, puis autorisez l'accès. Si la connexion boucle, utilisez « Clear All MCP Tokens », reconnectez-vous et redémarrez Cursor.
VS Code avec GitHub Copilot. Exécutez « MCP: Open User Configuration » et ajoutez :
{
"servers": {
"figma": {
"type": "http",
"url": "https://mcp.figma.com/mcp"
}
}
}
Cliquez sur Start au-dessus de l'entrée, autorisez l'accès, passez le chat en mode Agent et tapez #get_design_context pour vérifier que les outils se chargent.
Codex :
codex mcp add figma --url https://mcp.figma.com/mcp
Gemini CLI l'installe comme extension depuis https://github.com/figma/mcp-server-guide, puis /mcp auth figma. Les pages de Figma ne donnent aucune étape pour Claude Desktop. Seuls les clients listés dans le catalogue MCP de Figma peuvent se connecter, alors vérifiez-le avant d'essayer un autre client.
Le serveur desktop, à la place : ouvrez l'application de bureau Figma, passez en Dev Mode avec Shift+D et, dans la barre latérale droite, choisissez « Enable desktop MCP server ». Pointez ensuite votre client vers http://127.0.0.1:3845/mcp, par exemple claude mcp add --transport http figma-desktop http://127.0.0.1:3845/mcp.
Ce que font les outils
La page des outils de Figma en liste une trentaine. Voici ceux que vous utiliserez :
| Outil | Où | Ce qu'il renvoie ou fait |
|---|---|---|
get_design_context |
Les deux | Le code et la structure d'un calque, en React avec Tailwind par défaut ; demandez une autre stack dans le prompt |
get_variable_defs |
Les deux | Les variables et styles utilisés par une sélection : couleurs, espacements, typographie |
get_screenshot |
Les deux | Une image de la sélection |
get_metadata |
Les deux | Un plan XML léger avec les ID, les noms et les tailles ; pratique pour les grands frames |
get_code_connect_map |
Les deux | Le composant de code auquel chaque composant Figma correspond |
get_figjam |
Les deux | Les tableaux FigJam en XML avec captures d'écran |
search_design_system |
Distant | Recherche des composants, variables et styles dans vos bibliothèques |
download_assets |
Distant | Exporte jusqu'à 20 nœuds ou images d'origine par appel |
whoami |
Distant | Votre compte, vos forfaits et vos types de siège |
use_figma |
Distant | Exécute du code Plugin API dans le fichier pour créer, modifier ou supprimer des calques |
generate_figma_design |
Distant | Transforme une page web en ligne, y compris localhost, en calques Figma |
create_new_file |
Distant | Un fichier Design, FigJam ou Slides vierge |
create_design_system_rules est un prompt, pas un outil : il écrit un fichier de règles pour votre base de code afin que l'agent associe les tokens Figma à vos composants de la même manière à chaque fois.
Si vous utilisez Code Connect, les composants connectés arrivent enveloppés dans un marqueur <CodeConnectSnippet> qui nomme votre vrai composant, et les instructions personnalisées que vous avez jointes sont incluses. C'est la différence entre un agent qui écrit un nouveau bouton et un agent qui utilise le vôtre.
Grands frames
Le conseil de Figma lui-même est de sélectionner moins. Les grandes sélections « ralentissent les outils, provoquent des erreurs ou renvoient des résultats incomplets ». Prenez une carte, un en-tête ou une barre latérale à la fois. Pour une page entière, appelez d'abord get_metadata pour obtenir le plan et les ID des nœuds, puis get_design_context sur les parties. Dans Claude Code, si les résultats sont tronqués, augmentez MAX_MCP_OUTPUT_TOKENS.
Écrire sur le canvas
Le 24 mars 2026, Figma a ouvert le canvas aux agents. L'outil use_figma du serveur distant exécute du code contre la Figma Plugin API au sein de votre fichier : un agent peut donc construire des frames, appliquer des variables, disposer des composants et modifier ce qui existe déjà, dans les fichiers Design, FigJam, Slides et Specs. Figma cite Claude Code, Codex, Cursor, Copilot dans VS Code et Copilot CLI parmi les clients présents au lancement.
Les règles de la bêta :
- Sièges. Écrire en dehors de vos propres brouillons nécessite un siège Full ; un siège Dev ne peut écrire que dans les brouillons. Vous avez besoin d'un accès en édition au fichier et d'un forfait Professional, Education, Organization ou Enterprise.
- Prix. Gratuit pendant la bêta. Figma indique que l'outil « deviendra à terme une fonctionnalité payante facturée à l'usage » et n'a pas communiqué de tarif.
- Limites. Pas de création d'images autonome, pas de composants contenant des images ou des vidéos, pas de GIF. Les polices doivent déjà être importées dans votre compte Figma. Les composants doivent être publiés manuellement avant que Code Connect puisse les associer.
- Qualité. Figma qualifie le résultat de qualité bêta et vous recommande de travailler sur une copie ou un brouillon et de conserver une sauvegarde.
Les autres outils d'écriture sont plus restreints. generate_figma_design capture une interface web en cours d'exécution, en production, en staging ou sur localhost, sous forme de calques modifiables, ce qui est utile pour importer un produit existant dans Figma. generate_diagram dessine des diagrammes FigJam à partir de texte ou de Mermaid. send_code_to_figma importe un projet local sous forme de fichier Figma Make.
Si use_figma n'apparaît pas dans votre liste d'outils, votre client utilise presque certainement le serveur desktop, qui ne dispose d'aucun outil d'écriture.
Serveurs communautaires
Avant que Figma ne publie son propre serveur, la communauté a comblé le vide, et deux projets restent largement utilisés.
Framelink (GLips/Figma-Context-MCP, MIT, 16 205 étoiles) lit un fichier via l'API REST de Figma avec un jeton d'accès personnel et simplifie la réponse avant que le modèle ne la voie. Nous avons exécuté la version 0.13.2 via MCP Inspector : il expose deux outils, get_figma_data, marqué en lecture seule, et download_figma_images. Avec une clé factice, l'appel a échoué avec isError à true et un lien de dépannage, ce qui est le comportement attendu pour des scripts. Il ne peut pas écrire et il est soumis aux limites de l'API REST ; une issue ouverte signale des erreurs 429. Sa configuration :
{
"mcpServers": {
"framelink": {
"command": "npx",
"args": ["-y", "figma-developer-mcp", "--figma-api-key=YOUR_KEY", "--stdio"]
}
}
}
TalkToFigma (grab/cursor-talk-to-figma-mcp, MIT, 7 108 étoiles) écrit via un plugin Figma connecté à un serveur WebSocket local. Il nécessite Bun, le plugin communautaire exécuté dans votre fichier, et un appel join_channel pour les appairer. Pas de jeton et pas de siège Dev, ce qui en a fait le moyen d'obtenir un accès en écriture avant l'existence de use_figma. Son dernier push date de juillet 2026.
Des ponts plus récents existent aussi. southleft/figma-console-mcp (MIT, 3 306 étoiles, activement maintenu) revendique 130 outils via son plugin Desktop Bridge. gethopp/figma-mcp-bridge (MIT, 919 étoiles) diffuse le document ouvert via un plugin pour contourner les limites de l'API REST. Nous ne nous appuierions pas encore sur figwright : 1 402 étoiles en moins de cinq mois avec trois watchers, c'est un schéma que nous préférons voir confirmé avant de le recommander.
Lequel choisir : le serveur distant officiel si vous disposez d'un siège Full ou Dev. Framelink si vous voulez un serveur local basé sur un jeton qui ne fait que lire ; notez qu'il est soumis aux limites propres à l'API REST, que le projet de pont de gethopp décrit comme serrées sur les forfaits gratuits. Un pont via plugin uniquement si vous avez besoin d'écrire sur un forfait que use_figma ne couvre pas, en acceptant que le plugin doive rester ouvert.
Sécurité
Un MCP server Figma détient une clé d'accès à vos fichiers de design et, avec use_figma, il peut les modifier.
- Écrivez sur des copies. Tant que vous ne faites pas confiance à un flux de travail, dirigez l'agent vers un brouillon ou un fichier dupliqué. L'historique des versions de Figma permet de restaurer un fichier, mais une copie propre est plus simple.
- Sachez ce qui est partagé. Le contexte de design, les captures d'écran et les variables sont envoyés à votre fournisseur d'IA à chaque appel. Vérifiez que votre organisation l'autorise pour les fichiers concernés.
- Traitez le texte des fichiers comme des données. Les noms de calques, les commentaires et le texte d'un fichier parviennent au modèle sous forme de texte. Un fichier communautaire partagé peut contenir des instructions destinées à l'agent.
- Gardez les jetons hors des configurations. Pour Framelink, préférez la variable d'environnement
FIGMA_API_KEYà une clé dansargs, et accordez au jeton les portées les plus restreintes autorisées par Figma.
Pour en savoir plus sur ces risques, consultez MCP security.
Quand ça ne fonctionne pas
| Ce que vous voyez | Cause | Correction |
|---|---|---|
| Fonctionne un moment, puis des erreurs de rate-limit | Limite de lecture liée à votre siège et à votre offre | Consultez le tableau ci-dessus ; un siège Full ou Dev l'augmente |
| Aucun outil du serveur desktop | Application fermée, aucun fichier Design ouvert, ou serveur desktop désactivé | Ouvrez un fichier Design, activez le Dev Mode et « Enable desktop MCP server » |
use_figma ou generate_figma_design manquant |
Client connecté au serveur desktop | Connectez-vous à https://mcp.figma.com/mcp |
| Erreur de permission sur un lien | Ce n'est pas un fichier Design, FigJam ou Make, ou c'est un autre compte | Vérifiez le type de lien ; lancez whoami |
| Résultats tronqués ou incomplets | Sélection trop volumineuse | Sélectionnez moins d'éléments ; utilisez d'abord get_metadata ; augmentez MAX_MCP_OUTPUT_TOKENS dans Claude Code |
| L'agent renvoie du code alors que vous vouliez des tokens | Il a choisi le mauvais outil | Nommez l'outil, ou demandez les « noms et valeurs des variables » |
| Des cases grises à la place des images | Liens d'assets expirés | Récupérez à nouveau les images, par exemple avec download_assets |
| Le client ne peut pas se connecter du tout | Client absent du catalogue MCP de Figma | Utilisez un client listé |
Les serveurs Figma de notre catalogue, avec leurs scores de vérification et leurs commandes d'installation, sont listés en haut de cette page.