Подключение AI-агентов#

Русский | 简体中文 | English

Как зарегистрировать figma-agent-mcp в популярных MCP-клиентах. Сначала установите плагин Figma и перед проверкой инструментов убедитесь, что мост отображается зелёным.

#Общие предварительные требования

1. Node.js ≥ 20 в вашем PATH (node -v, npx -v)
2. Запущены Figma Desktop и плагин Figma Agent Kit (MCP Bridge подключён)
3. Предпочтительно использовать незакреплённый npx -y figma-agent-mcp (всегда последняя версия); закрепляйте @x.y.z только для фиксированных установок
4. Необязательный пользовательский порт моста (должен совпадать с плагином):

"env": { "FIGMA_AGENT_MCP_PORT": "1998" }

#Общий фрагмент stdio (JSON-клиенты)

Большинство редакторов принимают такую структуру в разделе mcpServers:

{
  "mcpServers": {
    "figma-agent-mcp": {
      "command": "npx",
      "args": ["-y", "figma-agent-mcp"]
    }
  }
}

#Быстрая проверка (любой клиент)

Выбрав фрейм в Figma, попросите агента выполнить:

1. list_files
2. get_selection
3. get_node / get_screenshot

Когда процесс MCP работает корректно, вы увидите 37 инструментов.

#Cursor

Документация / UI: Cursor Settings → MCP (или отредактируйте JSON напрямую).

Вставьте общий фрагмент JSON, сохраните его, затем перезапустите / обновите MCP.

Проверьте список MCP в Cursor: figma-agent-mcp · 37 активных инструментов.

#Claude Code

Официальное руководство: Claude Code MCP quickstart

#CLI (рекомендуется)

# User scope — available in all projects
claude mcp add --scope user figma-agent-mcp -- npx -y figma-agent-mcp

# Or project scope — writes .mcp.json (share with the team)
claude mcp add --scope project figma-agent-mcp -- npx -y figma-agent-mcp

Пользовательский порт:

claude mcp add --scope user figma-agent-mcp \
  --env FIGMA_AGENT_MCP_PORT=1998 \
  -- npx -y figma-agent-mcp

#Файлы конфигурации

Пример .mcp.json:

{
  "mcpServers": {
    "figma-agent-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "figma-agent-mcp"]
    }
  }
}

Перезапустите Claude Code, затем выполните /mcp, чтобы подтвердить подключение сервера. При первом использовании подтвердите серверы проекта из .mcp.json, если появится запрос.

#Codex (OpenAI)

Официальное руководство: Codex MCP

Codex использует TOML (~/.codex/config.toml или .codex/config.toml проекта для доверенных проектов). ChatGPT desktop / Codex CLI / расширение IDE используют общую конфигурацию.

#CLI

codex mcp add figma-agent-mcp -- npx -y figma-agent-mcp

# With custom port
codex mcp add figma-agent-mcp \
  --env FIGMA_AGENT_MCP_PORT=1998 \
  -- npx -y figma-agent-mcp

codex mcp list

#config.toml

[mcp_servers.figma-agent-mcp]
command = "npx"
args = ["-y", "figma-agent-mcp"]

С env:

[mcp_servers.figma-agent-mcp]
command = "npx"
args = ["-y", "figma-agent-mcp"]

[mcp_servers.figma-agent-mcp.env]
FIGMA_AGENT_MCP_PORT = "1998"

После редактирования перезапустите Codex / расширение IDE.

#Qoder

Официальное руководство: Qoder MCP

1. Откройте Qoder Settings (аватар или ⌘⇧, / Ctrl+Shift+,)
2. В левой навигации выберите MCP
3. My Servers → + Add
4. Вставьте общий фрагмент JSON (STDIO: команда npx, аргументы указаны выше)
5. Сохраните — значок ссылки означает подключение; разверните элемент, чтобы увидеть инструменты

Используйте в чате Agent mode, чтобы модель могла вызывать инструменты MCP (при необходимости подтверждайте запросы).

В качестве альтернативы можно открыть MCP Square, если сервер там доступен; для этого пакета надёжнее добавить STDIO вручную.

#CodeBuddy

Официальное руководство: CodeBuddy Config MCP

1. Чат на боковой панели → CodeBuddy Settings (вверху справа)
2. Откройте вкладку MCP
3. Add MCP (или установите из MCP Market, если он представлен)
4. Вставьте JSON, например:

{
  "mcpServers": {
    "figma-agent-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "figma-agent-mcp"],
      "description": "Local Figma Desktop bridge (Figma Agent Kit)"
    }
  }
}

5. Подтвердите зелёный статус; при необходимости нажмите Try to Run, затем используйте Craft Agent с открытой Figma

#Trae

Официальное руководство: Trae — Add MCP servers · 中文

#UI (глобально)

1. Settings → MCP
2. Add → Add Manually (либо marketplace, если доступен)
3. Вставьте общий фрагмент JSON и подтвердите

Также можно открыть Raw Config (JSON) и объединить конфигурацию с mcp.json Trae.

#На уровне проекта

1. Создайте .trae/mcp.json в корне проекта с тем же JSON mcpServers
2. В Settings → MCP включите project-level MCP, если в вашей сборке Trae есть этот переключатель

Режим SOLO / Work: если инструменты работают нестабильно, предпочтите конфигурацию на уровне проекта и явно попросите агента использовать figma-agent-mcp / list_files.

#Локальная сборка вместо npx

Укажите любому JSON-клиенту собранный бинарный файл:

{
  "mcpServers": {
    "figma-agent-mcp": {
      "command": "node",
      "args": ["/ABS/PATH/figma-agent-kit/packages/figma-agent-mcp/dist/index.js"]
    }
  }
}

TOML для Codex:

[mcp_servers.figma-agent-mcp]
command = "node"
args = ["/ABS/PATH/figma-agent-kit/packages/figma-agent-mcp/dist/index.js"]

См. Начало работы — из исходников.

#Устранение неполадок

Подробнее: FAQ.