Figma 免费账户有读限制，如何不付费就把设计读出来

一、那行 429 是怎么来的

把 https://mcp.figma.com/mcp 接进 Codex，OAuth 弹窗走完，连接显示成功。让 agent「按这个 frame 实现」，返回的却不是代码：

exceeded retry limit, last status: 429 Too Many Requests

Client 收到 429 后自动重试，把重试额度耗光才甩出这行。意思是 Figma 服务端一直在回「请求过多」——不是 Codex 的 bug，是免费账户的硬配额被瞬间打爆。

Codex 一连上就会发几波请求（拉工具列表、校验会话、whoami），再叠加一次读设计，免费档的月度额度当场见底。这是「不付费就读取」的第一个现实：Figma 的读取配额低到，连接本身就能把它耗尽。

二、限额到底怎么算

Figma 给 AI 留了两条官方 MCP 通道，限额口径不同：

限额 = 你的 seat 类型 × 文件所属团队的 plan，两者取低：

三条容易被忽略的事实：

1. 读受限，写部分豁免。 get_design_context 这类读工具吃配额；whoami、generate_figma_design、add_code_connect_map 不计数。所以「把代码推回 Figma」无限，「读设计」才受限——这解释了为什么你连上能认证、一读就挂。
2. 限额绑定文件所属团队，不是你的账号。 哪怕你开了 Pro，只要读的文件躺在某个免费 Starter 团队里，照样按 6 次/月算。诊断第一步永远是先让 agent 跑 whoami（豁免不计数），看清自己落在哪一档、文件归哪个团队。
3. Desktop 通道也要钱。 本地 127.0.0.1:3845 看着像「我自己机器上的服务应该免费」，但 Figma 官方定调：它要求 Dev/Full seat + 付费 plan。「我有本地 APP」这条直觉走不通——不买会员，Desktop MCP 起不来。

三、为什么「不付费读取」在原理上成立

所有限流都发生在 REST API / 官方 MCP 这一层。但 Figma 还有第三条数据通道：Plugin API（运行在 Figma 沙箱里、直接读 window.figma 内存里的文档树）。

这条通道 Figma 不做 REST 配额计数——插件读的是已加载进内存的文档，不是每读一次打一次 API。让 AI 客户端走「Figma 插件 → 本地桥 → MCP」这条路径，就绕开了那张限额表。免费读取的全部空间都在这里：不是去蹭配额，而是换一条 Figma 不记数的路。

四、方案 A：figma-mcp-bridge 完整实操（含每个坑）

实测跑通的方案。GitHub 活跃（2026 年中仍在更新、已过安全扫描），架构是 Figma 插件在沙箱读数据 → 本地 Node MCP server 转发给 AI 客户端，全程走 Plugin API，零配额、任意 Figma 账号可用。

4.0 前置检查

4.1 配 MCP（AI 客户端侧）

码道 mcp_settings.json / Codex mcp.json / Cursor .mcp.json 通用：

{
  "mcpServers": {
    "figma-bridge": {
      "command": "npx",
      "args": ["-y", "@gethopp/figma-mcp-bridge"]
    }
  }
}

入口位置：码道是「设置 → MCP 工具 → 配置 MCP」；Cursor 是「Settings → MCP」；Codex 可直接 codex mcp add。

坑 1：改完配置必须重启 AI 客户端。 MCP server 在客户端启动时拉起，改 JSON 不重启等于没改。
坑 2：客户端找不到 npx。 部分 Windows 客户端不继承 shell 的 PATH，报错 spawn npx ENOENT 时，把 command 换成 npx 的绝对路径（用 where npx 查）。
坑 3：终端混淆。 cmd / PowerShell / Git Bash 都能跑 npx，但路径写法不同；客户端配置里建议直接用绝对路径，避免转义问题。

4.2 拿插件文件

1. 打开gethopp/ figma-mcp-bridge的 release 页，下载插件包（zip）。
2. 解压到本地文件夹，记住里面 plugin/manifest.json 的完整路径。

