Figma Console MCP Server

Ваша дизайн-система как API. Сервер Model Context Protocol, который соединяет дизайн и разработку — предоставляя ИИ-ассистентам полный доступ к Figma для извлечения, создания, отладки и двунаправленной синхронизации токенов.

️ Извлечение дизайн-системы (v1.40.0): Превратите продакшнную кодовую базу в дизайн-систему. Семь новых инструментов figma_ds_* (локальный режим) сканируют одну или несколько кодовых баз приложений — определяют фреймворк, метод стилизации и вендорский слой; инвентаризацию компонентов по частоте использования с классификацией vendored / wrapped / pure-vendor / bespoke; вывод вариантов на основе реальных мест вызова; обнаружение дубликатов; и архитектурный проход, отделяющий UI-кит от дизайн-системы (FollowButton на самом деле Button — а вот недостающие generic-примитивы). Затем они извлекают фактческую стилизацию приложения в DTCG-токены с указанием происхождения каждого токена — многорежимные CSS custom properties (.dark, [data-theme] и им подобные), SCSS-переменные, значения конфигурации Tailwind, HSL-тройки shadcn, частотный аналіз Tailwind utility-классов с оценкой на основе собственной темы приложения и «повышенные по частоте» сырые значения — содают каркас пакета дизайн-системы со страницами-витринами токенов/типографики/иконографии, подключют новый Storybook workshop к реалным тематическим слоям и шрифтам приложения, глубоко извлекают компоненты для переноса с CSF3-скаффолдами историй, пропускают резултат через детерминированные оценки точности и сохраняют прогресс переноса между сессиями. Извлечённый tokens/tokens.json напрямую импортируется в переменные Figma через figma_import_tokens — полный цикл «код → дизайн-система → Figma». Также исправляет форматтеры токенов, заклучавшие CSS-функциональные выражения вида cubic-bezier(...) в кавычки (закавыченная кривая easing незаметно убивает переходы — затрагивает и вывод figma_export_tokens). Только серверная част — повторный импорт плагина не требуется. Что нового →

Что это?

Figma Console MCP подключает ИИ-ассистентов (например, Claude) к Figma, позволяя:

• 🎨 Извлечение дизайн-системы — Извлекайте переменные, компоненты и стили

• 🧬 Извлечение «кодовая база → дизайн-система» — Сканируйте производственную кодовую базу, извлекайте её фактическую стилизацию в DTCG-токены с указанием происхождения каждого токена, создавайте каркас пакета дизайн-системы с подключённым Storybook workshop и пропускайте результат через детерминированные оценки точности — затем возвращайте токены в переменные Figma (локальный режим)

• 🔁 Двунаправленная синхронизация токенов — Экспортируйте переменные Figma в DTCG JSON (диалект legacy или 2025.10) + ещё 9 форматов; отправляйте правки со стороны кода обратно в Figma с полным применением — создание, переименование, перенацеливание алиасов и удаления, ограниченные заменой. Заменяет экспортный конвейер Style Dictionary и Tokens Studio

• 📸 Визуальная отладка — Делайте скриншоты для контекста

• ✏️ Создание дизайнов — Создавайте UI-компоненты, фреймы и макеты прямо в Figma — включая создание набора компонентов одним вызовом из матрицы осей вариантов

• 🔧 Управление переменными — Создавайте, обновляйте, переименовывайте и удаляйте дизайн-токены

• 🕰 История версий и временные ряды — Списывайте версии, сравнивайте снимки, создавайте markdown-чанжлоги, отслеживайте введение свойств/вариантов через бинарный поиск (blame) и включайте по-компонентную историю дизайна и git в генерируемую документацию компонентов

• ⚡ Мониторинг в реальном времени — Наблюдайте за консольными логами из плагина Desktop Bridge

• 📌 Доски FigJam — Создавайте стикеры, блок-схемы, таблицы и блоки кода на совместных досках

• 🎞️ Презентации Slides — Программно создавайте и управляйте презентациями Figma Slides

• ♿ Сканирование доступности — 14 проверок дизайна по WCAG с отметкой уровня соответствия, оценками компонентов, сканированием кода axe-core, паритетом «дизайн — код»

• 📋 Аудит состояния дизайн-систем — Аудит в стиле Lighthouse с оценками по именованию, токенам, метаданным компонентов, доступности, согласованности и покрытию — доступен как обычный инструмент для любого MCP-клиента (с рекомендациями по автоисправлению для каждой находки) и как визуальное приложение-дашборд

• 🛡 Кросс-MCP идентичность — Каждый ответ инструмента содержит _mcp: "figma-console-mcp" и ошибки префиксуются [figma-console-mcp], так что атрибуция остаётся однозначной в агентах, запускающих несколько Figma MCP

• ☁️ Облачный ретранслятор записи — Веб-ИИ-клиенты (Claude.ai, v0, Replit) могут создавать дизайн в Figma через облачное сопряжение

• 🔄 Четыре способа подключения — Удалённый SSE, облачный режим, NPX или локальный Git

Related MCP server: MCP Figma

⚡ Быстрый старт

Выберите способ настройки

Сначала решите, что вы хотите сделать:

⚠️ Важно: различия в возможностях

Суть: Удалённый SSE — только для чтения с 9 инструментами. Облачный режим открывает доступ на запись (101 инструмент) для веб-ИИ-клиентов без Node.js. NPX / локальный Git дают полный набор из 121 инструмента с мониторингом в реальном времени.

🚀 Настройка NPX (рекомендуется)

Подходит для: Дизайнеров, которые хотят полные возможности дизайна с помощью ИИ.

Что вы получаете: Все 121 инструментов, включая создание дизайнов, управление переменными и инстанцирование компонентов.

Предварительные требования

• Node.js 18+ — проверьте с помощью node --version (Скачать)

• Figma Desktop установлен (не только веб-приложение)

• MCP-клиент (Claude Code, Cursor, Windsurf, Claude Desktop и т. д.)

Шаг 1: Получите свой токен Figma

1. Перейдите в Управление персональными токенами доступа в справке Figma

2. Выполните шаги, чтобы создать новый персональный токен доступа

3. Введите описание: Figma Console MCP

4. Установите области доступа: Содержимое файла (чтение), Версии файла (чтение), Переменные (чтение), Комментарии (чтение и запись)

5. Скопируйте токен — вы больше его не увидите! (начинается с figd_)

Шаг 2: Настройте свой MCP-клиент

Claude Code (CLI):

claude mcp add figma-console -s user -e FIGMA_ACCESS_TOKEN=figd_YOUR_TOKEN_HERE -e ENABLE_MCP_APPS=true -- npx -y figma-console-mcp@latest

Cursor / Windsurf / Claide Desktop:

Добавьте в ваш файл конфигурации MCP (см. Где найти ваш файл конфигурации ниже):

{
  "mcpServers": {
    "figma-console": {
      "command": "npx",
      "args": ["-y", "figma-console-mcp@latest"],
      "env": {
        "FIGMA_ACCESS_TOKEN": "figd_YOUR_TOKEN_HERE",
        "ENABLE_MCP_APPS": "true"
      }
    }
  }
}

📂 Где найти ваш файл конфигурации

Если вы не уверены, куда поместить приведённую выше JSON-конфигурацию, вот где каждое приложение хранит свою конфигурацию MCP:

Совет для дизайнеров: Символ ~ означает вашу домашнюю папку. На macOS это /Users/YourName/. На Windows — C:\Users\YourName\. Вы можете открыть эти файлы в любом текстовом редакторе — даже в TextEdit или Notepad.

Не можете найти файл? Если его ещё нет, создайте его. Приложение подхватит его при следующем перезапуске. Убедитесь, что весь файл — валидный JSON (следите за пропущенными запятыми или скобками).

Пользователи Claude Code: Можете полностью пропустить ручное редактирование. Просто выполните команду claude mcp add выше — она сделает всё за вас.

Шаг 3: Подключитесь к Figma Desktop

Плагин Desktop Bridge:

1. Откройте Figma Desktop обычным способом (специальные флаги не нужны) и откройте файл

2. Перейдите в Плагины → Разработка → Импортировать плагин из манифеста...

3. Выберите ~/.figma-console-mcp/plugin/manifest.json (стабильный путь, автоматически создаётся MCP-сервером)

4. Запустите плагин в вашем файле Figma — он сканирует порты 9223–9232 и автоматически подключается к вашему запущенному MCP-серверу

Важно об обновлениях плагина. Figma кэширует файлы плагина (code.js и ui.htмl) на уровне приложения. MCP-сервер обновляет файлы в ~/.figma-consle-mcp/plug/ при каждом запуске, но Figma продолжает использовать свою сохранённую копию, пока вы не импортируете манифест заново.

Повторный импорт обязателен только тогда, когда об этом сказано в записи релиза — обычно когда плагин добавляет новый метод, необходимый серверу (например, v1.22.4, v1.10.0). При большинстве обновлений новый сервер остаётся совместимым с предыдущим плагином, и повторный импорт необязателен: вы всё равно получите все функциональные изменения, просто не косметические правки на стороне плагина (текст статусного индикатора, pluginVersion в отчётах).

Когда вы решите переимпортировать: Плагины → Управление плагинами → повторно импортируйте ~/.figma-console-mcp/plugin/manifest.json. Стабильный путь никогда не меняется, так что это один клик.

Шаг 4: Перезапустите свой MCP-клиент

Перезапустите ваш MCP-клиент, чтобы загрузить новую конфигурацию.

Шаг 5: Проверьте!

Check Figma status

→ Должен показать статус подключения с активным WebSocket-транспортом

Create a simple frame with a blue background

→ Должен содать фрейм в Figma (подтверждает доступ на запись!)

📖 Полное рукоодство по настройке

Для контрибьюторов: режим локалного Git

Подходит для: Разработчиков, которые хотят изменять исходный код или вносить вклад в проект.

Что вы получаете: Те же 121 инструментов, что и NPX, плюс полный доступ к исходному коду.

Быстрая настройка

# Clone and build
git clone https://github.com/southleft/figma-console-mcp.git
cd figma-console-mcp
npm install
npm run build:local

