Перейти к содержимому

Справочник инструментов Figma MCP ​

Каждый вызов инструмента для работы с документом требует канонический connection_id в нижнем регистре, возвращаемый list_figma_connections. После выбора подключения вызовите get_figma_capabilities: бета-возможности и API с разрешениями зависят от среды Figma, аккаунта и файла.

Общие правила ​

  • Входные поля инструментов используют snake_case.
  • Идентификаторы относятся к текущим узлам, стилям и переменным Figma, а не к REST-ключам файла.
  • Изменяющие данные пакетные операции ограничены 100 элементами, если для инструмента не указано иное.
  • Инструменты с dry_run: true проверяют данные и показывают предполагаемые цели, не записывая изменения.
  • Инструменты с idempotency_key кэшируют первый результат на время текущего запуска плагина. Повторный ключ возвращает его с idempotent_replay: true.
  • При инициализации коннектор один раз вызывает loadAllPagesAsync(): Figma требует этого до регистрации documentchange в режиме dynamic-page. Bridge принимает операции после завершения инициализации.
  • Журнал изменений фиксирует все изменения документа, включая ручное редактирование холста, а также события выбора, страницы и стилей.
  • Двоичные данные на входе и выходе передаются в base64 и ограничены 12 МиБ. Конверты Bridge ограничены 16 МиБ.
  • Структура ошибки: error.code, error.message, error.connection_id.
  • Продолжают действовать проверки Plugin API Figma. Например, узел нельзя вынести из instance, используемые шрифты должны существовать, а лимиты страниц и режимов зависят от плана Figma.

Информация о сервере ​

get_server_info — инструмент уровня сервера только для чтения, без входных параметров и connection_id. Вызовите его после инициализации MCP, даже если плагин ещё не подключён, чтобы узнать точный порт Bridge для текущей сессии:

json
{
  "server_instance_id": "11111111-1111-4111-8111-111111111111",
  "process_id": 1234,
  "product_version": "1.2.3+abcdef",
  "started_at": "2026-10-15T04:00:00+00:00",
  "active_plugin_connections": 0,
  "bridge": {
    "host": "127.0.0.1",
    "port": 3847,
    "websocket_url": "ws://127.0.0.1:3847/bridge"
  }
}

Ответ содержит фиксированный набор скалярных полей и один объект Bridge, без списков подключений или коллекций данных о компьютере. server_instance_id — канонический UUID в нижнем регистре, создаваемый один раз на время жизни бэкенда. process_id, product_version и started_at в UTC ISO 8601 обозначают процесс, сборку (включая метаданные информационной версии) и время запуска процесса. Эти поля постоянны между вызовами. active_plugin_connections — неотрицательное число активных подключений из того же реестра, который использует list_figma_connections; оно меняется при подключении и отключении плагинов.

bridge.host, bridge.port (1–65535) и bridge.websocket_url берутся из успешно запущенного слушателя, включая автоматически выбранный запасной порт или явный --port. При необходимости инструмент ждёт запуска слушателя. Введите bridge.port в плагине Figma Bridge. Идентификатор, слушатель и реестр относятся к бэкенду, которому принадлежат подключения Figma, а не к клиенту или возможному отдельному MCP-фронтенду. Переменные окружения, учётные данные, пути файлов и посторонняя информация о компьютере не возвращаются. Результат включает структурированные данные MCP и схему выхода; инструмент объявляет readOnlyHint: true, destructiveHint: false и openWorldHint: false.

Подключение и контекст документа ​

ИнструментВходные данные
list_figma_connectionsНет
get_figma_document_metadataТолько connection_id; псевдоним get_figma_document
get_figma_capabilitiesНет
get_figma_documentНет
list_figma_pagesНеобязательные cursor, limit
load_figma_pagepage_id
get_figma_selectionНет
set_figma_selectionnode_ids, необязательный focus
set_figma_current_pagepage_id
get_figma_document_changesНеобязательные cursor, limit; передайте next_cursor в следующий запрос

Чтение дерева документа ​

ИнструментВходные данные
get_figma_nodesnode_ids; необязательные fields, child_depth от 0 до 4
query_figma_nodesНеобязательные root_id, node_types, name, name_contains, visible, plugin_data_key, fields, limit
get_figma_node_cssnode_ids
get_figma_node_geometrynode_ids
get_figma_textnode_ids; необязательные start, end, segment_fields
get_figma_componentsnode_ids
get_figma_prototypenode_ids
get_figma_plugin_datanode_ids; необязательные приватные keys и shared_namespaces
get_figma_dev_metadatanode_ids