坑 4：必须解压后再选。 Figma 的文件选择器认本地路径，直接在压缩包里点 manifest.json 选不中。解压到一个固定目录（别放临时文件夹，删了就得重配）。

4.3 在 Figma 里导入插件（坑最密集的一段）

1. 打开 Figma 桌面 App，打开你的目标设计文件。
2. 确认当前处于 Design 编辑模式，不是 Dev Mode。 如果界面是 Dev Mode（通常是你之前按过 Shift+D 切过去的），再按一次 Shift+D 切回 Design——Shift+D 是切换开关，不是单向入口。
3. Plugins → Development → Import plugin from manifest，选中 4.2 解压出来的 plugin/manifest.json。
4. 导入成功后，Plugins → Development 菜单里会出现这个插件。

坑 5（最大的坑）：Dev Mode 下配不了插件。 Dev Mode 是只读检视视图，插件的开发导入入口和运行都受限制；figma-mcp-bridge 的写入类工具在 Dev Mode 下会直接返回明确错误（项目 README 写明：edit tools 只在 design editor 生效，Dev Mode 是 read-only）。所以「打开编辑模式」不是玄学，是硬性前提。
坑 6：浏览器版 Figma 走不通这条路。 Import from manifest 要选本地文件，浏览器读不到本地路径——必须在桌面 App 里做。

4.4 跑起来

1. Plugins → Development → figma-mcp-bridge，点运行。
2. 插件面板显示 Connected，说明桥通了。
3. 保持插件面板开着，不要关掉、不要切走。

坑 7：插件关了桥就断。 插件本身就是数据传输的那一段，关掉窗口连接即断，agent 再调工具会超时或报未连接。
坑 8：MCP server 重启后要重连。 重启 AI 客户端或 npx 进程重拉后，回到 Figma 重开一次插件即可。

4.5 验证与常用工具

让 agent 先调 get_metadata 或 list_files，能返回文件名和节点信息即成功。常用工具：

坑 9：多文件要各开一次插件。 每个 Figma 文件都是独立连接；在多个文件里都跑一遍插件，用 list_files 看 fileKey，后续工具带 fileKey 参数指定目标。
坑 10：写入工具需要编辑权限。 免费账号在只读（view only）文件上，读没问题，写会失败——这不是限流，是权限。

4.6 这套方案的真实代价

• 每次用得手动开插件，没法后台常驻。
• 依赖第三方开源项目（Plugin API 是 Figma 官方正道，封堵风险低，但毕竟不是官方维护）。
• 写入能力有限：不支持组件/实例、变量与样式编写、逐段文本样式、矢量布尔运算。

五、另外两条免费路

方案 B：Chrome 扩展 bridge（网页注入）。 delirehberi/figma-mcp-browser往 figma.com 网页注入脚本读 window.figma，无需 token/OAuth、不限流，本地 server 监听 ws://127.0.0.1:9223。适合纯网页流、不想碰桌面端的场景——代价是得自己起 Node server 并在 Chromium 里加载未打包扩展。

方案 C：Playwright MCP 直接操作网页（兜底粗读）。 让 AI 在 Figma 网页里自己量尺寸、截图、读样式。零配额，但粒度粗——靠截图和 DOM，拿不到精确 design token。码道本身支持：

{ "mcpServers": { "playwright": { "command": "npx", "args": ["@playwright/mcp@latest"] } } }

六、哪些路其实还是要钱 / 照样限流

• Desktop MCP（127.0.0.1:3845）：要 Dev/Full 付费 seat，免费账户开不了。
• 官方 Remote MCP（mcp.figma.com/mcp）：免费档 6 次/月，一连接就见底。
• 社区 REST 方案（figma-developer-mcp 等）：底层仍是 Figma REST 配额，带缓存也只是省着用，不是根本解决。

七、怎么选

跑方案 A 时记住两件事就够了：Figma 的限流只认 REST/官方 MCP 那一层，Plugin API 这条内存通道它不计数；以及配插件前先按一次 Shift+D 回到 Design 编辑模式，Dev Mode 下这条路是封的。