figmatuts

Figma MCP: как подключить макет к Cursor, Codex и Claude

Figma MCP — это официальный сервер Model Context Protocol, который даёт AI‑ассистентам доступ к структуре и контексту ваших макетов. Подключение занимает пару минут: добавляете URL сервера в MCP‑клиент и проходите авторизацию Figma. После этого Cursor, Claude, Codex или OpenCode смогут читать слои, стили и размеры из файла.

Что такое Figma MCP и зачем он нужен

MCP (Model Context Protocol) — открытый стандарт, по которому AI‑инструменты получают данные из внешних сервисов. Figma MCP Server подключает вашу учётную запись Figma к ассистентам вроде Cursor, Claude, Codex CLI и OpenCode. Сервер работает только на чтение: ассистент видит структуру макета, названия слоёв, текст, стили, переменные и параметры Auto layout, но не может сам менять дизайн в Figma.

Это удобно, когда вы просите AI написать код по макету, проверить отступы или собрать список текстов. Вместо ручного экспорта и скриншотов ассистент сам забирает нужный контекст по ссылке на файл или фрейм.

Как работает MCP-сервер Figma

Официальный сервер доступен по адресу https://mcp.figma.com/mcp. Клиент отправляет запросы от имени вашей учётной записи Figma, поэтому первый запуск требует авторизации через браузер. Доступ к файлу определяется обычными правами Figma: если вы можете открыть файл, сервер сможет прочитать его контекст.

Для приватного файла нужно, чтобы аккаунт, под которым вы входите в MCP, имел доступ хотя бы на просмотр. Если файл закрыт, ассистент получит ошибку «access denied» или просто не найдёт данные. Открыть доступ можно через настройки доступа к файлу в Figma.

Подключение Figma MCP к Cursor

  1. Откройте Cursor и перейдите в Settings → MCP.
  2. Нажмите Add new MCP server.
  3. В поле Name введите Figma.
  4. Выберите тип подключения HTTP/SSE и укажите https://mcp.figma.com/mcp.
  5. Сохраните сервер и нажмите Connect или Refresh.
  6. В открывшемся окне браузера войдите в Figma и разрешите доступ.

После подключения скопируйте ссылку на файл или конкретный фрейм в Figma. В чате Cursor явно напишите: «Используй Figma MCP, чтобы прочитать контекст этого файла: …». Без указания ссылки ассистент может не обратиться к серверу.

Подключение к Claude и Claude Code

В Claude Desktop откройте Settings → Developer → Edit Config и добавьте в JSON блок:

"mcpServers": {
"figma": {
"url": "https://mcp.figma.com/mcp"
}
}

Сохраните файл и перезапустите приложение. В актуальных версиях Claude Code из терминала используется команда:

claude mcp add --transport http figma https://mcp.figma.com/mcp

После добавления сервера попросите Claude обратиться к макету по ссылке. Если вы работаете с Claude для Figma, не перепутайте: MCP даёт контекст файла для написания кода, а плагин Claude внутри Figma помогает генерировать и редактировать объекты прямо на холсте.

Codex CLI и OpenCode

Codex CLI и OpenCode поддерживают MCP-серверы с HTTP‑транспортом. В Codex CLI сервер добавляется через команду codex mcp add figma --url https://mcp.figma.com/mcp либо через конфигурацию MCP в файле ~/.codex/config.toml. В OpenCode аналогично используется конфигурация MCP или команда добавления сервера.

Точный синтаксис может немного отличаться в зависимости от версии Codex CLI, поэтому если команда не сработала, проверьте официальную документацию OpenAI. После перезапуска Codex попросите ассистента «прочитать контекст Figma по ссылке».

Figma Bridge и Desktop Bridge: в чём разница

Под названием Figma Bridge или Desktop Bridge встречаются неофициальные способы связи Figma с локальными инструментами. В отличие от официального MCP-сервера, такие bridge‑решения могут работать через запущенное десктоп‑приложение Figma и передавать выбранный узел или текущий фрейм в AI‑агента.

Официальный MCP не требует запущенного приложения Figma и работает через облако. Если вам нужна связь с локальным выделением в десктоп‑версии, проверяйте, какие разрешения запрашивает мост. Любой неофициальный плагин или сервер получает доступ к данным файла — подключайте только те решения, которым доверяете.

Как передать контекст макета ассистенту

  1. Откройте файл в Figma и скопируйте ссылку на весь файл или лучше на конкретный фрейм.
  2. Убедитесь, что MCP‑сервер в клиенте подключён и авторизован.
  3. Напишите ассистенту, что нужно сделать: «Сгенерируй React‑компонент по этому фрейму, используя Figma MCP».
  4. Вставьте ссылку. Для больших файлов лучше давать ссылку на страницу или фрейм, а не на весь документ.

Полезно указывать, что именно нужно: текст, размеры, отступы, Auto layout, переменные. Тогда ассистент не будет выгружать лишние данные и ответит быстрее.

Частые ошибки при подключении Figma MCP

ОшибкаПричина и решение
Сервер не подключаетсяНе завершена OAuth‑авторизация. Нажмите Connect ещё раз и войдите в Figma в браузере.
Ассистент не видит файлСсылка не передана в чат или аккаунт Figma не имеет доступа к файлу.
Access deniedОткройте доступ к файлу на просмотр или войдите под нужным аккаунтом Figma.
Медленный ответФайл слишком большой. Передавайте ссылку на конкретный фрейм или страницу.
Клиент не поддерживает URLОбновите Cursor, Claude Desktop или Codex CLI до актуальной версии.

Если вы только разбираетесь с AI‑инструментами в Figma, загляните в обзор Figma AI. А если файл ещё не создан, начните с регистрации Figma.

Ограничения и практические советы

Figma MCP не редактирует макет и не запускает плагины. Это мост для контекста: ассистент получает структуру, стили и тексты, но не видит документ как полноценный скриншот, если сам сервер не отдаёт изображение. Поэтому для сложных визуальных задач всё равно полезно дополнительно прикладывать экспортированный фрейм.

Используйте MCP для рутинных задач: перенос текстов, проверка расстояний, генерация структуры компонентов, подготовка CSS‑переменных. Один раз настроив сервер, вы сможете вызывать его в любом проекте, где у вашей учётной записи есть доступ к файлу.

Частые вопросы

Что такое Figma MCP?

Это официальный сервер Model Context Protocol, который позволяет AI‑ассистентам получать структуру, тексты, стили и размеры из файлов Figma по ссылке. Работает только на чтение и не редактирует макет.

Как подключить Figma MCP к Cursor?

В Cursor откройте Settings → MCP, добавьте сервер с URL https://mcp.figma.com/mcp, сохраните и нажмите Connect. Затем войдите в Figma через браузер и передайте ссылку на файл в чат.

Поддерживает ли Figma MCP Codex и OpenCode?

Да, Codex CLI и OpenCode поддерживают MCP-серверы с HTTP‑транспортом. Добавьте сервер https://mcp.figma.com/mcp через команду или конфигурацию MCP и после перезапуска попросите ассистента прочитать контекст файла.

Почему Figma MCP не видит мой файл?

Чаще всего аккаунт Figma, под которым выполнена авторизация MCP, не имеет доступа к файлу. Откройте доступ на просмотр или войдите в MCP под нужной учётной записью.

Чем Figma MCP отличается от Figma Bridge?

Figma MCP — официальный облачный сервер, не требующий запущенной Figma. Figma Bridge и Desktop Bridge — неофициальные локальные способы связи, часто работающие через десктоп‑приложение и выделенные узлы.

Ещё по теме