Раньше «Figma MCP» означало одно: сервер, который позволял кодирующему агенту прочитать дизайн и превратить его в код. В 2026 году это значит больше. Официальный сервер Figma теперь работает удалённо, а также в десктопном приложении, умеет писать на холст, а лимиты на частоту вызовов зависят от вашего плана и места в команде так, что люди упираются в них уже после двадцати вызовов.
Этот гайд собран из документации для разработчиков, Справочного центра и блога Figma, репозитория figma/mcp-server-guide и кода community-проектов — всё прочитано 14 ноября 2026 года. Мы также проверили удалённый эндпоинт и прогнали Framelink через MCP Inspector. Платный аккаунт Figma мы не подключали, поэтому приводим заявленные Figma лимиты, а не те, в которые упёрлись сами.
Удалённый или настольный
| Удалённый сервер | Настольный сервер | |
|---|---|---|
| Адрес | https://mcp.figma.com/mcp |
http://127.0.0.1:3845/mcp |
| Нужно приложение Figma | Нет | Да, с открытым файлом Design |
| Вход | Аккаунт Figma, OAuth в браузере | Приложение, в котором вы авторизованы |
| Тарифы | Все тарифы, с ограничениями на чтение | Место Dev или Full на Professional, Education, Organization, Government или Enterprise |
| Как выбрать, что читать | Вставить ссылку на слой | Выбрать слой в приложении |
| Запись на холст | Да, бета | Нет |
| Xcode | Поддерживается | Не поддерживается |
| Figma for Government | Не поддерживается | Единственный вариант |
Figma рекомендует удалённый сервер и наделяет его «самым широким набором возможностей». Настольный сервер существует для организаций с особыми требованиями; например, Figma for Government может использовать только его. Если вы не из этой группы, начинайте с удалённого.
Мы проверили, как удалённый сервер заявляет о себе. Запрос без авторизации отклоняется, а в его метаданных OAuth сервером авторизации указан api.figma.com с единственной областью доступа mcp:connect. Именно этот поток запускает ваш клиент, когда открывает браузер и просит вас разрешить доступ.
Тарифы и лимиты
Именно здесь кроется большинство жалоб в духе «оно перестало работать». Figma ограничивает инструменты чтения данных — отдельно для каждого места и тарифа:
| Место | Starter | Professional | Organization | Enterprise |
|---|---|---|---|---|
| View или Collab | 20 в месяц | 20 в месяц | 20 в месяц | 20 в месяц |
| Full или Dev | не предоставляется | 200 в день, 10 в минуту | 200 в день, 15 в минуту | 600 в день, 20 в минуту |
Образовательные тарифы получают показатели Professional. Ограничение в минуту действует поверх дневного, и Figma предупреждает, что может менять лимиты в любой момент. Инструменты записи не учитываются, как и действия, расходующие кредиты Figma AI.
Двадцать вызовов в месяц расходуются быстро. Агент, реализующий один экран, часто запрашивает контекст дизайна, переменные, скриншот и, возможно, метаданные, так что на бесплатном аккаунте вызовы могут закончиться уже после нескольких экранов. Если вы работаете с Figma каждый день, сервер реалистично считать функцией места Full или Dev.
Одно устаревшее число стоит игнорировать: README собственного репозитория mcp-server-guide от Figma до сих пор говорит о шести вызовах в месяц для мест Starter и View. Документация для разработчиков и Help Center оба указывают 20.
Установка
Claude Code. Плагин Figma есть в официальном маркетплейсе Anthropic и приносит с собой сервер и навыки Figma:
claude plugin install figma@claude-plugins-official
Если в вашей организации плагины заблокированы, добавьте только сервер:
claude mcp add --scope user --transport http figma https://mcp.figma.com/mcp
Затем выполните /mcp в Claude Code, выберите figma, нажмите Authenticate и в браузере нажмите Allow access.
Cursor. Введите /add-plugin figma в чате или добавьте сервер в разделе Settings, Tools & MCP:
{
"mcpServers": {
"figma": {
"url": "https://mcp.figma.com/mcp"
}
}
}
Нажмите Connect и разрешите доступ. Если вход зацикливается, используйте "Clear All MCP Tokens", войдите снова и перезапустите Cursor.
VS Code с GitHub Copilot. Выполните "MCP: Open User Configuration" и добавьте:
{
"servers": {
"figma": {
"type": "http",
"url": "https://mcp.figma.com/mcp"
}
}
}
Нажмите Start над записью, разрешите доступ, переключите чат в режим Agent и введите #get_design_context, чтобы проверить, что инструменты загрузились.
Codex:
codex mcp add figma --url https://mcp.figma.com/mcp
Gemini CLI устанавливает его как расширение из https://github.com/figma/mcp-server-guide, затем /mcp auth figma. На страницах Figma нет шагов для Claude Desktop. Подключиться могут только клиенты из каталога MCP Figma, поэтому проверьте его, прежде чем пробовать другой клиент.
Десктопный сервер — другой вариант: откройте приложение Figma для десктопа, переключитесь в Dev Mode сочетанием Shift+D и в правой боковой панели выберите "Enable desktop MCP server". Затем укажите в клиенте http://127.0.0.1:3845/mcp, например claude mcp add --transport http figma-desktop http://127.0.0.1:3845/mcp.
Что делают инструменты
На странице инструментов Figma перечислено около тридцати инструментов. Вот те, которые вы будете использовать:
| Инструмент | Где | Что возвращает или делает |
|---|---|---|
get_design_context |
Оба | Код и структура слоя, по умолчанию React с Tailwind; другой стек можно запросить в промпте |
get_variable_defs |
Оба | Переменные и стили, которые использует выделение: цвета, отступы, типографика |
get_screenshot |
Оба | Изображение выделения |
get_metadata |
Оба | Лёгкая XML-структура с ID, именами и размерами; подходит для больших фреймов |
get_code_connect_map |
Оба | Каждому компоненту Figma сопоставлен код-компонент |
get_figjam |
Оба | Доски FigJam в виде XML со скриншотами |
search_design_system |
Удалённый | Ищет компоненты, переменные и стили по вашим библиотекам |
download_assets |
Удалённый | Экспортирует до 20 узлов или исходных изображений за вызов |
whoami |
Удалённый | Ваш аккаунт, тарифы и типы мест |
use_figma |
Удалённый | Выполняет код Plugin API в файле, чтобы создавать, редактировать или удалять слои |
generate_figma_design |
Удалённый | Превращает живую веб-страницу, включая localhost, в слои Figma |
create_new_file |
Удалённый | Пустой файл Design, FigJam или Slides |
create_design_system_rules — это промпт, а не инструмент: он пишет файл правил для вашей кодовой базы, чтобы агент каждый раз одинаково сопоставлял токены Figma с вашими компонентами.
Если вы используете Code Connect, подключённые компоненты приходят обёрнутыми в маркер <CodeConnectSnippet>, где указан ваш реальный компонент, а вместе с ними передаются и все прикреплённые вами пользовательские инструкции. В этом и разница между агентом, который пишет новую кнопку, и агентом, который использует вашу.
Большие фреймы
Сам совет Figma — выделять меньше. Большие выделения «замедляют работу инструментов, вызывают ошибки или возвращают неполные результаты». Выбирайте по одной карточке, шапке или боковой панели за раз. Для целой страницы сначала вызовите get_metadata, чтобы получить структуру и ID узлов, а затем get_design_context для нужных частей. В Claude Code, если результаты обрезаются, увеличьте MAX_MCP_OUTPUT_TOKENS.
Запись на холст
24 марта 2026 года Figma открыла холст для агентов. Инструмент use_figma удалённого сервера выполняет код через Figma Plugin API внутри вашего файла, так что агент может строить фреймы, применять переменные, раскладывать компоненты и редактировать то, что уже есть, — в Design-файлах, FigJam, Slides и Specs. Среди клиентов на старте Figma назвала Claude Code, Codex, Cursor, Copilot в VS Code и Copilot CLI.
Правила в бете:
- Места. Для записи за пределами собственных черновиков нужно место Full; место Dev позволяет писать только в черновиках. Нужен доступ на редактирование файла и план Professional, Education, Organization или Enterprise.
- Цена. Бесплатно во время беты. Figma говорит, что функция «will eventually become a usage-based paid feature», и цену пока не называет.
- Ограничения. Нет отдельного создания изображений, нет компонентов, содержащих изображения или видео, нет GIF. Шрифты должны быть заранее загружены в ваш аккаунт Figma. Компоненты нужно опубликовать вручную, прежде чем Code Connect сможет их сопоставить.
- Качество. Figma называет результат бетовым по качеству и советует работать на копии или в черновике и держать резервную копию.
Остальные инструменты записи уже. generate_figma_design захватывает работающий веб-интерфейс — продакшен, стейджинг или localhost — как редактируемые слои, что удобно, чтобы перенести существующий продукт в Figma. generate_diagram рисует диаграммы FigJam из текста или Mermaid. send_code_to_figma импортирует локальный проект как файл Figma Make.
Если use_figma нет в списке инструментов, ваш клиент почти наверняка работает с десктопным сервером, у которого нет инструментов записи.
Серверы сообщества
До того как Figma выпустила собственный сервер, пробел закрывало сообщество, и два проекта до сих пор широко используются.
Framelink (GLips/Figma-Context-MCP, MIT, 16 205 звёзд) читает файл через REST API Figma с personal access token и упрощает ответ, прежде чем тот попадёт к модели. Мы прогнали версию 0.13.2 через MCP Inspector: она показывает два инструмента — get_figma_data, помеченный как read-only, и download_figma_images. С фиктивным ключом вызов завершился с isError в значении true и ссылкой на руководство по устранению неполадок — для скриптов это правильное поведение. Писать он не умеет и подчиняется ограничениям REST API; в открытом issue сообщается об ошибках 429. Его конфиг:
{
"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 звёзд) пишет через плагин Figma, подключённый к локальному серверу WebSocket. Ему нужны Bun, плагин сообщества, запущенный в вашем файле, и вызов join_channel, чтобы связать их. Ни токена, ни Dev-места — именно так до появления use_figma получали доступ на запись. Последний push был в июле 2026 года.
Есть и более новые мосты. southleft/figma-console-mcp (MIT, 3 306 звёзд, активно поддерживается) заявляет 130 инструментов через свой плагин Desktop Bridge. gethopp/figma-mcp-bridge (MIT, 919 звёзд) передаёт открытый документ потоком через плагин, чтобы обойти ограничения REST. На figwright мы бы пока не полагались: 1 402 звезды меньше чем за пять месяцев при трёх watcher'ах — такую картину мы предпочитаем увидеть подтверждённой, прежде чем рекомендовать.
Что выбрать: официальный удалённый сервер, если у вас есть место Full или Dev. Framelink — если нужен локальный сервер на токене, который только читает; учтите, что он ограничен лимитами самого REST API, которые проект-мост от gethopp называет жёсткими на бесплатных тарифах. Мост через плагин — только если нужна запись на тарифе, который use_figma не покрывает, и вы готовы к тому, что плагин должен оставаться открытым.
Безопасность
MCP server для Figma хранит ключ к вашим файлам дизайна, а с use_figma может их менять.
- Пишите в копии. Пока вы не доверяете сценарию, направляйте агента на черновик или дубликат файла. История версий Figma позволяет восстановить файл, но чистая копия проще.
- Знайте, что передаётся. Контекст дизайна, скриншоты и переменные уходят вашему AI-провайдеру при каждом вызове. Проверьте, что ваша организация допускает это для соответствующих файлов.
- Считайте текст в файле данными. Имена слоёв, комментарии и текст в файле попадают в модель как текст. Общий файл из сообщества может содержать инструкции, адресованные агенту.
- Держите токены вне конфигов. Для Framelink предпочитайте переменную окружения
FIGMA_API_KEYключу вargs, а токену выдавайте самые узкие scopes, которые допускает Figma.
Подробнее об этих рисках — в разделе Безопасность MCP.
Когда это не работает
| Что вы видите | Причина | Решение |
|---|---|---|
| Работает какое-то время, затем ошибки rate limit | Лимит на чтение для вашего места и плана | Проверьте таблицу выше; место Full или Dev повышает его |
| Нет инструментов от desktop-сервера | Приложение закрыто, не открыт файл Design или desktop-сервер выключен | Откройте файл Design, Dev Mode, "Enable desktop MCP server" |
Отсутствует use_figma или generate_figma_design |
Клиент подключён к desktop-серверу | Подключитесь к https://mcp.figma.com/mcp |
| Ошибка доступа по ссылке | Это не файл Design, FigJam или Make, либо другой аккаунт | Проверьте тип ссылки; выполните whoami |
| Результаты обрезаны или неполные | Слишком большой выделенный фрагмент | Выделите меньше; сначала используйте get_metadata; увеличьте MAX_MCP_OUTPUT_TOKENS в Claude Code |
| Агент возвращает код, хотя вам нужны токены | Он выбрал не тот инструмент | Назовите инструмент или попросите "имена и значения переменных" |
| Серые прямоугольники вместо изображений | Ссылки на ресурсы истекли | Загрузите изображения заново, например с помощью download_assets |
| Клиент вообще не может подключиться | Клиента нет в каталоге MCP от Figma | Используйте клиент из списка |
Серверы Figma из нашего каталога с оценками проверок и командами установки перечислены в начале этой страницы.