Cursor 插件使用说明：Linear 与 Figma

适用版本：Cursor 2.5+（2026 年 2 月起支持原生 Plugin 体系）

两个插件均为官方出品：Linear 插件由 Linear 官方开发并通过 Cursor 验证；Figma 插件由 Figma 官方开发。

更新时间：2026 年 9 月

一、总览：两个插件分别解决什么问题

对比项	Linear 插件	Figma 插件
定位	需求管理：让 Cursor 直接读写 Linear 的 issue / 项目 / 文档	设计转代码：让 Cursor 读取 Figma 设计稿的结构化数据
典型场景	从 issue 拉需求上下文开工、bug 自动建 issue、完成后回写状态	把设计稿 frame 生成组件代码、提取设计 token、检查设计-代码漂移
安装命令	`/add-plugin linear`	`/add-plugin figma`
认证方式	OAuth 浏览器授权（无需手动管 API Key）	OAuth 浏览器授权
技术形态	打包 Linear 官方 MCP 服务器（https://mcp.linear.app/mcp）	打包 Figma 官方远程 MCP 服务器（https://mcp.figma.com/mcp）+ Agent Skills + Rules
权限模型	以你的 Linear 账号权限行动，能看/能改的范围和你本人一致	只能访问你授权的 Figma 文件
费用	免费连接，正常 API 限额	免费连接（Write to canvas 等高级能力需 Figma 付费档位，以官方文档为准）

两者组合起来的完整闭环：Linear 存需求 → Figma 存设计 → Cursor 读两边上下文写代码 → 浏览器验证 → 回写 Linear 状态。

二、Linear 插件：完整使用说明

2.1 它能做什么

Linear 是研发团队的需求/issue 管理工具。装上插件后，Cursor 的 Agent 可以直接操作你的 Linear 工作区：

读取：issue 列表（按团队/状态/负责人/标签筛选）、项目及进度、迭代周期（cycle）、文档、全文搜索
写入：创建 issue、更新状态/优先级/负责人、添加评论

一句话理解价值：你不用再在 Linear 网页和编辑器之间来回切换------需求上下文和任务流转都发生在 Cursor 对话里。

2.2 前置条件

已安装 Cursor（2.5 或以上版本）
有一个 Linear 账号（linear.app，有免费档），且你的团队已在其中建有 workspace
本机装有 Node.js（如果走 mcp.json 手动安装方式才需要；/add-plugin 方式不需要）

2.3 安装步骤

方式一：命令安装（推荐）

在 Cursor 中打开 Chat（对话）面板
输入 /add-plugin linear 并提交
点击 Add Plugin 确认安装

方式二：设置界面安装

打开 Cursor Settings（设置）
进入 Plugins（插件）→ Browse Marketplace
搜索 "Linear" → 点击 Install

方式三：手动添加 MCP 服务器（进阶）

在 Cursor 的 MCP 设置中新增一个 Streamable HTTP 服务器，地址填：

复制代码

https://mcp.linear.app/mcp

或直接编辑 mcp.json：

json 复制代码

{
  "mcpServers": {
    "Linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
    }
  }
}

2.4 授权

安装后，进入 Cursor Settings → Tools & MCP（或 MCP 标签页）
在 Installed MCP Servers 里找到 Linear，点击 Connect
浏览器会自动打开 Linear 的 OAuth 授权页，点击允许
回到 Cursor，确认 Linear 服务器状态为已启用（绿色）

注意：MCP 授权偶尔需要多次尝试。如果状态异常，在 MCP 设置里对该服务器点 "重新加载（Reload）"。

2.5 验证是否成功

在 Chat 里输入这句测试：

复制代码

list all issues related to this project

如果能返回 issue 列表，说明链路已通。你也可以到 MCP 设置里查看 Linear 服务器暴露的全部工具清单。

2.6 核心工具速查

工具	功能	常用参数/说明
list_issues	搜索/列出 issue	可按负责人、状态、团队、标签筛选
create_issue	创建新 issue	标题、描述（支持 Markdown）、团队、优先级、状态
update_issue	更新 issue	状态、优先级、负责人、标签、估时
create_comment	在 issue 下添加评论	常用于回写"已修复，PR 见 xxx"
list_projects	列出项目及进度	项目健康度一目了然
list_cycles	列出迭代周期及其中 issue	站会/周报素材
search	工作区全文搜索	找历史需求、找相关讨论