Настройте свой MCP-клиент

Добавьте в ваш файл конфигурации (см. Где найти ваш файл конфигурации):

{
  "mcpServers": {
    "figma-console": {
      "command": "node",
      "args": ["/absolute/path/to/figma-console-mcp/dist/local.js"],
      "env": {
        "FIGMA_ACCESS_TOKEN": "figd_YOUR_TOKEN_HERE",
        "ENABLE_MCP_APPS": "true"
      }
    }
  }
}

Затем выполните шаги 3–5 из раздела NPX выше.

📖 Полное руководство по настройке

📡 Удалённый SSE (ознакомление только для чтения)

Подходит для: Быстрой оценки инструмента или извлечения дизайн-данных в режиме только чтения.

Что вы получаете: 9 инструментов только для чтения — просмотр данных, создание скриншотов, чтение логов, соответствие дизайна и кода. Не может создавать или изменять дизайны.

Claude Desktop (метод через UI)

1. Откройте Claude Desktop → Настройки → Коннекторы

2. Нажмите «Добавить пользовательский коннектор»

3. Введите:

   • Имя: Figma Console (Read-Only)

   • URL: https://figma-console-mcp.southleft.com/sse

4. Нажмите «Добавить» — Готово! ✅

OAuth-аутентификация происходит автоматически при первом использовании инструментов дизайн-системы.

Claude Code

⚠️ Известная проблема: встроенный --transport sse в Claude Code содержит ошибку. Вместо этого используйте mcp-remote:

claude mcp add figma-console -s user -- npx -y mcp-remote@latest https://figma-console-mcp.southleft.com/sse

💡 Совет: Для полного функционала используйте NPX Setup вместо Remote SSE.

Другие клиенты (Cursor, Windsurf и т.д.)

{
  "mcpServers": {
    "figma-console": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://figma-console-mcp.southleft.com/sse"]
    }
  }
}

Переход к полным возможностям

Готовы к созданию дизайнов? Следуйте инструкции NPX Setup выше или попробуйте Cloud Mode, если не хотите устанавливать Node.js.

📖 Полное руководство по настройке

☁️ Cloud Mode (веб-клиенты ИИ)

Лучше всего подходит для: использования Claude.ai, v0, Replit или Lovable для создания и изменения дизайнов Figma — Node.js не требуется.

Что вы получаете: 101 инструмент, включая полный доступ на запись — создание дизайнов, управление переменными, создание экземпляров компонентов и все инструменты REST API. Только мониторинг в реальном времени (журналы консоли, отслеживание выделения, изменения документа) требует Local Mode.

Предварительные требования

• Личный токен доступа Figma — Создайте его здесь (начинается с figd_)

• Figma Desktop с установленным плагином Desktop Bridge (см. настройку Desktop Bridge)

• Веб-клиент ИИ, поддерживающий MCP (Claude.ai, Lovable, v0, Replit и т.д.)

Шаг 1: Добавьте MCP-коннектор

Добавьте этот эндпоинт в настройки MCP вашей ИИ-платформы:

URL: https://figma-console-mcp.southleft.com/mcp Авторизация: ваш Figma PAT в качестве Bearer-токена

В Claude.ai: Настройки → Коннекторы → Добавить пользовательский коннектор → вставьте указанный выше URL. В Lovable/v0/Replit: найдите «Добавить MCP-сервер» или «Интеграции» в настройках → вставьте URL и добавьте свой токен.

Шаг 2: Сопрягите плагин

1. Откройте плагин Desktop Bridge в Figma Desktop (Плагины → Разработка → Figma Desktop Bridge)

2. Сообщите вашему ИИ-ассистенту:

   Connect to my Figma plugin

3. ИИ выдаст вам 6-значный код сопряжения (действует 5 минут)

4. В плагине: переключите «Cloud Mode» → введите код → нажмите «Подключиться»

5. Вы сопряжены! Теперь доступен полный доступ на запись

Что вы можете делать

После сопряжения используйте естественный язык для создания дизайнов:

Create a card component with a header image, title, description, and action button
Set up a color token collection with Light and Dark modes
Add a "High Contrast" mode to my existing token collection

Как это работает

Ваш ИИ-клиент отправляет команды записи через облачный MCP-сервер, который передает их через WebSocket плагину Desktop Bridge, работающему в вашем Figma Desktop. Плагин выполняет команды с помощью Figma Plugin API и возвращает результаты тем же путем.

AI Client → Cloud MCP Server → Durable Object Relay → Desktop Bridge Plugin → Figma

Переменные на любом тарифе: Cloud Mode использует Plugin API (не Enterprise REST API), поэтому управление переменными работает на тарифах Free, Pro и Organization.

📖 Полное руководство по настройке

📊 Сравнение методов установки

Ключевой вывод: Remote SSE доступен только для чтения. Cloud Mode добавляет доступ на запись для веб-ИИ-клиентов без Node.js. NPX/Local Git предоставляют полный набор из 121 инструмента.

📖 Полное сравнение функций

🎯 Проверьте ваше подключение

После настройки попробуйте следующие промпты:

Базовый тест (все режимы):

Navigate to https://www.figma.com and check status

Тест дизайн-системы (требуется авторизация):

Get design variables from [your Figma file URL]

Тест Cloud Mode:

Connect to my Figma plugin

→ Следуйте процессу сопряжения, затем попробуйте: «Создайте простой синий прямоугольник»

Тест плагина (только Local Mode):

Show me the primary font for [your theme name]

🔐 Аутентификация

Remote Mode - OAuth (автоматически)

При первом использовании инструментов дизайн-системы:

1. Браузер автоматически открывает страницу авторизации Figma

2. Нажмите «Разрешить», чтобы авторизоваться (одноразово)

3. Токен хранится безопасно и обновляется автоматически

4. Работает с тарифами Figma Free, Pro и Enterprise

Local Mode - персональный токен доступа (вручную)

1. Посетите https://help.figma.com/hc/en-us/articles/8085703771159-Manage-personal-access-tokens

2. Создайте токен с областями: Содержимое файла (чтение), Версии файлов (чтение), Переменные (чтение), Комментарии (чтение и запись)

3. Добавьте в конфигурацию MCP как переменную окружения FIGMA_ACCESS_TOKEN

🛠️ Доступные инструменты

Статус и диагностика

• figma_get_status — проверка подключения WebSocket-моста и контекста файла

• figma_diagnose — понятная дизайнеру проверка работоспособности + руководство по настройке

• figma_reconnect — принудительное переподключение к плагину Desktop Bridge

• figma_navigate — переключение активного целевого файла среди подключенных плагинов (Local) или навигация в облачном headless-браузере (Remote/Cloud)

Отладка консоли

• figma_get_console_logs — получение журналов консоли

• figma_watch_console — потоковая передача журналов в реальном времени

• figma_clear_console — очистка буфера журнала

• figma_reload_plugin — перезагрузка текущей страницы

Визуальная отладка

• figma_take_screenshot — создание скриншотов интерфейса

Извлечение дизайн-системы

• figma_get_design_system_kit — полная дизайн-система одним вызовом — токены, компоненты, стили, визуальные спецификации

• figma_get_variables — извлечение токенов/переменных дизайна

• figma_get_component — получение данных компонента (метаданные или спецификация реконструкции)

• figma_get_component_for_development — компонент + изображение

• figma_get_component_image — только изображение

• figma_get_styles — стили цветов, текста, эффектов

• figma_get_file_data — полная структура файла

• figma_get_file_for_plugin — оптимизированные данные файла

• figma_audit_design_system_report — балльная оценка работоспособности для любого MCP-клиента — отчет по шести категориям (именование, токены, метаданные, доступность, согласованность, покрытие) с рекомендациями по каждому пункту («может ли этот MCP исправить это?»), разбивка по категориям, данные в реальном времени с указанием источника, кэш на 5 минут

📚 Проверка общей библиотеки

• figma_get_library_component_by_key — разрешение любого ключа компонента в полные свойства + варианты + визуальные спецификации — без необходимости URL исходного файла библиотеки. Работает как с ключами COMPONENT_SET, так и с отдельными ключами COMPONENT. Адаптивное сжатие при размере >500 КБ.

• figma_get_library_components — обнаружение всех компонентов в файле библиотеки (требуется URL/ключ файла библиотеки)

• figma_get_library_variables — список всех переменных из командных библиотек, на которые подписан текущий файл. Работает на любом тарифе Figma — использует путь Plugin API, а не REST-эндпоинт только для Enterprise. Фильтрация по libraryName, collectionName или resolvedType.

• figma_import_library_variable — импорт переменной библиотеки в текущий файл. Возвращает локальный id, готовый для передачи в figma_set_fills / figma_update_variable / любой инструмент привязки переменных.

☁️ Облачное реле

• figma_pair_plugin — генерация кода сопряжения для подключения плагина Desktop Bridge через облачное реле

✏️ Создание дизайнов (Local Mode + Cloud Mode)

• figma_execute — мощный инструмент: запуск любого кода Figma Plugin API для создания дизайнов

  • Создание фреймов, фигур, текста, компонентов

  • Применение авто-раскладки, стилей, эффектов

  • Создание полных UI-макетов программно

  • Необязательный fileKey напрямую указывает на конкретный подключенный файл (только Local Mode), не затрагивая активный файл или блокировку цели

• figma_execute_across_files — только Local Mode. Запуск одного и того же скрипта в нескольких файлах, подключенных через Desktop Bridge, одновременно, с возвратом карты результатов для каждого файла — для проверок согласованности и исправлений в многофайловой дизайн-системе, заменяя «открой файл, запусти плагин, повтори для каждого файла»

  • Укажите файлы с помощью fileKeys (из figma_list_open_files) или передайте allFiles: true, чтобы затронуть все подключенные файлы — требуется одно из двух, чтобы скрипт никогда не распространялся на файлы, которые вы не собирались затрагивать

  • Тайм-ауты и изоляция ошибок для каждого файла: один медленный или сбойный файл не задерживает и не ломает другие

