# Figma Context MCP

Canonical: https://cqbase.net/zh/entry/figma-context-mcp
Chinese: https://cqbase.net/zh/entry/figma-context-mcp
English: https://cqbase.net/en/entry/figma-context-mcp

> 把 Figma 的布局信息提供给 Cursor 等编码代理的 MCP 服务器。

GLips/Figma-Context-MCP 是 MIT 许可的 MCP 服务器，用来把 Figma 的布局信息交给 Cursor 一类编码代理，让实现更接近设计稿，而不是只凭截图猜测间距。

只授权代理需要的文件，不要把整个团队的 Figma 访问令牌范围开到最大。设计稿可能含未发布产品，注意仓库和对话记录不要把文件内容完整存下来。

推荐来源：

- [@HermesWatcher](https://x.com/HermesWatcher/status/2115081092118032871) 在 2026 年 10 月 27 日 的帖子里提到了这个项目（数字采集于 2026 年 11 月 15 日：1149 次喜欢，126 次转发）。
- [@stewy0x](https://x.com/stewy0x/status/2121586834232758521) 在 2026 年 11 月 14 日 的帖子里提到了这个项目（数字采集于 2026 年 11 月 15 日：52 次喜欢，7 次转发）。

## 解决什么问题

Figma Context MCP（仓库 `GLips/Figma-Context-MCP`，npm 包名 `figma-developer-mcp`，产品名 Framelink MCP for Figma）把 Figma 文件里的布局和样式信息交给编码代理，而不是只靠截图去猜间距。它会先简化 Figma API 返回的数据，再交给模型。

官方工具只有两个：`get_figma_data` 读取设计结构，`download_figma_images` 把图片资源下载到项目目录。代理通常是在你粘贴 Figma 链接之后才调用它们。

## 适合谁

适合在 Cursor、Claude Code、Claude Desktop、VS Code 或其他 MCP 客户端里，按设计稿实现界面的人。它使用 MIT 许可。使用前需要一份 Figma 个人访问令牌。

令牌绑定的是你的 Figma 账号，可以读取该账号能打开的文件。请只给当前任务需要的文件授权，不要把团队范围、权限开到最大的令牌随便发给代理。设计稿里可能有未发布产品，不要把整份文件贴进仓库或长期对话记录。

## 怎么装

核验日期为 2026-11-15（Asia/Shanghai）。命令来自仓库 [README](https://github.com/GLips/Figma-Context-MCP) 和 [Framelink Quickstart](https://docs.framelink.ai/quickstart.md)。

先在 Figma 中创建个人访问令牌：账号设置 → Security → Personal access tokens。官方说明，按默认选项生成的令牌往往没有 MCP 所需范围。Quickstart 列出了一组应勾选的范围；[Authentication](https://docs.framelink.ai/authentication.md) 则写明，严格来说至少需要 `file_content:read`，若出现相关 403，还应加上 `file_dev_resources:read`。令牌只显示一次，不要写入公开仓库。

macOS / Linux 上，多数客户端可用这份配置（把 `YOUR-KEY` 换成令牌）：

```json
{
  "mcpServers": {
    "Framelink_Figma_MCP": {
      "command": "npx",
      "args": ["-y", "figma-developer-mcp", "--figma-api-key=YOUR-KEY", "--stdio"]
    }
  }
}
```

Windows 上，官方提醒 `npx` 是批处理文件，多数 MCP 客户端不能直接启动，应改用 `cmd`：

```json
{
  "mcpServers": {
    "Framelink_Figma_MCP": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "figma-developer-mcp", "--figma-api-key=YOUR-KEY", "--stdio"]
    }
  }
}
```

也可以改用环境变量 `FIGMA_API_KEY`，而不把令牌写在参数里。

**Claude Code**

```bash
claude mcp add Framelink_Figma_MCP -- npx -y figma-developer-mcp --figma-api-key=YOUR-KEY --stdio
```

**Cursor**

打开 Settings → Cursor Settings → MCP → Add new global MCP server，或把上面的 JSON 写入 `~/.cursor/mcp.json`；只需对单个项目生效时，可在项目里放 `.cursor/mcp.json`。

**Claude Desktop**

打开 Settings → Developer，编辑 `claude_desktop_config.json`，写入与上面相同的 `mcpServers` 配置（Windows 仍按官方 Windows 示例使用 `cmd`）。若本机用 NVM 等工具管理 Node，排障文档还介绍过 Claude Desktop 用错 Node 版本的情况。

## 一个实际例子

下面的提示词是为本文写的核验步骤，不是官方固定口令。本次没有实跑，因此不编造页面结构或生成代码。

1. 完成安装，在客户端确认能看到 `get_figma_data`。
2. 在 Figma 里对单个 frame 或 group 右键，选择 Copy/Paste as → Copy link to selection。官方建议一次只做一节，完整文件容易超出模型上下文。
3. 把链接贴进对话，发送：`Implement this Figma frame. First call get_figma_data; do not invent spacing from a screenshot.`
4. 按官方工具说明，代理应使用你提供的链接调用 `get_figma_data`。请自己对照设计稿检查间距、字体和颜色，不要把一次生成的结果当成已经核对过的产出。

## 常见坑

- 令牌范围不够，出现 `403` 且正文含 `Invalid scope(s)`。这是官方排障页写明的原因：默认生成的 PAT 常常缺少 `file_content:read` 等范围。应按 Quickstart 重新生成令牌，而不是反复重试同一个令牌。
- 触发 Figma API 限流（`429`）。官方写明限流来自 Figma，而不是这个 MCP 自己：免费方案大约每月 6 次请求；付费方案（含 Dev Seat）在其使用的接口上起跳为每分钟 10 次。限流还受文件所有者套餐影响。详见 [Troubleshooting](https://docs.framelink.ai/troubleshooting.md) 和 Figma 的 Rate Limit 文档。
- `Cannot find module`。官方建议先关闭客户端，运行 `npx clear-npx-cache`，再重新打开。
- 下载图片时路径被拒绝。工具只能写到 `--image-dir` 指定的目录（默认是服务器启动目录）。许多客户端启动服务器时的工作目录并不是你的项目根目录，需要显式设置 `--image-dir`。
- 在 Windows 上直接把 `npx` 当作 command。请改用官方的 `cmd /c npx ...` 写法。

## FAQ

### 必须用个人访问令牌吗？

这是官方推荐给大多数人的方式。服务器也可以使用你已经通过 Figma OAuth 应用拿到的访问令牌，但它不会帮你走授权流程，也不会自动刷新；过期后请求会失败，直到你提供新令牌。HTTP 模式下还可以按请求附带令牌。stdio 模式必须在启动时提供令牌。

### 免费 Figma 账号够用吗？

可以创建令牌并调用 API，但免费方案的速率限制非常紧。官方排障页写的是大约每月 6 次请求。若你频繁读取设计稿，需要对照 Figma 当前的套餐说明，而不是假设可以随意刷新。

### 为什么连接成功，调用工具却返回 403？

先看错误正文里的 `err` 字段。官方把 `Invalid scope(s)`、`Invalid token`、`Token expired` 和 `File not exportable` 分开处理。文件还必须属于该令牌对应的账号，或已明确共享给它。[issue #358](https://github.com/GLips/Figma-Context-MCP/issues/358) 也报告过客户端显示已连接、工具调用仍返回 403 的情况（该 issue 已关闭）。

### 一次实现整页设计可以吗？

可以尝试，但官方 Quickstart 建议一次只做一节，复杂设计仍可能让模型上下文不够用。更稳妥的做法是复制单个 frame 的链接，而不是整份文件的链接。

### 令牌要不要写进参数？

`--figma-api-key` 和 `FIGMA_API_KEY` 都是官方支持的方式。把令牌写进用户级配置时，注意不要提交到 Git。HTTP 共享部署更适合按请求传递令牌，避免多人共用同一份服务账号令牌。

## 来源与许可

仓库 [GLips/Figma-Context-MCP](https://github.com/GLips/Figma-Context-MCP) 使用 MIT 许可。本文依据 2026-11-15 查阅的 README、[Quickstart](https://docs.framelink.ai/quickstart.md)、[Authentication](https://docs.framelink.ai/authentication.md)、[Tools](https://docs.framelink.ai/tools.md) 和 [Troubleshooting](https://docs.framelink.ai/troubleshooting.md)，用自己的话写成，供 CQBase 上下文库使用。若安装命令或令牌范围有变，以这些官方材料为准。

## 收录信息

- 作者: GLips
- 许可证: MIT
- 来源: https://github.com/GLips/Figma-Context-MCP
- 收录: 2026-11-15
- GitHub 星标: 16212（采集 2026-11-15）