2.7 典型用法与提示词

场景 1：开工前拉需求上下文

复制代码

读取 ENG-142 这个 issue 的完整描述和评论，然后按需求实现。

场景 2：发现 bug，顺手建单

复制代码

我在 src/auth.ts 里发现 token 过期后没有刷新的问题，
帮我创建一个高优先级 issue 到 Backend 团队，标题写
"修复 token 过期后未自动刷新"，描述里附上复现步骤。

场景 3：完成后回写状态

复制代码

这个功能已经完成并通过测试，把 ENG-142 的状态改为 Done，
并在下面评论"实现位于 src/checkout/ 目录，共 3 个文件"。

场景 4：迭代盘点

复制代码

列出当前 cycle 的所有未完成 issue，按优先级排序，
标出哪些有延期风险。

2.8 注意事项

权限即身份：MCP 以你的账号权限行动，你改不了的它也改不了；授权范围随时可在 Linear → Settings → API → Authorized applications 里查看和撤销。
限额：走正常 Linear API 速率限制，日常对话量级完全够用。
别把敏感内容写进 issue：Agent 能读到的内容 = 你 workspace 里它有权访问的一切，注意别让它把密钥之类的东西写进描述。

三、Figma 插件：完整使用说明

3.1 它能做什么

Figma MCP 服务器给 Cursor 提供对 Figma 文件的结构化访问（不是截图，是带语义的组件/变量/布局数据）：

读设计上下文：组件、变量（颜色/间距/圆角/字号）、Auto Layout 布局数据、FigJam 内容、Make 资源
frame 转代码：选中一个 frame，直接生成匹配的代码
Code Connect：把 Figma 组件和代码库里的真实组件关联，生成代码时强制复用你的组件库而不是瞎写
写回画布：让 Agent 直接在 Figma 文件里创建/修改原生内容（frame、组件、变量、Auto Layout），也可以把线上网页以可编辑图层的形式送回 Figma

一句话理解价值：AI 看到的不再是"一张图片"，而是"结构化的设计意图"，所以还原度从"大概像"变成"接近像素级"。

3.2 前置条件

已安装 Cursor（2.5+）
有 Figma 账号，且设计文件对账号可见（自己创建的，或团队成员分享给你的）
使用远程 MCP 服务器（推荐）不需要装 Figma 桌面端；只有走桌面版服务器才需要

3.3 安装步骤（远程服务器，推荐）

打开 Cursor，按 Ctrl + Shift + P（Mac 为 Cmd + Shift + P）打开命令面板
搜索 "Open chat" 并回车
在输入框输入 /add-plugin figma 并提交，点 Add Plugin 确认
再次打开命令面板，搜索 "Cursor Settings" 并进入
选择 Tools & MCP 标签
在 Installed MCP Servers 下找到 Figma，点 Connect，走完浏览器授权（点 Allow access）

这个插件一次装好四样东西：

包含内容	作用
MCP 服务器配置	连接 https://mcp.figma.com/mcp
实现 designs 的 Skill	教 Agent 按正确流程把 frame 变成代码
Code Connect 的 Skill	教 Agent 关联组件并复用你的组件库
设计系统 Rules + 资源处理 Rules	规范从 Figma 取用资源的姿势

3.4 备选：桌面版 MCP 服务器（仅特殊场景）

仅当组织有特殊合规/企业要求时才需要。步骤：

安装并打开 Figma 桌面应用，打开一个设计文件
画布无选中状态时，点击工具栏切换到 Dev Mode
在右侧栏启用 MCP server，复制提示的服务地址
在 Cursor：命令面板 → Cursor Settings → MCP → Add Custom MCP，粘贴：

json 复制代码

{
  "mcpServers": {
    "figma-desktop": {
      "url": "http://127.0.0.1:3845/mcp"
    }
  }
}

一般用户直接忽略这节，用远程版即可------远程版功能最全。

3.5 基本用法：从设计到代码

核心操作就三步：

在 Figma 网页/桌面端，右键某个 frame → Copy link（也可以只选中 frame 后从地址栏取链接）
回到 Cursor Chat，把链接粘进提示词
用自然语言描述你要什么

提示词示例（由浅入深）：

复制代码