• figma_create_component_set — создание набора компонентов с вариантами одним декларативным вызовом

  • Генерация всех комбинаций вариантов из матрицы осей (например, { State: ["default", "hover", "disabled"], Size: ["sm", "lg"] } → 6 вариантов) на основе базового компонента или объединение существующих компонентов

  • Именование вариантов Prop=Value, под капотом combineAsVariants, опциональная автоматически упорядоченная сетка с подписями

  • Возвращает ключ каждого варианта, готовый для figma_instantiate_component

• figma_arrange_component_set — организация вариантов в профессиональные наборы компонентов

  • Преобразование нескольких вариантов компонентов в полноценный набор компонентов Figma

  • Автоматически применяет встроенную визуализацию фиолетовой пунктирной границы

  • Создает белую контейнерную рамку с заголовком, подписями строк и заголовками столбцов

  • Подписи строк выровнены по вертикали по центру каждой строки сетки

  • Заголовки столбцов выровнены по горизонтали по центру каждого столбца

  • Используйте естественный язык, например «расположите эти варианты» или «организуйте как набор компонентов»

• figma_set_description — документирование компонентов с подробными описаниями

  • Добавление описаний к компонентам, наборам компонентов и стилям

  • Поддерживает форматирование Markdown для подробной документации

  • Описания отображаются в Dev Mode для разработчиков

🧩 Слоты Figma (Local Mode + Cloud Mode)

• figma_create_slot — добавление слота к компоненту через GA API createSlot() — связанное свойство SLOT создается автоматически; работает с отдельными компонентами и вариантами внутри набора компонентов

• figma_get_slots — список слотов на компоненте, наборе компонентов (агрегированно по вариантам) или экземпляре — идентификаторы, имена, ключи свойств, размеры и текущие дочерние элементы

• figma_append_to_slot — заполнение слота экземпляра путем клонирования существующего узла или создания нового содержимого (setProperties отклоняет значения слотов по замыслу — это путь заполнения)

• figma_reset_slot — очистка содержимого слота на экземпляре

• figma_add_slot_property — преобразование существующего фрейма в слот через ручную привязку свойства SLOT, с description и preferredValues

🔍 Паритет дизайна и кода (все режимы)

• figma_check_design_parity — Сравнивает спецификации компонентов Figma с реализацией в коде, формируя отчёт о расхождениях с оценками и практическими пунктами для исправления

• figma_generate_component_doc — Генерирует платформенно-независимую документацию в Markdown, объединяя данные дизайна Figma с информацией из кода

🔁 Синхронизация токенов (локальный режим + облачный режим)

• figma_export_tokens — Экспортирует переменные Figma в файлы дизайн-токенов в вашей кодовой базе. Канонический JSON DTCG (по умолчанию устаревший hex-диалект или объектные цвета/размеры DTCG 2025.10 через dtcgDialect: "2025"), а также форматы CSS, Tailwind v4/v3, SCSS, TS, JSON, Style Dictionary и Tokens Studio. Дифференциальное слияние с существующими исходными файлами (записывает только изменившееся). Автоопределение tokens.config.json позволяет вызывать без аргументов после первой настройки. Метаданные scopes и codeSyntax проходят полный цикл через $extensions. Заменяет пайплайн экспорта Style Dictionary и Tokens Studio для популярных методов стилизации.

• figma_import_tokens — Отправляет изменения токенов из кода обратно в Figma с полным этапом применения. Сравнивает с текущим состоянием Figma, затем применяет обновления значений, создаёт недостающие коллекции/переменные, применяет переименования, записывает настоящие ссылки на алиасы (VARIABLE_ALIAS) и — только при strategy: "replace" — удаляет переменные, существующие только в Figma. Безопасно для полного цикла — идентификаторы переменных Figma сохраняются в DTCG $extensions["figma-console-mcp"], поэтому переименования с любой стороны не создают дубликатов. Принимает оба диалекта DTCG. Стратегия dry-run для безопасного предпросмотра. В облачном режиме передавайте токены инлайн через payload или files (без доступа к локальной файловой системе).

🧬 Извлечение дизайн-системы (только локальный режим)

Превратите производственную кодовую базу в дизайн-систему: анализ → извлечение токенов → создание каркаса → перенос компонентов → проверка. Только локальный режим — эти инструменты читают и записывают вашу локальную файловую систему, поэтому они никогда не регистрируются в облачном режиме.

• figma_ds_analyze — Сканирует одну или несколько производственных кодовых баз приложений — определение фреймворка/стилей/вендорного слоя; инвентаризация компонентов, ранжированная по использованию, с классификацией: вендорные / обёрнутые / полностью вендорные / собственные — с контрактами пропсов, выводом вариантов из реальных мест вызова и обнаружением дубликатов; захват иконографии и типографики; классификация архитектуры (атомарные уровни, специализации вроде FollowButton → Button, отсутствующие общие примитивы — анализ «UI-кит против дизайн-системы»)

• figma_ds_extract_tokens — Извлекает стили приложения в DTCG-токены. Сначала объявленные намерения — мультимодовые CSS-переменные (.dark / [data-theme] и другие соглашения), SCSS-переменные, значения конфига Tailwind, HSL-тройки shadcn — плюс анализ частотности utility-классов Tailwind, оценённый по собственной теме приложения, и повторяющиеся сырые значения, продвигаемые по частоте. Каждый токен несёт происхождение (источник file:line, уверенность, частотность) в $extensions; результат импортируется напрямую в переменные Figma через figma_import_tokens

• figma_ds_scaffold — Генерирует пакет дизайн-системы — каркас пакета, файлы токенов через общий движок форматирования, страницы документации с образцами токенов/типографики/иконографии, peer-зависимости фреймворка и README с описанием рабочего процесса

• figma_ds_setup_storybook — Подключает только что инициализированный воркшоп Storybook к извлечению — таблицу стилей предпросмотра, несущую маппинг @theme исходного приложения, кастомные определения @utility, @layer base и правила @font-face; копирование самостоятельно размещённых шрифтов; патчи конфигурации (плагин Tailwind vite, автоматический JSX runtime); и панель тем, построенную из извлечённых режимов

• figma_ds_extract_component — Глубоко извлекает один компонент для переноса — исходный код, контракт пропсов, наблюдаемые варианты в местах вызова, точки соприкосновения со стилями и готовый к адаптации каркас CSF3-стори

• figma_ds_verify — Детерминированные оценки точности — разбор DTCG + целостность алиасов, сканирование выражений CSS в кавычках, разрешение var() в воркшопе, покрытие структуры и переноса, готовность к полному циклу Figma

• figma_ds_status — Читает или записывает прогресс переноса, сохраняемый между сеансами

🔧 Управление переменными (локальный режим + облачный режим)

• figma_create_variable_collection — Создаёт новые коллекции переменных с режимами

• figma_create_variable — Создаёт переменные COLOR, FLOAT, STRING или BOOLEAN

• figma_update_variable — Обновляет значения переменных в конкретных режимах

• figma_rename_variable — Переименовывает переменные с сохранением значений

• figma_delete_variable — Удаляет переменные

• figma_delete_variable_collection — Удаляет коллекции и все их переменные

• figma_add_mode — Добавляет режимы в коллекции (например, "Dark", "Mobile")

• figma_rename_mode — Переименовывает существующие режимы

• figma_batch_create_variables — Создаёт до 100 переменных за один вызов (в 10–50 раз быстрее)

• figma_batch_update_variables — Обновляет до 100 значений переменных за один вызов

• figma_setup_design_tokens — Создаёт полную систему токенов (коллекция + режимы + переменные) атомарно — значения принимают ссылки в фигурных скобках DTCG ("{color.blue.600}"), которые разрешаются в реальные алиасы переменных

📌 Инструменты досок FigJam (локальный режим + облачный режим)

• figjam_create_sticky — Создаёт стикер с вариантами цвета

• figjam_create_stickies — Пакетно создаёт до 200 стикеров

• figjam_create_connector — Соединяет узлы линиями-коннекторами с подписями

• figjam_create_shape_with_text — Создаёт фигуры для блок-схем (ромб, эллипс и т. д.)

• figjam_create_table — Создаёт таблицы с данными ячеек

• figjam_create_code_block — Добавляет фрагменты кода с подсветкой синтаксиса

• figjam_auto_arrange — Раскладывает узлы сеткой, по горизонтали или по вертикали

• figjam_get_board_contents — Читает всё содержимое доски FigJam

• figjam_get_connections — Читает граф соединений (блок-схемы, связи)

🎞️ Инструменты для презентаций Slides (локальный режим + облачный режим)

• figma_list_slides — Перечисляет все слайды с ID, позициями и статусом пропуска

• figma_get_slide_content — Возвращает полное дерево содержимого слайда

• figma_get_slide_grid — Возвращает 2D-сетку макета презентации

• figma_get_slide_transition — Читает настройки перехода для слайда

• figma_get_focused_slide — Возвращает текущий сфокусированный слайд

• figma_create_slide — Создаёт новый пустой слайд

• figma_delete_slide — Удаляет слайд из презентации

• figma_duplicate_slide — Клонирует существующий слайд

• figma_reorder_slides — Изменяет порядок слайдов через новую 2D-сетку

• figma_set_slide_transition — Устанавливает эффекты переходов (22 стиля, 8 кривых)

• figma_skip_slide — Переключает, пропускается ли слайд в режиме презентации

• figma_add_text_to_slide — Добавляет текст на слайд с настраиваемыми шрифтами, цветами, выравниванием и переносом

• figma_add_shape_to_slide — Добавляет фигуры прямоугольника или эллипса с цветом

• figma_set_slide_background — Устанавливает цвет фона слайда (создаёт или обновляет)

• figma_get_text_styles — Возвращает все локальные текстовые стили с ID, шрифтами и размерами

• figma_set_slides_view_mode — Переключает вид сетки и вид одного слайда

• figma_focus_slide — Переходит к конкретному слайду

📖 Подробная документация по инструментам

📖 Примеры запросов

Облачный режим (веб-клиенты ИИ)

Connect to my Figma plugin so we can start designing
Pair with my Figma file and create a login form with email, password, and submit button
Set up a brand color token collection with Light and Dark modes

Отладка плагинов