По умолчанию возвращаются поля узла id, type, name, removed, parent_id, visible, locked, x, y, width и height. Явная проекция также может запросить трансформации, границы, заливки, обводки, эффекты, углы, ограничения, свойства layout и grid, дочерние узлы, векторные данные, свойства компонентов, реакции, аннотации и связанные переменные.

Создание и изменение узлов ​

Инструмент create_figma_nodes принимает, например:

json
{
  "nodes": [
    {
      "kind": "frame",
      "parent_id": "1:2",
      "width": 320,
      "height": 200,
      "properties": {
        "name": "Card",
        "layout_mode": "VERTICAL",
        "item_spacing": 16,
        "padding_left": 24,
        "padding_right": 24,
        "padding_top": 24,
        "padding_bottom": 24
      }
    }
  ],
  "idempotency_key": "create-card-v1"
}

Поддерживаемые конструкторы Design: rectangle, line, ellipse, polygon, star, vector, text, frame, component, page, page_divider, slice, section, boolean_operation, svg и text_path. Для текста используется characters, для SVG — svg, для текстовых кривых — vector_node_id, start_segment и start_position.

update_figma_nodes принимает updates: [{ node_id, properties }]. Разрешённые поля включают идентификацию, видимость и блокировку, позицию, поворот и прозрачность, маски и смешивание, эффекты, заливки и обводки, углы и ограничения, auto/grid layout, минимальные и максимальные размеры, обрезку, параметры экспорта, прототип, а также данные специфичных для фигуры точек и дуг и статус Dev Mode.

ИнструментВходные данные
clone_figma_nodesnode_ids; необязательные parent_id, index, размещение относительно якоря placement
move_figma_nodesmoves: [{ node_id, parent_id, index? }]
delete_figma_nodesnode_ids
resize_figma_nodesitems: [{ node_id, mode, width?, height?, scale?, lock_aspect_ratio? }]
combine_figma_nodesoperation, node_ids, необязательные parent_id, index; для transform-group нужен modifier на каждый узел
set_figma_vector_networknode_id и/или vector_network, vector_paths

Операции combine_figma_nodes: group, transform_group, flatten, ungroup, combine_as_variants, union, subtract, intersect и exclude.

По умолчанию clone_figma_nodes действует как clone() Figma и создаёт копии на текущей странице. Укажите parent_id, чтобы клонировать непосредственно в контейнер. Для сохранения полной трансформации относительно визуального якоря при копировании задайте placement с source_anchor_id и target_anchor_id. Если родитель управляет размещением дочерних элементов, например через auto-layout без абсолютного позиционирования, операция завершается с unsupported_placement и удаляет созданные копии. Результаты клонирования и перемещения содержат relative_transform, absolute_transform, absolute_bounding_box и coordinate_parent_id; для перемещения возвращается геометрия до и после операции.

Текст, компоненты и экземпляры ​

ИнструментВходные данные
list_figma_fontsНеобязательные family, cursor, limit
update_figma_textitems с node_id, operation, диапазонами, characters, необязательными font_names и свойствами диапазонов
update_figma_text_pathТа же схема, что для текста, плюс необязательные path_alignment, paragraph_spacing, paragraph_indent
create_figma_component_instanceoperation (create_instance или component_from_node) и component_id либо node_id
update_figma_componentitems с метаданными и property_actions (add, edit, delete)
update_figma_instanceitems с swap_component, set_main_component, set_properties, remove_overrides, detach, set_scale или set_exposed
update_figma_slotoperation (create, reset, inspect) и component_id либо slot_id
list_figma_component_instancescomponent_id, необязательные cursor, limit

Операции с текстом: replace, insert, delete, set_all, format. Свойства диапазона включают font_name, font_size, text_case, text_decoration, letter_spacing, line_height, hyperlink, fills, list_options, indentation, paragraph_indent, paragraph_spacing и open_type_features. Перед записью коннектор загружает все текущие и запрошенные шрифты.

Стили, переменные и библиотеки ​