读取这个 frame 的设计，告诉我主色、正文字体和标题字体：
https://www.figma.com/design/xxxxx/yyy?node-id=123-456

把这个定价卡片 frame 实现成 React + Tailwind 组件，要求响应式：
https://www.figma.com/design/xxxxx/yyy?node-id=123-456

读取这个文件里的所有颜色样式和文字样式，列出精确值，
再对比我项目里的 CSS 变量，找出哪些已经和设计稿不一致了。

关键机制：Cursor 会从链接里提取 node-id 来定位设计节点，所以链接必须精确指到 frame/图层，别只丢整个文件链接------大文件会浪费大量 token。

3.6 想要高还原度，设计稿要先"规矩"

AI 生成代码的质量高度依赖设计文件的结构化程度。给设计师（或自己）的建议：

做法	为什么
复用元素做成组件（按钮/卡片/输入框）	Agent 能识别并映射到代码组件
用 Code Connect 把组件关联到代码库	这是保持代码一致性最有效的手段，没关联等于让模型猜
颜色/间距/圆角/字号全部用变量定义	生成代码时直接得到正确的设计 token
图层语义化命名（CardContainer，而不是 Group 5）	命名即语义，乱名 = 瞎猜
用 Auto Layout 表达响应式意图	生成代码天然对齐 flex 布局；生成前拖一下 frame 确认布局行为符合预期
难以视觉传达的意图写注释/dev notes	交互行为、对齐规则等额外说明

3.7 进阶玩法

提取品牌套件："从这个文件列出品牌色 hex 值、标题/正文字体，并导出 logo"
设计-代码漂移检查："读取设计 token，告诉我哪些 CSS 变量已不匹配" ------ 适合放进定期维护任务
写回画布：让 Agent 在 Figma 里创建/修改 frame、组件、变量（需要装 Figma 官方 Skills 才稳）
网页回流：把线上页面以可编辑图层送回 Figma，先在设计稿上改布局，再让 Cursor 改代码，形成"设计稿即预览"的双向流

3.8 注意事项

文件必须先授权：云端连接器只读你授权过的文件
大文件很耗 token：永远指向具体的 frame 或组件，不要整文件甩过去
它偏读，不偏画：读取和检查很强，但"替你重画整个设计稿"不是强项
结构决定上限：设计文件本身越规范（组件/变量/命名），输出越好；垃圾进垃圾出

四、两者联动的推荐工作流

一个功能从需求到上线的完整闭环：

需求进入：Linear 里有人提了 issue（或让 Cursor 从 bug 报告自动创建 issue）
设计产出：设计师在 Figma 完成设计稿，frame 链接贴到 issue 里
开工：在 Cursor 里说------"读取 ENG-142，用里面附的 Figma 链接实现这个功能，复用 src/components/ui 里的现有组件"
验证：用 Cursor 内置浏览器跑一遍页面，检查 console 和交互
回写："验证通过，把 ENG-142 置为 Done，评论附上改动文件清单和 PR 链接"

配套建议：给项目加一条组件复用规则（.cursor/rules/ui-components.mdc）：

复制代码

---
description: Implementing designs and building UI
---
- 优先复用 /src/components/ui 中的现有组件
- 找不到合适的组件时，通过组合现有组件创建新组件
- 缺组件或设计不明确时，先询问如何处理

五、常见问题排查

症状	处理办法
MCP 服务器一直转圈/未授权	MCP 设置里点该服务器的 Reload 重试；OAuth 偶尔需要多次尝试
授权成功了但查不到数据	确认账号权限：Linear 里你是否能看到那些 issue；Figma 文件是否对你授权
Figma 链接丢进去没反应	确认链接指向具体 frame（带 node-id 参数），而不是文件首页
生成代码与设计偏差大	检查设计稿是否用了 Auto Layout、语义化命名、变量；优先配 Code Connect
想撤销授权	Linear：Settings → API → Authorized applications；Figma：账号设置的已连接应用

六、信息来源

Cursor 官方 Web 开发指南（cursor.com/for/web-development）
Cursor Marketplace：cursor.com/marketplace/linear
Figma 官方帮助中心：help.figma.com（Cursor and Figma: Set up the MCP server）
Figma 开发者文档：developers.figma.com/docs/figma-mcp-server
Linear 官方插件仓库：github.com/linear/cursor-plugin