Navigate to my Figma plugin and show me any console errors
Watch the console for 30 seconds while I test my plugin
Get the last 20 console logs

Извлечение дизайн-системы

Get all design variables from https://figma.com/design/abc123
Extract color styles and show me the CSS exports
Get the Button component with a visual reference image
Get the Badge component in reconstruction format for programmatic creation

Создание дизайна (локальный режим + облачный режим)

Create a success notification card with a checkmark icon and message
Design a button component with hover and disabled states
Build a navigation bar with logo, menu items, and user avatar
Create a modal dialog with header, content area, and action buttons
Arrange these button variants into a component set
Organize my icon variants as a proper component set with the purple border

Управление переменными (локальный режим + облачный режим)

Create a new color collection called "Brand Colors" with Light and Dark modes
Add a primary color variable with value #3B82F6 for Light and #60A5FA for Dark
Rename the "Default" mode to "Light Theme"
Add a "High Contrast" mode to the existing collection

Паритет дизайна и кода

Compare the Button component in Figma against our React implementation
Check design parity for the Card component before sign-off
Generate component documentation for the Dialog from our design system

Доски FigJam

Create a retrospective board with "Went Well", "To Improve", and "Action Items" columns
Build a user flow diagram for the checkout process with decision points
Read this brainstorming board and summarize the key themes
Generate an affinity map from these meeting notes
Create a comparison table of our three platform options

Презентации Slides

List all slides and tell me which ones are skipped
Add a new slide with the title "Thank You" in 72px text
Set a DISSOLVE transition on the first slide with 0.5 second duration
Duplicate slide 5 for an A/B comparison
Skip slides 8 and 9 — they're not ready for the client presentation
Reorder my slides so the conclusion comes before Q&A

Визуальная отладка

Take a screenshot of the current Figma canvas
Navigate to this file and capture what's on screen

📖 Дополнительные примеры и варианты использования

🎨 Создание дизайна с помощью ИИ

Требуется Desktop Bridge: эта функция работает в локальном режиме (NPX или локальный Git) и в облачном режиме. Удалённый SSE без сопряжения с облачным режимом доступен только для чтения и не может создавать или изменять дизайны.

Одна из самых мощных возможностей этого MCP-сервера — способность создавать полноценные UI-компоненты и страницы прямо в Figma через диалог на естественном языке с любым MCP-совместимым ИИ-ассистентом, например Claude Desktop или Claude Code.

Что возможно

Создание оригинальных дизайнов с нуля:

Design a login card with email and password fields, a "Forgot password?" link,
and a primary Sign In button. Use 32px padding, 16px border radius, and subtle shadow.

Использование существующих библиотек компонентов:

Build a dashboard header using the Avatar component for the user profile,
Button components for actions, and Badge components for notifications.

Генерация полноценных макетов страниц:

Create a settings page with a sidebar navigation, a main content area with form fields,
and a sticky footer with Save and Cancel buttons.

Как это работает

1. Вы описываете, что хотите, на простом английском

2. ИИ ищет в вашей библиотеке компонентов с помощью figma_search_components, чтобы найти подходящие строительные блоки

3. Компоненты инстанцируются с правильными вариантами и свойствами через figma_instantiate_component

4. Кастомные элементы создаются с использованием полного Figma Plugin API через figma_execute

5. Визуальная проверка автоматически делает скриншоты и повторяет итерации, пока дизайн не будет выглядеть правильно

Кому это полезно

Примеры рабочих процессов

Новый дизайн с нуля:

«Создай тост-уведомление с иконкой слева, заголовком и описанием, а также кнопкой закрытия. Используй наши фирменные цвета.»

ИИ создаёт кастомные фреймы, применяет ваши дизайн-токены и собирает компонент с нуля.

Композиция компонентов:

«Собери карточку профиля пользователя, используя компонент Avatar (большой размер), два компонента Button (Edit Profile и Settings) и Badge для статуса пользователя.»

ИИ ищет в вашей библиотеке, находит точные компоненты и собирает их с правильными отступами и выравниванием.

Итерация дизайна:

«Отступы слишком плотные. Увеличь расстояние между секциями до 24px и сделай заголовок крупнее.»

ИИ изменяет существующий дизайн, делает скриншот для проверки и продолжает итерации, пока вы не будете довольны.

Визуальная проверка

После создания дизайнов ИИ автоматически выполняет процесс проверки:

1. Создание → выполнение кода дизайна

2. Скриншот → захват результата

3. Анализ → проверка выравнивания, отступов и визуального баланса

4. Итерация → исправление обнаруженных проблем

5. Проверка → финальный скриншот для подтверждения

Это гарантирует, что дизайны не просто технически корректны — они выглядят правильно.

🎨 Плагин Desktop Bridge (рекомендуемое подключение)

Плагин Figma Desktop Bridge — рекомендуемый способ подключения Figma к MCP-серверу. Он взаимодействует через WebSocket — специальные флаги запуска Figma не нужны, и подключение сохраняется между перезапусками Figma.

Настройка

1. Откройте Figma Desktop (обычный запуск — флаги отладки не нужны)

2. Перейдите в Плагины → Разработка → Импортировать плагин из манифеста...

3. Выберите figma-desktop-bridge/manifest.json из каталога figma-console-mcp

4. Запустите плагин в вашем файле Figma — он автоматически подключится через WebSocket (сканирует порты 9223–9232)

5. Спросите вашего ИИ: «Проверь статус Figma», чтобы убедиться в подключении

Одноразовый импорт. После импорта плагин остаётся в списке плагинов разработки. Просто запускайте его всякий раз, когда хотите использовать MCP.

📖 Документация Desktop Bridge

Возможности

Операции чтения:

• Переменные без Enterprise API

• Надёжные описания компонентов (в обход ошибок API)

• Поддержка нескольких режимов (варианты Light/Dark/Brand)

• Отслеживание выделения в реальном времени и мониторинг изменений документа

Операции записи:

• Создание дизайна — создание фреймов, фигур, текста и компонентов через figma_execute

• Управление переменными — полный набор операций CRUD над переменными и коллециями

• Управление режимами — добавление и переименование режимов для поддержки нескольких тем

Как работает транспорт

• MCP-сервер взаимоействует через WebSocket с помощью плагина Desktop Bridge

• Сервер сначала проует порт 9223, а при необходимости автоматически переирает порты 9224–9232

• Плагин сканирует все порты в диапазоне и подключается ко всем найденным активным серверам

• Весь 121 инструмент работает через WebSocket-транспорт

Несколько файлов: WebSocket-сервер поддерживает несколько одновремеенных подклчений плагина — по одному на каждый открытый файл Figma. Каждое подклчение отслеживается по клчу файла и имеет независимое состояние (выделение, изменения документа, журналы консоли).

Переменные окружения:

• FIGMA_WS_PORT — переопределяет предпочитаемый WebSocket-порт (по умолчанию: 9223). Если предпочитаемый порт занят, сервер переирает диазон из 10 портов, начиная с этого значения.

• FIGMA_WS_HOST — переопределяет адрес привязки WebSocket-сервера (по умолчанию: localhost). Установите 0.0.0.0 при запуске в Docker, чтобы хост-машина могла подключиться к MCP-серверу.

Cloud Mode: Плагин также поддерживает переключатель Cloud Mode для сопряжения с веб-клиентами ИИ (Claude.ai, v0, Replit, Lovable). Переключите «Cloud Mode» в интерфейсе плагина, введите 6-значный код сопряжения от вашего ИИ-ассистента и нажмите Connect. Подробнее см. в разделе Cloud Mode.

Ограничение плагина: в Local Mode работает с NPX или локальным Git. В Cloud Mode выолняется сопряжение с удалённым MCP-эндпоинтом. Remote SSE без сопряжения Cloud Mode доступен только для чтения.

🔀 Поддержка нескольких экземпляров (v1.10.0)

Figma Console MCP теперь поддерживает несколько одновременных экземпляров — идеально для дизайнеров и разработчиков, которые работают над несколькими проектами или используют вкладки Chat и Code в Claude Desktop одновременно.

Проблема (до v1.10.0)

Когда два процесса пытались запустить MCP-сервер (например, вкладки Chat и Code в Claude Desktop), второй процесс аварийно завершался с ошибкой EADDRINUSE, поскольу оба конкурировали за порт 9223.

Как это работает сейчас

• Сервер сначала пробует порт 9223 (по умолчанию)

• Если этот порт занят, он автоматически проует 9224, затем 9225 и так дале до 9232

• Плагин Desktop Bridge в Figma подключается ко всем активным серверам одновремеенно

• Каждый экземпляр сервера получает событи в реальном времени (изменения выделения, изменения документа, журналы консоли)

• figma_get_status показывает, на каком порту вы находитесь, и перечисляет другие активные экземпляры

Что это значит для вас

Нужно ли что-то делать?

Ничего. Поддержка нескольких экземпляров полность автоматическая:

• Каждый MCP-сервер занимает следующий доступный порт в диапазоне

• Плагин Desktop Bridge сканирует все порты и подключается к каждому активному серверу

• Осиротевшие процессы от закрытых вкладок автоматически очищаются при запуске

• Никакого ручного управления портами — плагин уже сканирует весь диапазон

(Повторный импорт манифеста требутся только тогда, когда меняется сам код плагина — например, после обновления пакета. Сканирование диапазона портов уж встроено в поставляемый плагин.)

MCP Apps (экспериментально)

Figma Console MCP включает подержку MCP Apps — насыщенных интерактивных UI-интерфейсов, которые рендерятся прямо внутри любого MCP-клиента, подерживающего расширение протокола MCP Apps. Создан с помощью официального SDK @modelcontextprotocol/ext-apps.

Что такое MCP Apps? Обычные MCP-инструменты возвращают ИИ текст или изображения. MCP Apps идут дальше — они рендерят интерактивные HTML-интерфейсы прямо в чате, позволяя пользователям просматривать, фильтровать и взаимоействовать с данными напрямую, не расходуя контекст ИИ.

Token Browser

Интерактивный обозреватель дизайн-токенов.

Использование: Попросите Claude «просмотреть дизайн-токены» или «показать дизайн-токены», когда он подключён к файлу Figma.

Возможности:

• Просмотр всех токенов, сгруппированных по коллекциям, с раскрывающимися секциями

• Фильтрация по типу (Colors, Numbers, Strings) и поиск по названию/описанию

• Столбцы режимов для каждой коллекции (Light, Dark, Custom), соответствующие панели переменных Figma

• Цветовые образцы, разрешение алиасов и копирование по клику для любого значения

• Работает без плана Enterprise через Desktop Bridge (локальный режим)

Design System Dashboard

Оценочная карта состояния в стиле Lighthouse, которая проверяет вашу дизайн-систему по шести категориям.

Использование: Попросите Claude «провести аудит дизайн-системы» или «показать состояние дизайн-системы», когда он подключён к файлу Figma.

Возможности:

• Итоговая взвешенная оценка (0–100) с шестью шкалами по категориям: Naming, Tokens, Components, Accessibility, Consistency, Coverage

• Раскрывающиеся секции категорий с отдельными замечаниями, индикаторами серьёзности и практическими рекомендациями

• Диагностические ссылки, связывающие замечания с конкретными переменными, компонентами или коллекциями

• Всплывающие подсказки, объясняющие назначение каждой проверки и критерии оценки

• Кнопка Refresh для повторного запуска аудита без расходования контекста ИИ

• Чистый механизм оценки без внешних зависимостей — весь анализ выполняется локально

Нет поддержки MCP Apps? Тот же аудит, обычный инструмент: figma_audit_design_system_report использует тот же механизм оценки и возвращает отчёт в виде данных — сводку по умолчанию, детализацию по категориям через category, полный JSON через format: "full" — а также раздел с рекомендациями, в котором указано, какие замечания этот MCP может исправить сам (design), какие требуют сначала дизайн-решения (design-assisted), а какие — ручной работы дизайнера (manual). Работает в любом MCP-клиенте без флага ENABLE_MCP_APPS; результаты кэшируются на 5 минут (forceRefresh для поворного обхода).

Включение MCP Apps:

MCP Apps влючены по умолчанию в конфигурациях настройки выше (через "ENABLE_MCP_APPS": "true"). Если вы настраивали всё до v1.10.0 и в вашей конфигурации этого нет, добавьте это в секцию env:

"env": {
  "FIGMA_ACCESS_TOKEN": "figd_YOUR_TOKEN_HERE",
  "ENABLE_MCP_APPS": "true"
}

Примечание: MCP Apps требуют MCP-клиента с подержкой протокола ext-apps (например, Claude Desktop). Эта функция экспериментальна, и протокол может развиваться.

Планы развития MCP Apps

Запланированные MCP Apps:

• Component Gallery — визуальный браузер для поиска и предпросмотра компонентов с исследованием вариантов

• Style Inspector — интерактивная панель для изуения стилей цвета, текста и эффектов с живым предпросмотром

• Variable Diff Viewer — сравнение значений токенов бок о бок в разных режимах и ветках

Архитектура подерживает добавление новых приложений с минимальным шаблонным кодом — каждое приложение представает собой самостоятельный модуль с собственной регистрацией инструментов на сервере и пользовательским интерфейсом на клиенте.

Дополнительные темы

• Руководство по настройке — полное руководство по настройке для всех MCP-клиентов

• Самостоятельное размещение — разверните собственный экземпляр на Cloudflare

• Архитектура — как это работает под капотом

• Настройка OAuth — настройте OAuth для самостоятельного размещения

• Устранение неполадок — частые проблемы и решения

🤝 Сравнение с официальным MCP Figma

Figma Console MCP (этот проект) — отладка, извлечение данных и создание дизайна

• ✅ Журналы консоли Figma в реальном времени

• ✅ Снимки экрана и визуальная отладка

• ✅ Трассировки стека ошибок и мониторинг времеи выолнения

• ✅ Извлечение сырых данных дизайна (JSON)

• ✅ Создание и чтение досок FigJam (стикеры, блок-схемы, таблы)

• ✅ Работает удалённо или локально

Figma Official Dev Mode MCP — генерация кода

• ✅ Генерирует код React/HTML из дизайнов

• ✅ Генерация классов Tailwind/CSS

• ✅ Создание каркаса компонентов (boilerplate)

Используйте оба вместе для полного рабочего процесса: генерируйте код с помощью Official MCP, затем отлаживайте и извлекайте данные с помощью Console MCP.

️ Дорожая карта

Текущий статус: v1.40.0 (Stable) - Production-ready. Последнее: извлечение дизайн-системы из production-кодовых баз — семь инструментов Local-Mode figma_ds_*, которые сканируют одно или несколько приложений (определение фреймворка/стилизации/вендора, инвентаризация компонентов с ранжированием по использованию и классификацией vendored/wrapped/pure-vendor/bespoke, вывод вариантов на основе реальных мест вызова, обнаружение дубликатов и архитектурный проход, отделяющий специализации UI-kit от отсутствующих generic-примитивов), извлекают фактическую стилизацию в DTCG-токены с указанием происхождения каждого токена (мультимодальные CSS custom properties, SCSS, Tailwind config, shadcn HSL-триады, частотный анализ utility-классов с оценкой на основе собственной темы приложения), создают каркас пакета дизайн-системы с демонстрационными страницами документации, подключают свежий Storybook-воркшоп к реальным слоям темы и шрифтам приложения, глубоко извлекают компоненты для переноса с CSF3-скаффолдами историй, проверяют с помощью детерминированных оценок точности (fidelity evals) и сохраняют прогресс переноса между сессиями — извлечённые токены импортируются напрямую в переменные Figma через figma_import_tokens. Поверх исправления v1.39.1 для баннера обновления плагина, который невозможно было закрыть, — более старый экземпляр сервера требовал от более нового плагина повторного импорта, что лишь устанавливало тот же или более новый плагин. Поверх многофайлового выполнения из v1.39.0 — figma_execute_across_files запускает один скрипт одновременно против нескольких файлов, подключённых через Desktop Bridge (четыре файла × 2 секунды работы за ~3 секунды, а не ~8 секунд), а figma_execute принимает необязательный fileKey для нацеливания на один файл без перемещения активного файла или снятия целевой блокировки; нацеливание должно быть явным (fileKeys или allFiles: true), поэтому ничего не расходится по файлам, которые вы не называли. Из комьюнити-PR #107 от @Wolfr. Поставляется с исправлением ретрансляции: handleResult() в ui.html плагина пересобирал каждый ответ поле за полем и молча отбрасывал resultAnalysis и fileContext, поэтому проверка resultAnalysis.warning, которую собственное описание figma_execute предписывает выполнять вызывающей стороне, никогда не была возможна (повторно импортируйте manifest.json ради этих двух полей; всё остальное работает и без этого). Поверх исправления стабильности соединения из v1.38.2 — собственный сборщик осиротевших процессов сервера завершал здоровые MCP-серверы, потому что его liveness-проба использовала IPv4-литерал, тогда как сервер привязывается к IPv6 loopback, что превращало каждый предохранитель от завершения в пустую формальность; это было причиной повторяющихся ошибок «Server disconnected». Наряду с исправлением v1.38.1 для инструментов переменных общей библиотеки, которые с v1.29.0 молча сообщали о нулевом количестве коллекций и выдавали неудачные импорты за успешные. Поверх постоянных журналов изменений компонентов в генерируемой документации из v1.38.0 — figma_generate_component_doc принимает опциональный параметр history, который извлекает историю дизайна по каждому компоненту из истории версий Figma (каждая версия диффится и ограничивается этим компонентом, поэтому переименования, добавленные свойства и привязки токенов отображаются строками) вместе с историей кода из git log по исходным файлам компонента, и всё рендерится в виде раздела ## History с таблицами дизайна, кода и примечаний к релизу. Предпочитает именованные версии, переключается на автосохранения, если в файле их нет, и по умолчанию выключен, поэтому существующие вызовы не меняются (только на стороне сервера, повторный импорт плагина не требуется). Поверх аудита здоровья дизайн-системы для каждого клиента из v1.37.x — figma_audit_design_system_report запускает детерминированный движок оценки по шести категориям из дашборда и возвращает отчёт в виде данных с рекомендациями по устранению для каждой находки, live-first данными, проверяемыми по fileKey (источник раскрыт), детализацией по категориям порциями и 5-минутным кэшем (только на стороне сервера, повторный импорт плагина не требуется). Поверх целевой блокировки для параллельной работы с несколькими файлами из v1.36.0 — — figma_navigate принимает флаг lock: true, который закрепляет активный файл, чтобы ИИ-агент мог работать в одном файле, пока вы работаете в другом, без маршрутизации команд не в тот файл. Поверх поддержки записи в Figma Slots из v1.35.0 — создание, просмотр, заполнение и сброс слотов (GA на Config 2026) через 5 новых инструментов (figma_create_slot, figma_get_slots, figma_append_to_slot, figma_reset_slot, figma_add_slot_property), проверенных в реальном времени против GA Plugin API и основанных на комьюнити-PR #77. Поверх двунаправленной синхронизации токенов v2 + DTCG 2025.10 из v1.34.0 — figma_import_tokens применяет полный план диффа (создаёт недостающие коллекции/переменные, применяет переименования, записывает настоящие ссылки VARIABLE_ALIAS и удаляет только при явном replace), figma_export_tokens по запросу говорит на диалекте DTCG 2025.10 (в legacy-режиме по умолчанию байт-идентичен), области видимости переменных/codeSyntax проходят полный цикл через $extensions, figma_setup_design_tokens принимает значения алиасов через DTCG-ссылки в фигурных скобках, а figma_create_component_set за один вызов собирает полный набор вариантов из матрицы осей. Поверх линейки v1.33.x: исправление рукопожатия версий (баннер повторного импорта срабатывает, только когда файлы плагина действительно изменились), зачистка уязвимостей зависимостей и капитальная переработка UX соединения в v1.33.0 (честный статусный индикатор на основе живого состояния соединения, автообнаружение /health с самовосстанавливающимся переподключением) + аудит всей кодовой базы с 33 исправлениями (многорежимные DTCG-циклы без потерь, разрешение алиасов между коллекциями, корректность branch-URL во всех REST-инструментах, исправления cache-poisoning и CSWSH, скриншоты в первую очередь через bridge). В основе — точный по WCAG аудит доступности (высота строки ниже 1.5× больше не помечается ошибочно как нарушение; подсказки по читабельности отделены от проверок соответствия и ограничены многострочным текстом; проверка WCAG 1.4.12 на стороне кода), самовосстанавливающееся соединение Desktop Bridge (сборщик зомби-процессов + watchdog автопереподключения — устраняет повторяющийся баг «не подключено до перезапуска»), нативная привязка переменных к заливкам/обводкам + управление типографикой в инструментах записи, инспекция общей библиотеки (разрешение компонентов по ключу + чтение/импорт переменных библиотеки без плана Enterprise), конвейер экспорта токенов в 10 форматах (DTCG, CSS, Tailwind v4, Tailwind v3, SCSS, TS module, JSON flat/nested, Style Dictionary v3, Tokens Studio), двунаправленная синхронизация токенов Figma↔код, осведомлённость об истории версий и временных рядах, поддержка FigJam + Slides, Cloud Write Relay, Design System Kit, только WebSocket-соединение, умное отслеживание нескольких файлов, 121 инструмент (Local) / 101 инструмент (Cloud) / 9 инструментов (Remote read-only), Comments API, устранение неоднозначности identity между MCP, и MCP Apps.