ИнструментВходные данные
list_figma_stylesНеобязательные kinds (paint, text, effect, grid), cursor, limit
create_figma_stylekind, name и значение соответствующего типа
update_figma_stylestyle_id и изменяемые поля
delete_figma_stylestyle_ids
reorder_figma_styleskind, operation (style или folder), целевые и опорные ID либо пути
list_figma_style_consumersstyle_id, необязательные cursor, limit
list_figma_variablesНеобязательные resolved_type, cursor, limit
create_figma_variable_collectionname; необязательные extend_collection_key, hidden_from_publishing, mode_actions
create_figma_variablecollection_id, name, resolved_type; необязательные значения, aliases, scopes и code syntax
update_figma_variablevariable_id и изменяемые поля
delete_figma_variablevariable_ids и/или collection_ids
bind_figma_variablebindings для node_field, text_range, paint, effect, layout_grid или explicit_mode
list_figma_team_library_assetsОперация списка/импорта и collection_key либо ключ ресурса key

Операции библиотеки: list_variable_collections, list_variables, import_variable, import_component, import_component_set и import_style. Манифест запрашивает разрешение teamlibrary. Библиотеку нужно включить в интерфейсе Figma; Plugin API не умеет включать её самостоятельно.

Ресурсы и экспорт ​

ИнструментВходные данные
create_figma_imagedata_base64 или публичный URL HTTP(S); URL локальной сети отклоняются
get_figma_imagehash
create_figma_mediakind: "video", data_base64
list_figma_shadersДля списка входные данные не нужны; для импорта — import_id
load_figma_brushesbrush_type (STRETCH или SCATTER)
export_figma_nodesДо 20 node_ids, необязательные параметры Plugin API для PNG/JPG/SVG/PDF/JSON_REST_V1
get_figma_screenshotnode_id, необязательные scale (0.01–4) и contents_only; возвращает PNG inline
encode_figma_binarydata_base64, необязательная операция inspect или normalize_base64

get_figma_screenshot предназначен для визуальной проверки: результат содержит типизированный блок MCP image, который совместимый клиент может показать как изображение, а не как base64 в JSON. export_figma_nodes остаётся общим API для экспорта нескольких узлов в различных форматах.

Произвольный figma.fetch не должен становиться универсальным сетевым прокси. Создание изображений и медиаданных по URL может использовать его внутри инструмента с учётом allowlist манифеста, максимального размера ответа, проверки MIME-типа, тайм-аутов и правил SSRF.

Прототип, viewport, уведомления и состояние файла ​

ИнструментВходные данные
update_figma_prototypeitems: [{ node_id, properties }] для реакций, flow, overflow и overlay
get_figma_viewportНет
set_figma_viewportnode_ids либо center и/или zoom
notify_figma_usermessage, необязательные timeout_ms, error
commit_figma_undoНеобязательная операция commit или undo
save_figma_versiontitle, необязательный description
get_figma_file_thumbnail_nodeНет
set_figma_file_thumbnail_nodeНеобязательный node_id; пропуск очищает значение. Figma принимает только frames, components, component sets и sections.

Данные плагина, аннотации и метаданные разработки ​

ИнструментВходные данные
set_figma_plugin_dataitems с node_id, приватными/общими записями и необязательным relaunch_data
list_figma_annotation_categoriesНеобязательный category_id
create_figma_annotation_categorylabel, color
set_figma_annotationsitems: [{ node_id, annotations }]
manage_figma_measurementsОперация list, add, edit, delete и её поля
manage_figma_dev_resourcesnode_id, операция list, add, edit, delete, поля URL/имени
set_figma_dev_statusnode_id, необязательный статус Plugin API; если его опустить, статус читается

Превью Dev Resources доступны только в приватном или партнёрском API и не предоставляются. Изменение измерений доступно только в Dev Mode; коннектор Design возвращает unsupported_in_editor.

Бета-версия Motion ​

ИнструментВходные данные
list_figma_animation_stylesНеобязательный physical_spring с mass, stiffness и damping
get_figma_motionnode_ids
update_figma_motionitems с apply_style, remove_style, apply_manual_track, remove_manual_track, set_timeline_duration

Результаты Motion содержат beta: true. Схема данных следует бета-версии Plugin API и может меняться независимо от стабильного конверта Bridge при обновлении Figma.

Намеренно не поддерживается ​

Коннектор не предоставляет raw JavaScript/eval, произвольный fetch, управление интерфейсом плагина, clientStorage, платежи, openExternal, приватные API, партнёрские превью dev resources, FigJam, Slides, Buzz, callbacks codegen/parameters или режим text-review. Эти API либо не работают с документом Design, либо относятся к реализации самого коннектора, требуют отдельного режима запуска плагина или создают небезопасную поверхность универсального выполнения/сетевого доступа.

Документация Figma MCP v2.0.0. Распространяется по лицензии MIT.