Figma MCP 连不上 Cursor / Claude Code?组织管理员如何设置 OAuth 应用白名单
在组织账号里把 Figma 接到 Cursor 或 Claude Code 时,有时会突然提示需要管理员批准,或是昨天还能用的 MCP 连接今天读不到文件。2026 年 11 月 17 日起,Figma 开始向 Organization 和 Enterprise 套餐推送一项新的管理能力:管理员可以为 OAuth 应用和 MCP 客户端设置白名单(allowlist),只允许名单里的应用访问组织资源。功能会在随后几天陆续出现;如果后台还没看到,稍等即可。本文按帮助中心现行说明,把开启审批、批准应用、成员申请和撤销权限写成可照做的步骤。接入 MCP 本身的配置,见本站 Figma MCP 指南。
先说结论
- 仅 Organization / Enterprise 的管理员可以改策略;默认仍是 Allow all apps,成员可自行连接。
- 改成 Only admin-approved apps 后,不在白名单上的应用会立刻失去对组织资源的访问,已经授权过的连接也包括在内。开启前先把团队常用的 Cursor、Claude Code 等批进去。
- 批准应用时,同时批准它申请的权限范围(scopes),例如读取文件、写评论。批准对整个组织生效,但每个人仍要在自己的 Figma 账号里完成授权。
- 成员在连接未批准应用时,如果管理员允许申请,可点 Request access;通过后会收到邮件和站内通知,然后自己再完成一次授权。
- 这和插件 / 小组件审批不是同一套设置,不要到 Plugin approval 里找 MCP 客户端。
审批是怎么运作的 #
OAuth 应用把外部工具接到 Figma,让设计稿进入其他工作流。这次的管控范围包括 MCP 客户端(官方举例是 Cursor 和 Claude Code),以及其他连接 Figma 的 OAuth 应用。官方维护的客户端目录见 Figma MCP catalog (opens new window)。
管理员有两种策略:
- Allow all apps(默认):成员无需管理员批准即可连接应用。
- Only admin-approved apps:只有白名单上的应用才能访问组织资源。
批准一次,对整个组织生效。但「组织批准」不等于「个人已登录」:成员仍要在自己的账号里授权该应用。如果你同时属于多个组织,一个组织批过,另一个组织仍可能要重新申请。
权限是跟着应用走的。例如某客户端原先只申请了读文件,后来又要写回画布或发表评论,新增的 scopes 需要再次批准;此前已批准的权限可以继续用。
管理员:如何开启「只允许白名单应用」 #
- 在文件浏览器中打开 Admin。
- 在侧栏选择 Extensions。
- 打开 Apps 标签,点 Settings。
- 选择 Only admin-approved apps。
- 确认是否保留 Allow plan members to request apps(允许成员提交申请)。建议先开着,避免同事只能口头找管理员。
- 点 Save。
同一设置也可以从 Admin > Settings > Connections > Apps 进入。
开启前务必先盘点团队在用的客户端和内部工具。官方明确警告:这项策略对已有连接同样生效,不在名单上的应用会失去对组织资源的访问。如果之后改回 Allow all apps,被策略挡住的连接可以恢复,但如果个人授权已过期,成员可能需要重新连接。
管理员:把应用加入白名单 #
可以在有人申请之前先批,也可以在收到申请后再批。
从建议列表批准 #
- 打开 Admin > Extensions > Apps。
- 在 Suggested 区域找到目标应用。
- 点 Approve。
批准后,应用会出现在组织的已批准列表里。
用 Community 链接或 Client ID 添加 #
不在建议列表里的应用,可以用它的 Figma Community URL,或开发者文档里的 client ID 添加:
- 打开 Admin > Extensions > Apps。
- 点 Add app。
- 粘贴 Community 链接或输入 client ID。
- 点 Add app。
审核成员申请 #
- 打开 Admin > Dashboard。
- 在 All requests 里找到应用申请,也可以筛出 app requests。
- 打开详情,核对该应用、申请的权限,以及成员填写的理由。
- 选择 Approve app(加入白名单并批准所申请权限)或 Decline(可附理由)。
同一应用、同一组织、同一组权限的申请会合并显示。如果后来权限变了,例如从只读变成可写,新申请会另成一组。拒绝不会永久封禁,成员可以再次申请。拒绝「额外权限」也不会把应用从白名单里拿掉,只是挡住新增的那部分能力;要彻底停用,需要撤销批准。
成员会收到审批结果通知。通过之后,他们还需要自己完成一次账号授权,应用才会真正连上。
成员:连接被拦截时怎么申请 #
从你要使用的客户端(Cursor、Claude Code 等)按它的说明连接 Figma。如果组织要求审批,Figma 会弹出提示,说明这个应用需要批准。
- 需要的话,填写申请理由(建议写清楚用于哪个项目、读还是写文件)。
- 点 Request access。
申请会交给组织管理员。批准后你会收到邮件和 Figma 站内通知。这时应用只是对组织「可用」了,你仍要回到客户端里完成授权。如果提示要申请的是额外权限,步骤相同;未批准的新权限不能用,已经批准的旧权限不受影响。
申请被拒时,邮件和通知里可能会附上管理员的理由。可以补充工作流说明后再申请一次。
如果界面上完全没有 Request access,多半是管理员关闭了「允许成员申请」。这时只能直接联系组织管理员。已经在用的连接突然读不到组织文件,也可能是管理员改了策略或撤销了该应用的批准,同样需要找管理员核对。更多排障还可对照 Figma MCP 常见问题 (opens new window)。
撤销批准,以及和插件审批的区别 #
若组织已经启用「只允许白名单应用」,要从名单里拿掉某个应用:
- 打开 Admin > Extensions > Apps。
- 选中该应用,点 Revoke approval,再确认一次。
撤销后,所有通过该应用访问组织资源的人都会受影响;应用下一次尝试访问时,已有连接就会失效。官方说明:撤销的是组织侧的访问许可,不会删除成员个人已经做出的授权。方案差异见 Figma 价格与方案。近期条目也记在 更新日志。
另外,组织里还有一套针对插件和小部件的审批(Plugin approval),入口和规则不同,不能用来管理 Cursor、Claude Code 这类 MCP / OAuth 客户端。两套名单要分开维护。
常见问题 #
免费版或 Professional 能开白名单吗? #
不能。官方写明这项管理能力只面向 Organization 和 Enterprise,且只有管理员可改策略。Professional、Starter 或教育版按各自方案使用 MCP 即可,没有这套组织白名单。
管理员批过了,为什么 Cursor 还是连不上? #
组织批准只解决「准不准用」。每个人还要在自己的 Figma 账号里完成授权。另外请确认:当前登录的是有文件权限的那个账号、打开的是 Design / FigJam / Make 文件链接,以及客户端已出现在 MCP catalog (opens new window) 里。可让代理执行 whoami 核对邮箱和席位。
为什么已经批准的客户端又要申请一次? #
常见原因是它新增了权限,例如从只读变成可写回文件。为新增 scopes 再点一次 Request access 即可;旧权限在审核期间仍然可用。
参考来源 #
- Figma Release Notes(2026-11-17:OAuth 应用与 MCP 客户端白名单) (opens new window)
- Figma 帮助中心:Manage OAuth apps and MCP clients for your organization (opens new window)
- Figma 帮助中心:Request approval to connect an app to Figma (opens new window)
- Figma 帮助中心:Figma MCP server FAQs (opens new window)
- Figma MCP catalog (opens new window)
核心手册与速查工具
高频手册与实用设计生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。