Недавние релизы:

• v1.40.0 — Извлечение дизайн-системы. Семь новых инструментов, работающих только в Local-режиме, которые превращают производственную кодовую базу в дизайн-систему, плюс поддерживающий их движок извлечения. figma_ds_analyze сканирует одну или несколько кодовых баз приложения: определение фреймворка/стилизации/слоя вендора (React/Next/Angular/Web Components; Tailwind v3/v4, CSS Modules, SCSS, Emotion, styled-components; shadcn/ui, Radix, MUI, Chakra…), ранжированный по использованию инвентарь компонентов с классификацией vendored/wrapped/pure-vendor/bespoke, контрактами пропсов, выводом вариантов из реальных мест вызова, обнаружением дубликатов, захватом иконографии и типографики, а также классификацией архитектуры, отделяющей UI-кит от дизайн-системы (атомарные уровни, специализации вроде FollowButton → Button, отсутствующие обобщённые примитивы). figma_ds_extract_tokens извлекает фактическую стилизацию в DTCG-токены — мультирежимные CSS custom properties в соглашениях .dark/[data-theme], SCSS-переменные, значения конфига Tailwind, HSL-тройки shadcn, частотный анализ utility-классов Tailwind, оцениваемый по собственной теме приложения, и повышаемые по частоте сырые значения — с провенансом каждого токена в $extensions, импортируемые прямо в переменные Figma через figma_import_tokens. figma_ds_scaffold генерирует пакет (файлы токенов через общие форматтеры, страницы-витрины токенов/типографики/иконографии); figma_ds_setup_storybook подключает свежую мастерскую Storybook к реальным слоям темы и шрифтам приложения; figma_ds_extract_component создаёт по-компонентные манифесты переноса с CSF3-заготовками историй; figma_ds_verify контролирует результат детерминированными оценками точности плюс готовностью к round-trip в Figma; figma_ds_status сохраняет прогресс переноса между сессиями. Также исправляет форматтеры CSS/SCSS/Tailwind v4, заключавшие функциональные выражения CSS в кавычки (закавыченный cubic-bezier(...) молча убивает переходы — затрагивает и figma_export_tokens). Только сервер, повторный импорт плагина не требуется.

• v1.39.1 — Баннер обновления плагина невозможно было сбросить. computePluginUpdateAvailable() представлял собой голое неравенство без проверки направления, поэтому сервер, чья встроенная копия плагина была СТАРШЕ подключённого плагина, всё равно сообщал пользователю о необходимости повторного импорта — а он всегда устанавливает только тот же или более новый плагин. Это не крайний случай: диапазон портов 9223–9232 поддерживает несколько живых экземпляров сервера, BUNDLED_PLUGIN_VERSION парсится один раз при загрузке модуля, и каждый сервер, оставшийся запущенным после обновления, досаждает корректно обновлённому плагину. Воспроизведено вживую с четырьмя оставшимися серверами v1.38.2 против свежепереимпортированного плагина 1.39.0. Теперь флаг выставляется только когда встроенная копия действительно новее. Только сервер, повторный импорт плагина не требуется. 1452 теста.

• v1.39.0 — Многофайловое выполнение. Новый figma_execute_across_files запускает один скрипт против нескольких файлов, подключённых через Desktop Bridge, конкурентно, с изоляцией ошибок по каждому файлу и независимыми таймаутами (проверено вживую: четыре файла × 2 секунды работы за ~3,0 с, все отправки в пределах 5 мс — против ~8 с последовательно). figma_execute получил опциональный fileKey для нацеливания на один неактивный файл без перемещения активного файла или снятия целевой блокировки. Нацеливание намеренно явное — fileKeys или allFiles: true, без развёртки-на-всё-по-умолчанию — потому что это выполняет произвольный код в файлах, которые вы можете активно редактировать, включая закреплённый целевой блокировкой. Транспорт уже был конкурентным (sendCommand всегда принимал ключ целевого файла, и каждый хоп привязан к request-id); не хватало только слоя инструментов. Community PR #107 от @Wolfr. Также исправляет ошибку ретрансляции Desktop Bridge, которая молча теряла resultAnalysis и fileContext из каждого ответа figma_execute с момента их появления — делая проверку resultAnalysis.warning, которую описание инструмента велит выполнять вызывающим, невозможной — теперь защищено тестом, читающим реальные файлы плагина. Переимпортируйте manifest.json ради этих двух полей; остальное работает и без него, а смешанные версии плагина деградируют корректно. 52 набора / 1443 теста.

• v1.38.2 — Стабильность соединения: сборщик осиротевших процессов завершал здоровые MCP-серверы — причину повторяющихся ошибок «Server disconnected» во всех MCP-клиентах (воспроизведено и в Claude Code, и в Claude Desktop; к плагину Desktop Bridge отношения не имеет). Сборщик проверяет /health соседа, прежде чем решить, что тот мёртв, но запрашивал 127.0.0.1, тогда как WebSocket-сервер привязывается к localhost — на двухстековом macOS это разрешалось в IPv6-петлю, где на IPv4 ничего нет, — поэтому проверка сообщала «ничего не отвечает» для здоровых серверов, и все построенные на ней защитные механизмы убийства стали пустой формальностью, включая тот, что был написан для защиты соседей после сна машины. Три сопутствующих дефекта: файлы портов записывались неатомарно (читатель, попавший в середину перезаписи, получал ошибку парсинга, которую оба пути очистки трактовали как «повреждён, удалить», оставляя здоровый сервер без порта), путь осиротевших процессов завершал держателей портов без файла вообще без проверки, и heartbeat навсегда сдавался, как только пропадал его собственный файл. Исправления: проверка localhost, атомарная запись temp+rename, никакого удаления при ошибке парсинга, проверка здоровья перед убийством осиротевших в обоих путях и самовосстанавливающаяся повторная публикация, защищённая владением порта в рамках процесса. Полностью перезапустите MCP-клиенты после обновления — старые запущенные сборки сохраняют сломанную проверку и по-прежнему завершают здоровых соседей. Только сервер, повторный импорт плагина не требуется. 1422 теста (7 новых регрессий, каждая проверена как падающая до исправления).

• v1.38.1 — Исправлены инструменты переменных общей библиотеки. figma_get_library_variables возвращал totalCollections: 0 для каждого файла, на каждом тарифе, с момента появления в v1.29.0, а figma_import_library_variable сообщал о неудачных импортах как об успешных с id: undefined. Оба читали конверт { success, result } Desktop Bridge так, будто это голое возвращаемое значение внедрённого скрипта, поэтому Array.isArray() всегда был ложным, защита __error была мёртвым кодом, а .id всегда был undefined. Сбой выглядел как успех с правдоподобной подсказкой («подпишите библиотеку через панель Assets»), поэтому два месяца оставался незамеченным. Оба инструмента теперь распаковывают через общий хелпер, который также переводит success: false уровня моста на путь ошибки, так что таймаут плагина всплывает как настоящая ошибка, а не проглатывается как «0 коллекций»; импорт без id теперь явная ошибка. Проверены все 26 мест вызова executeCodeViaUI — затронуты только эти два. Тестовые моки закодировали контракт провода, которого не существует, поэтому CI оставался зелёным; теперь они воспроизводят реальный конверт, плюс шесть регрессионных тестов, проверенных как падающие на исходнике до исправления. Сообщено Изабеллой Минзли. Только сервер — повторный импорт плагина не требуется.

• v1.38.0 — Постоянные журналы изменений компонентов в генерируемой документации. figma_generate_component_doc получил опциональный параметр history, который выдаёт настоящий журнал изменений вместо простого повторения строк codeInfo.changelog, написанных вручную: history.figma проходит по истории версий Figma и вычисляет разницу каждой последовательной пары в пределах компонента (переиспользуя тот же движок, что и figma_diff_versions, так что переименование, недавно добавленное свойство компонента или привязка токена становятся строкой), а history.git выполняет git log по исходным файлам компонента, автоматически выведенным из codeInfo.filePath / sourceFiles[]. Именованные версии предпочтительны, но автосохранения используются автоматически, если в файле их нет — проверено на зрелой системе с 72 автосохранениями и 0 именованных версий, где проход только по именованным ничего не даёт. В подробном режиме привязки группируются по свойству (привязка одного токена к набору из 24 вариантов иначе давала 44 почти одинаковых пункта в одной ячейке таблицы). Оба источника по умолчанию выключены, поэтому существующие вызывающие получают побайтно идентичный вывод. Новых инструментов нет; только сервер, повторный импорт плагина не требуется.

