Figma MCP: как подключить макет к Cursor, Codex и Claude
Figma MCP — это официальный сервер Model Context Protocol, который даёт AI‑ассистентам доступ к структуре и контексту ваших макетов. Подключение занимает пару минут: добавляете URL сервера в MCP‑клиент и проходите авторизацию Figma. После этого Cursor, Claude, Codex или OpenCode смогут читать слои, стили и размеры из файла.
- 4 минуты чтения
- Обновлено
- Редакция figmatuts
Что такое 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
- Откройте Cursor и перейдите в Settings → MCP.
- Нажмите Add new MCP server.
- В поле Name введите
Figma. - Выберите тип подключения HTTP/SSE и укажите
https://mcp.figma.com/mcp. - Сохраните сервер и нажмите Connect или Refresh.
- В открывшемся окне браузера войдите в 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 и работает через облако. Если вам нужна связь с локальным выделением в десктоп‑версии, проверяйте, какие разрешения запрашивает мост. Любой неофициальный плагин или сервер получает доступ к данным файла — подключайте только те решения, которым доверяете.
Как передать контекст макета ассистенту
- Откройте файл в Figma и скопируйте ссылку на весь файл или лучше на конкретный фрейм.
- Убедитесь, что MCP‑сервер в клиенте подключён и авторизован.
- Напишите ассистенту, что нужно сделать: «Сгенерируй React‑компонент по этому фрейму, используя Figma MCP».
- Вставьте ссылку. Для больших файлов лучше давать ссылку на страницу или фрейм, а не на весь документ.
Полезно указывать, что именно нужно: текст, размеры, отступы, 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 — неофициальные локальные способы связи, часто работающие через десктоп‑приложение и выделенные узлы.