figma-console-mcp

环境要求

• Node.js（NPX / Local Git 模式需要；Cloud Mode 与 Remote SSE 不需要）
• 一个可用的 Figma 账号（NPX 与 Local Git 模式需手动配置 PAT）
• 支持 MCP 的 AI 客户端（如 Claude、Cursor 等）
• 如需写入 Figma：Figma 桌面端（正常启动即可，无需 debug 参数）

安装与启动步骤

1. 1选择安装方式

   按目标对照官方表格选择：要与 AI 一起创建/修改设计选 NPX 推荐；Web 端 AI 选 Cloud Mode；想贡献代码选 Local Git；只想只读浏览选 Remote SSE。

2. 2准备 Figma 凭证

   NPX 与 Local Git 模式使用手动 PAT 认证；Cloud Mode 和 Remote SSE 使用 OAuth 自动认证，无需手动配置令牌。

3. 3克隆仓库(本地模式)

   仅 Local Git / 贡献者模式需要，克隆后按仓库说明安装依赖；NPX、Cloud、Remote SSE 三种方式可跳过此步。

   git clone https://github.com/southleft/figma-console-mcp.git

   复制

4. 4打开 Figma 桌面端

   正常启动 Figma 桌面端即可，README 明确说明不需要任何 debug 启动参数。

5. 5导入桌面桥插件

   在 Figma 中进入 Plugins → Development → Import plugin from manifest...，选中 figma-console-mcp 目录下的 figma-desktop-bridge/manife

6. 6运行插件连接

   在你的 Figma 文件中运行该插件，它会通过 WebSocket 自动连接，自动扫描 9223–9232 端口，无需手动指定端口。

7. 7让 AI 验证连接

   向你的 AI 助手提问“Check Figma status”，返回已连接状态即表示 MCP 与 Figma 通道打通。

关键配置

如何确认成功

向 AI 提问 “Check Figma status”，确认返回已连接 Figma、工具可用即成功。

常见问题

注意事项

• NPX（推荐）与 Local Git 提供全部 121 个工具，Remote SSE 仅只读子集，Cloud Mode 配对后为 96 个工具。
• 只有 NPX 与 Local Git 需要 Node.js；Cloud Mode 与 Remote SSE 不依赖 Node.js。
• NPX 方式通过 @latest 自动更新，Local Git 方式需要手动 git pull 更新。
• 当前版本 v1.40.9 的修复属于服务端更新，无需重新导入 Figma 插件。