• v1.37.0 — Аудит здоровья дизайн-системы для каждого MCP-клиента. Новый figma_audit_design_system_report запускает детерминированный движок оценки Design System Dashboard (именование, архитектура токенов, метаданные компонентов, доступность, согласованность, покрытие) и возвращает оценённый отчёт как данные — без поддержки MCP Apps или ENABLE_MCP_APPS (прежняя регистрация блокировала всё, делая аудит недостижимым вне Claude Desktop). Данные о компонентах теперь в первую очередь живые: проверяемый по fileKey постраничный обход через мост (30 с/страница, сбои изолированы постранично) с запасным вариантом REST опубликованной библиотеки, а выбранный источник раскрывается в отчёте (bridge-live / rest-published / none), чтобы устаревшие оценки публикации не могли маскироваться под живые. Вывод безопасен для токенов по построению: ограниченная сводка, по-категорийный детализированный вывод порциями, усечённый полный JSON, 5-минутный кэш сырых данных. Каждая находка несёт вердикт по исправлению — автоматически исправимо инструментами записи этого MCP, исправимо после дизайн-решения или вручную — с указанием точных инструментов. Проход по точности оценки: вариантные компоненты больше не отравляют проверки PascalCase/регистра, принимается Title Case, имена компонентных наборов учитываются в покрытии базовых компонентов, color/content/* распознаётся в контрастных парах, синонимы состояний (active≈pressed и т. д.), а внутренности с префиксом ./_ исключаются. Только сервер — повторный импорт плагина не требуется.

• v1.36.0 — Целевая блокировка для многофайловой параллельной работы. figma_navigate получает флаг lock: true, закрепляющий активный файл — новые подключения, переподключения и собственные выборы/смены страниц пользователя в других файлах больше не перемещают цель команды, так что агент может безопасно писать в один файл, пока пользователь работает в другом. Автоснятие при отключении закреплённого файла или уходе из него; figma_list_open_files сообщает флаг targetLocked для защит перед записью. Только сервер — повторный импорт плагина не требуется.

• v1.35.0 — Поддержка записи Figma Slots, закрывающая #29 (самую запрашиваемую функцию трекера) через community PR #77 от @simonesalvucci, обновлённый до GA API. Пять новых инструментов: figma_create_slot (слот + автоматически связанное свойство SLOT; варианты внутри компонентных наборов поддерживаются — бета-ограничение снято на GA), figma_get_slots, figma_append_to_slot (клонирование или создание контента в слотах экземпляров; клоны привязываются к началу слота), figma_reset_slot и figma_add_slot_property (дооснащение существующего фрейма слотом). Укреплено живой валидацией: восстановлен проброс defaultValue для VARIANT (Figma требует непустого значения), переупорядочивание деструктивного пути в обработчике добавления (контент валидируется до того, как clearExisting что-либо опустошит), исправление белого списка ретрансляции для полезных нагрузок slot. Требуется повторный импорт плагина (code.js + ui.html изменены).

• v1.34.0 — Двунаправленная синхронизация токенов v2 + DTCG 2025.10. figma_import_tokens теперь применяет полный план диффа: недостающие коллекции и переменные создаются (с режимами, выведенными/записанными типами и значениями, устанавливаемыми в порядке зависимостей — алиасы вторым проходом), переименования путей токенов направляются в фазу обновления по round-trip ID переменной (никаких пар create+delete, которые при replace навсегда уничтожили бы оригинал), ссылочные значения пишут настоящие полезные нагрузки { type: "VARIABLE_ALIAS", id } через четырёхуровневый резолвер, а удаления строго ограничены strategy: "replace". figma_export_tokens получает dtcgDialect: "2025" (цвета в объектной форме из чисел с полной точностью, объектные размеры), тогда как устаревшее значение по умолчанию остаётся побайтно идентичным; импорт принимает оба диалекта безусловно с нормализацией диффа, нечувствительной к диалекту. scopes и codeSyntax переменных проходят round-trip через $extensions["figma-console-mcp"]. figma_setup_design_tokens принимает DTCG-ссылки в фигурных скобках ("{color.blue.600}"), разрешающиеся в реальные алиасы, включая прямые ссылки. Новый инструмент figma_create_component_set строит набор вариантов из матрицы осей (или объединяет существующие компоненты) с именованием Prop=Value, опциональной авторазложенной сеткой и ключами вариантов в ответе — с таймаутами, масштабируемыми по количеству, и откатом при сбое. Требуется повторный импорт плагина (code.js + ui.html изменены — обработчик компонентных наборов и ретрансляция). 183 теста в наборах токенов/инструментов записи.

• v1.33.2 — Исправление ложного срабатывания рукопожатия версий. Рукопожатие v1.33.0 сравнивало сообщаемую плагином версию с пакетной версией сервера, поэтому релизы только для сервера (как зачистка зависимостей v1.33.1) помечали каждый актуальный плагин как устаревший и показывали баннер повторного импорта для файлов, которые не менялись. Сервер теперь сравнивает с PLUGIN_VERSION, встроенной в поставляемый им figma-desktop-bridge/code.js — ровно то, что установил бы повторный импорт, — а сама PLUGIN_VERSION теперь означает «последний релиз, в котором менялись файлы плагина» (инструментарий релизов поднимает её только когда figma-desktop-bridge/ действительно менялся с прошлого тега). figma_get_status получает transport.websocket.bundledPluginVersion; figma_diagnose указывает на правильную версию. Новых инструментов нет, повторный импорт плагина не требуется (разовое исключение: если вы переимпортировали на v1.33.1, баннер появится ещё раз — снимите его финальным повторным импортом). 1245 тестов проходят (9 новых).

• v1.33.1 — Зачистка зависимостей безопасности. Все предупреждения npm audit времени выполнения и критические устранены обновлениями в пределах диапазона (ws 8.21.0, hono 4.12.27, undici 7.28.0, handlebars 4.7.9 — единственное критическое, только для разработки — плюс lodash, path-to-regexp, basic-ftp, fast-uri, vite). wrangler намеренно удержан на 4.72.0, поскольку новые версии требуют Node ≥22; единственные остаточные находки аудита — внутри dev-инструментария wrangler/miniflare, который никогда не попадает в npm-пакет или Worker-бандл. Заменяет dependabot PR #81/#82/#84. Без изменений кода, без изменений API, без повторного импорта плагина. 1236 тестов проходят без изменений.

• v1.33.0 — Переработка UX подключения + аудит всей кодовой базы. Индикатор состояния плагина теперь выводится из живого состояния подключения, а не из загрузки переменных Figma (раньше он светился зелёным при нуле подключённых MCP-серверов); автообнаружение HTTP /health автоматически переподключает перезапущенные серверы (включая случай один-мёртв-среди-живых, ранее тупиковый); рукопожатие версий показывает баннер в UI плагина, когда нужен повторный импорт, и выводит расхождение в figma_get_status/figma_diagnose; конфигурация облачной пары переживает переоткрытие плагина, а её строка состояния выводится и подписана (никакого осиротевшего «Disconnected» под зелёной пилюлей); весь текст плагина — на языке дизайнера. Аудит исправил 33 подтверждённых проблемы: без потерь DTCG-мультирежимные round-trip, сет-квалифицированные алиасы между коллекциями, TIMING/EASING сопоставлены с DTCG duration/cubicBezier, две ошибки отравления кэша (отчёты «поиск возвращает 0 компонентов»), обход CSWSH-происхождения (startsWith → точное совпадение), защита сборщика после сна (плюс проверка /health без шелла с os.devNull, чтобы Windows curl не давал ложного отрицательного результата для здорового соседа), корректность branch-URL в REST-инструментах и мост-в-первую-очередь figma_take_screenshot. figma_arrange_component_set теперь переставляет варианты на месте, так что размещённые экземпляры выживают. Новых инструментов нет; требуется повторный импорт плагина (code.js + ui.html изменены — и новое рукопожатие делает это последним, о котором вам придётся узнавать самостоятельно). 1236 тестов проходят (33 новых).

• v1.32.1 — Исправление генератора документации, сообщённое Робином Ди Капуа: figma_generate_component_doc документировал цвета как сырые hex (с — в колонке Figma Variable), даже когда заливки/обводки были привязаны к переменным, тогда как токены отступов документировались корректно. Две первопричины — поиск id→имя, читавший не те ключи (.id/.name вместо variableId/variableName), и имена переменных, получаемые только из REST-эндпоинта /variables/local, доступного лишь на Enterprise (403 в остальных случаях). Генератор теперь разрешает имена через Plugin API Desktop Bridge (работает на любом тарифе) и прокидывает их в таблицы States, Color Tokens и Spacing, так что появляются настоящие имена токенов вроде color/content/default и spacing/1. Новых инструментов нет, форма аргументов не менялась, повторный импорт плагина не требуется. 1203 теста проходят.

• v1.32.0 — Исправление корректности аудита доступности, сообщённое Изабеллой (соавтором по a11y): figma_lint_design помечал высоту строки ниже 1,5× как нарушение доступности на сотнях компонентов. Это неверное прочтение WCAG 1.4.12 Text Spacing, которое требует, чтобы контент поддерживал пользовательские переопределения интервалов без потерь — а не чтобы дизайны поставлялись с 1,5×, — поэтому высота строки ниже 1,5 не является нарушением соответствия. Проверки межстрочного/межабзацного интервала теперь ограничены многострочным текстом (однострочные подписи и кнопки освобождены); подсказки читабельности (text-size, line-height, letter-spacing, paragraph-spacing) отделены от группы wcag в опциональную группу best-practice, так что аудит по умолчанию (['wcag','design-system','layout']) и rules: ['wcag'] возвращают только подлинное соответствие; а новая кодовая рекомендация text-spacing-support в figma_scan_code_accessibility помечает типографику с фиксированными px — где 1.4.12/1.4.4 действительно проверяемы. Новых инструментов нет, форма аргументов не менялась; требуется повторный импорт плагина для нового поведения аудита (протокол моста не менялся, так что непереимпортированный плагин остаётся совместимым). 1196 тестов проходят.

• v1.31.0 — Исправляет самый часто сообщаемый баг надёжности: обрыв соединения Desktop Bridge, остающийся вниз, пока вы не закроете плагин, не перезапустите MCP-клиент или не убьёте порты вручную. Первопричина — процессы-зомби MCP-серверов, оккупирующие диапазон портов WebSocket (9223–9232) после плохого завершения. Сборщик теперь эскалирует SIGTERM → SIGKILL (зависший сервер, игнорирующий корректное завершение, больше не может выжить), прочёсывает диапазон каждые 5 минут через периодический сборщик с unref'd, а предохранитель завершения не даёт серверу озомбироваться в принципе. Переработанный плагин Desktop Bridge добавляет сторожевой таймер автопереподключения (повторные проверки каждые ~12 с в отключённом состоянии), контекстно-зависимую кнопку Pause / Resume / Reconnect и живой значок счётчика серверов. Новых инструментов нет; требуется повторный импорт плагина (изменены ui.html + code.js моста). 1190 тестов проходят, включая интеграционный тест, порождающий реальный процесс, игнорирующий SIGTERM, и утверждающий, что сборщик его убивает.

• v1.30.0 — Нативная привязка переменных + типографика в структурированных инструментах записи, закрывающая пробелы Plugin API, которые раньше вынуждали использовать сырой figma_execute. figma_set_fills / figma_set_strokes принимают variableId для привязки заливки/обводки к переменной цвета через setBoundVariableForPaint (любой тариф, через мост). figma_set_text получает fontFamily / fontStyle с нормализацией, нечувствительной к пробелам (SemiBold → Semi Bold), и корректным запасным Regular. figma_instantiate_component предзагружает шрифты текста экземпляра перед применением переопределений (исправляет молча пропускаемые текстовые переопределения для ненасыщенных весов) и возвращает массив warnings для неудавшихся переопределений. Также исправляет краш со смешанными шрифтами в figma_set_text и ретрансляцию ui.html, терявшую новые поля сообщений. Новых инструментов нет; требуется повторный импорт плагина (изменены ui.html + code.js моста). Проверено вживую; 1185 тестов проходят.

• v1.29.2 — Исправление бага: figma_generate_component_doc теперь корректно отображает описания компонентов Figma и надёжно помечает атомарный уровень дизайна. Заголовки с одним # в описаниях рендерятся как настоящие разделы (Usage Guidelines, Implementation Considerations, Accessibility Requirements, Content Configuration) вместо утечки как пункты списка - # Heading; description во frontmatter берёт первое предложение вместо обрезания на слове «Accessibility»; генерируемый URL Figma больше не дублирует ?node-id=; а атомарный уровень компонента (atom/molecule/organism/template) автоопределяется через одиночный запрос файла ids=<node> + откат по разделителям, без зависимости от публикации библиотеки. Новых инструментов нет; повторный импорт плагина не требуется.

• v1.29.1 — Исправление бага: figma_get_design_system_kit теперь разрешает переменные мост-в-первую-очередь (Desktop Bridge / облачная ретрансляция → запасной REST) вместо прямого вызова REST API переменных, доступного только на Enterprise. Пользователи не-Enterprise больше не получают 403 в секции токенов набора при подключённом мосте, а REST-403 теперь указывает вызывающему на мост вместо тупика. 7 новых тестов, всего 1185 проходят. Новых инструментов нет; повторный импорт плагина не требуется.

• v1.29.0 — Инспекция общей библиотеки: три новых инструмента закрывают разрыв между «у меня есть ключ компонента» и «я действительно могу им пользоваться». figma_get_library_component_by_key разрешает любой 40-символьный ключ компонента в полные componentPropertyDefinitions + варианты (с их опубликованными ключами) + визуальные спецификации по вариантам — без необходимости URL файла исходной библиотеки. figma_get_library_variables перечисляет токены библиотеки через Plugin API (работает на любом тарифе Figma; REST-эквивалент доступен только на Enterprise). figma_import_library_variable импортирует токен библиотеки в текущий файл, чтобы его можно было привязать к узлам. 27 новых тестов, всего 1178 проходят. Повторный импорт плагина опционален.

• v1.28.1 — Патч исправлений багов, всплывших при боевом тестировании форматтеров v1.28.0 против многоуровневых семантических дизайн-систем токенов. Исправления: Tailwind v3 выдавал пустой module.exports для наборов только с алиасами (теперь разрешает цепочки алиасов в литеральные значения); форматтеры TypeScript module + JSON flat + JSON nested выдавали строки "{alias.path}" как литеральные значения (теперь разрешают); удвоение namespace-префикса в Tailwind v4 (--color-theme-color-X теперь --color-theme-X). Добавлен публичный хелпер resolveAliasChain. 1151 тест всё ещё проходит.

• v1.28.0 — Полное покрытие форматтерами figma_export_tokens. Семь новых форматов вывода: Tailwind v4 @theme inline, конфиг Tailwind v3, SCSS-переменные, TypeScript-модуль, JSON flat/nested, Style Dictionary v3, Tokens Studio multi-file. Вместе с DTCG + CSS-переменными поставляется 10 полностью реализованных форматов вывода с нулевыми зависимостями от сторонних build-инструментов. Описание инструмента обновлено, таблица docs/tools.md вся зелёная. 22 новых Jest-теста, всего 1151 проходят.

• v1.27.1 — Патч документации. Без изменений поведения кода. Вычищает устаревшие утверждения «Phase 1 поставляется только с DTCG» из описаний инструментов, сообщений об ошибках и внутренних комментариев после того, как форматтер CSS-переменных и фаза применения были выпущены в цикле разработки v1.27.0. Обновляет баннер README + пункты возможностей + дорожную карту. Добавляет Phase 3.5: Stale-Content Audit в runbook релизов, чтобы будущие релизы получали строгую предпубликационную проверку grep по баннерам, описаниям инструментов, сообщениям об ошибках, комментариям в исходниках и согласованности количества инструментов.

• v1.27.0 — Двунаправленная синхронизация токенов: figma_export_tokens + figma_import_tokens заменяют конвейер экспорта Style Dictionary и Tokens Studio. Канонический DTCG JSON + CSS custom properties. Diff-осознанное слияние с сохранением round-trip ID через $extensions["figma-console-mcp"]. Фаза применения проталкивает правки hex-значений обратно в Figma через мост плагина. Проверено end-to-end на дизайн-системах с 713 токенами и 280 токенами.

• v1.26.0 — Внутренняя очистка + кросс-MCP идентичность: транспорт CDP/Puppeteer в Local-режиме полностью удалён (только WebSocket). Инструмент figma_diagnose для читаемых дизайнером проверок здоровья. Каждый ответ помечен _mcp: "figma-console-mcp"; ошибки имеют префикс [figma-console-mcp], чтобы атрибуция была однозначной при запуске нескольких Figma MCP. Индикатор состояния плагина теперь читается как Local · ready / Cloud · ready / Local + Cloud · ready. Чистый дифф: −7 299 строк, повторный импорт плагина опционален.

• v1.25.0 — Отслеживание описаний + аннотаций Dev Mode в figma_diff_versions через буфер сессии плагина. Правки описаний и аннотаций, сделанные во время сессии, теперь появляются в выводе диффа (REST API их не возвращает — проброшены через слушатель documentchange плагина).

• v1.24.0 — Честное покрытие области в диффах версий. Объект scope_coverage показывает, что figma_diff_versions отслеживает, а что нет; постоянные предупреждения о покрытии предотвращают молчаливую невидимость изменений значений токенов и размещений экземпляров компонентов.

• v1.23.0 — История версий и осведомлённость о временных рядах: 6 новых инструментов (список версий, снимок любой прошлой версии, дифф двух версий по дельтам компонентов/привязок, генерация markdown-журналов изменений, трассировка введения свойств/вариантов через бинарный поиск blame-ходунка). Атрибуция авторов идёт из автосохранений, а не только из именованных релизов.

• v1.17.0 — Поддержка Figma Slides: 15 инструментов для управления презентациями.

• v1.16.0 — Поддержка FigJam: 9 инструментов для создания и чтения досок FigJam.

• v1.12.0 — Cloud Write Relay: веб-ИИ-клиенты могут создавать и изменять дизайны Figma без Node.js.

• v1.11.0 — Полное удаление CDP, улучшенное многофайловое отслеживание активности с определением фокуса.

• v1.10.0 — Поддержка нескольких экземпляров (динамический запасной порт 9223–9232, мультиподключённый плагин, обнаружение экземпляров).

• v1.9.0 — Инструменты Figma Comments, улучшенное обнаружение конфликтов портов.

• v1.8.0 — Транспорт WebSocket Bridge (подключение без CDP), отслеживание выбора/документа в реальном времени.

• v1.7.0 — MCP Apps (Token Browser, Design System Dashboard), пакетные операции с переменными, инструменты паритета дизайн-код.

Что дальше:

• Token sync — входные парсеры non-DTCG - Парсеры для входных данных non-DTCG (Tokens Studio, CSS vars, Tailwind v4, Tailwind v3 config, SCSS, Style Dictionary v3, JSON flat/nested), чтобы figma_import_tokens мог импортировать те же форматы, которые он экспортирует. (Расширение apply на стороне импорта — создания, удаления при замене, обновления целевых алиасов — выпущено в v1.34.0.)

• Кросс-библиотечное разрешение переменных - Разрешать алиасы между библиотеками через getVariableByIdAsync, чтобы они отображались в экспорте как настоящие ссылки var(--target) вместо комментариев.

• Библиотека шаблонов компонентов - Генерация общих UI-паттернов

• Визуальное регрессионное тестирование - Возможности сравнения скриншотов

📖 Полная дорожная карта

💻 Разработка

git clone https://github.com/southleft/figma-console-mcp.git
cd figma-console-mcp
npm install

# Local mode development
npm run dev:local

# Cloud mode development
npm run dev

# Build
npm run build

📖 Руководство по разработке

📄 Лицензия

MIT - См. файл LICENSE для подробностей.

🔗 Ссылки

• 📚 Сайт документации — Полные руководства, учебные пособия и справочник API

• 📖 Локальная документация — Исходные файлы документации

• 🐛 Сообщить о проблемах

• 💬 Обсуждения

• 🌐 Model Context Protocol

• 🎨 Figma API