Как подключить Figma к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Figma, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Figma + Gemini

Дайте ИИ читать ваши дизайны в Figma: просматривать папки команды и файлы, изучать страницы, фреймы и слои, экспортировать изображения, находить компоненты и стили, следить за историей версий, читать и публиковать комментарии и управлять ссылками Dev Mode. С персональным токеном доступа.

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

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

FIGMA_ACCESS_TOKEN

Шаг 1 — Получите учётные данные

1. В Figma откройте меню аккаунта (слева вверху в браузере файлов) → Settings → Security → Personal access tokens → Generate new token.
2. Задайте имя токена (например, «AnythingMCP») и выберите срок действия: не больше 90 дней, бессрочные токены Figma больше не выдаёт. Отметьте эти scopes:
   • current_user:read, file_content:read, file_metadata:read, file_versions:read
   • file_comments:read, file_comments:write
   • library_content:read, library_assets:read, team_library_content:read
   • folders:read
   • file_dev_resources:read, file_dev_resources:write
3. Нажмите Generate token и сразу скопируйте токен: Figma показывает его только один раз. Обычно он начинается с figd_.
4. Вставьте токен в FIGMA_ACCESS_TOKEN без слова Bearer, затем установите коннектор.
5. Начните с figma_get_me: инструмент показывает, какому пользователю Figma принадлежит токен. Затем дайте ИИ ссылку на файл: ключ файла находится в URL после /design/.

Срок действия токена: токены действуют не больше 90 дней. Когда срок истечёт, создайте новый токен с теми же scopes и снова вставьте его в FIGMA_ACCESS_TOKEN. Коннектор видит ровно те файлы и команды, которые может открыть пользователь токена. У токенов, созданных до того, как Figma переименовала проекты в папки (folders), может быть только projects:read, а инструментам для папок нужен folders:read: если они отвечают 403 с названием scope, создайте новый токен.

Как найти команды и папки: через API Figma нельзя получить список ваших команд. Дайте ИИ ссылку на страницу команды из браузера файлов (идентификатор команды: число после /team/); дальше через figma_list_team_folders, figma_list_subfolders и figma_list_folder_files он доберётся до файлов.

Разрешения и режим только для чтения: не выдавайте file_comments:write и file_dev_resources:write и отключите figma_post_comment, figma_delete_comment, figma_add_comment_reaction, figma_create_dev_resource и figma_update_dev_resource. Комментарии, которые публикует ИИ, появляются от имени пользователя токена, и их видят все, у кого есть доступ к файлу.

Выключены при установке: figma_delete_dev_resource, который удаляет ссылку Dev Mode с узла для всех. Включайте его, только если ИИ должен удалять dev resources.

Лимиты запросов и тариф Starter: Figma ограничивает запросы по пользователю и по тарифу, к которому относится файл. Самый жёсткий лимит у чтения содержимого файлов, узлов и рендеринга изображений (figma_get_file, figma_get_file_nodes, figma_render_images): от 10 до 20 в минуту на платном тарифе с местом Full или Dev, но лишь несколько в месяц для файлов на бесплатном тарифе Starter или с местом View или Collab. Для метаданных, комментариев, версий, компонентов и стилей лимиты гораздо выше. Просите ИИ смотреть отдельные фреймы, а не файлы целиком; очень большие ответы обрезаются на 200 КБ. Ссылки на отрендеренные изображения действуют 30 дней.

Dev Mode: для dev resources (ссылок на задачи, документацию или код, привязанных к узлу) нужен платный тариф и место Full или Dev. Без доступа к Dev Mode Figma отвечает инструментам dev resources «File not found», даже для файла, который остальные инструменты читают без проблем. К одному узлу можно привязать не больше 10 dev resources, каждый URL только один раз.

Частые ошибки: 401 «Invalid token» означает, что токен неверный, истёк или отозван: создайте новый. 403 означает, что токену не хватает scope (он указан в сообщении) или у пользователя нет доступа к этой команде или папке. 404 означает, что такого файла или узла нет или пользователь не может открыть файл: скопируйте ключ из URL файла. 400 указывает на неверный параметр, например идентификатор узла с дефисом вместо двоеточия (node-id=12-345 из ссылки соответствует 12:345). 429 означает лимит запросов: подождите и повторите попытку. Инструменты библиотеки не принимают ключ ветки (branch): используйте ключ основного файла.

Коннектор не редактирует дизайны и не работает с переменными, вебхуками, содержимым FigJam и Slides за пределами дерева файлов и аналитикой библиотек.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Figma.

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

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

• «Покажи страницы и основные фреймы файла Checkout redesign и кто редактировал его последним.»
• «Какие комментарии в файле Checkout redesign ещё не решены, и кто их написал?»
• «Экспортируй фрейм «Страница цен» из файла «Сайт Acme» в PNG и дай мне ссылку.»
• «Ответь на комментарий Лены в файле Checkout redesign и напиши, что цвет кнопки обновлён.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse