如何通过 MCP 将 Figma 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Figma、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Figma + Cursor

让你的 AI 读取你的 Figma 设计：浏览团队文件夹和文件，查看页面、画框和图层，导出图片，查找组件和样式，追踪版本历史，阅读和发布评论，并管理 Dev Mode 链接。使用个人访问令牌。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

FIGMA_ACCESS_TOKEN

步骤 1 — 获取凭证

1. 在 Figma 中打开账户菜单（文件浏览器左上角）→ Settings → Security → Personal access tokens → Generate new token。
2. 为令牌命名（例如 "AnythingMCP"）并选择有效期：最长 90 天，Figma 已不再签发永不过期的令牌。勾选以下权限范围：
   • current_user:read, file_content:read, file_metadata:read, file_versions:read
   • file_comments:read, file_comments:write
   • library_content:read, library_assets:read, team_library_content:read
   • folders:read
   • file_dev_resources:read, file_dev_resources:write
3. 点击 Generate token 并立即复制：Figma 只显示一次。令牌通常以 figd_ 开头。
4. 把令牌填入 FIGMA_ACCESS_TOKEN，不要带 Bearer 字样，然后安装连接器。
5. 先运行 figma_get_me：它会显示该令牌属于哪个 Figma 用户。然后把文件链接发给 AI：文件 key 就是 URL 中 /design/ 后面的部分。

令牌有效期：令牌最长有效 90 天。过期后，用相同的权限范围生成新令牌，再次填入 FIGMA_ACCESS_TOKEN。连接器能看到的正是令牌所属用户可以打开的文件和团队。在 Figma 把项目改名为文件夹（folders）之前创建的令牌可能只有 projects:read，而文件夹相关工具需要 folders:read：如果它们返回 403 并指出某个权限范围，请生成新令牌。

查找团队和文件夹：Figma 的 API 无法列出你所在的团队。请把文件浏览器中某个团队页面的链接发给 AI（团队 id 是 /team/ 后面的数字）；之后通过 figma_list_team_folders, figma_list_subfolders 和 figma_list_folder_files 就能找到文件。

权限和只读设置：不要授予 file_comments:write 和 file_dev_resources:write，并关闭 figma_post_comment, figma_delete_comment, figma_add_comment_reaction, figma_create_dev_resource 和 figma_update_dev_resource。AI 发布的评论会以令牌所属用户的名义显示，所有能访问该文件的人都能看到。

安装时默认关闭：figma_delete_dev_resource，它会为所有人从节点上删除一个 Dev Mode 链接。只有在 AI 需要删除 dev resource 时才打开它。

速率限制和 Starter 方案：Figma 按用户以及文件所属的方案限制请求。读取文件内容、节点和渲染图片（figma_get_file, figma_get_file_nodes, figma_render_images）的限制最严：在拥有 Full 或 Dev 席位的付费方案中每分钟 10 到 20 次，但对于免费 Starter 方案中的文件，或使用 View、Collab 席位时，每月只有寥寥几次。元数据、评论、版本、组件和样式的额度要宽松得多。请让 AI 查看单个画框，而不是整个文件；非常大的响应会在 200 KB 处截断。渲染图片的链接有效期为 30 天。

Dev Mode：dev resource（附加在节点上的工单、文档或代码链接）需要付费方案以及 Full 或 Dev 席位。没有 Dev Mode 访问权限时，即使其他工具能正常读取该文件，Figma 也会对 dev resource 工具返回 "File not found"。每个节点最多 10 个 dev resource，同一 URL 只能添加一次。

常见错误：401 "Invalid token" 表示令牌错误、已过期或已被撤销：请生成新令牌。403 表示令牌缺少某个权限范围（消息中会指出），或该用户无权访问那个团队或文件夹。404 表示文件或节点不存在，或该用户无法打开该文件：请从文件 URL 中重新复制 key。400 会指出无效参数，例如节点 id 用了连字符而不是冒号（链接中的 node-id=12-345 对应 12:345）。429 表示触发了速率限制：稍等后再试。库相关工具不接受分支（branch）的 key：请使用主文件的 key。

连接器不会编辑设计，也不处理变量、Webhook、文件树之外的 FigJam 和 Slides 内容，以及库分析。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 Figma 的工具。

可用工具

示例提示

• “列出 Checkout redesign 文件的页面和主要画框，以及最后编辑它的人。”
• “Checkout redesign 文件中哪些评论还没有解决？分别是谁写的？”
• “把 Acme 官网文件中的价格页画框导出为 PNG，并给我链接。”
• “回复 Lena 在 Checkout redesign 文件中的评论，告诉她按钮颜色已经更新。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Gemini
• 连接到 Meta Muse