用途 figma-mcp 处理所有 /figma-mcp 调用，覆盖两类任务：从 Figma 设计链接或文件 key 检查、实现或还原 UI；以及确认当前宿主是否已正确注册官方远程 MCP 服务器、完成认证并处于可用状态。
主要能力
- 通过各宿主原生注册方式连接 Figma 官方远程服务器 https://mcp.figma.com/mcp，认证走该宿主的 OAuth 流程。
- 解析 Figma 链接：/design/:fileKey/:name?node-id=1-2 得到节点 1:2；分支链接使用 branchKey 作为 fileKey；/make/:key 使用节点 0:1 且仅用 get_design_context；/board/ 为 FigJam，使用 get_figjam。
- 选择首个读取证明：确认访问或列出页面用 get_metadata；实现或还原设计前先加载 figma-design-to-code。
- 区分节点 ID：实例子层 ID（如 I10:20;30:40）仅 get_design_context 与 get_metadata 接受；get_screenshot、get_variable_defs、download_assets 需要普通 123:456 ID。
- 失败分层恢复：工具缺失或服务器未注册、需要认证、账号不匹配、认证后调用失败，分别处理并只报告一个失败层和一个所需操作。
- 账号与凭据按宿主隔离，不跨宿主复制 token、缓存、Cookie 或浏览器配置；whoami 结果只归纳为 CURRENT、MATCH、MISMATCH、UNVERIFIED，不打印载荷。
- 官方 MCP 不提供文件评论工具；需要设计评审评论时说明并参考 REST 评论方案。
- REST 回退：仅对只读数据、宿主不在 Figma 当前 MCP 目录（如 Hermes、WorkBuddy、pi）或需要评论时使用，需用户自己的个人访问令牌，且明确声明 Proof call: REST、Account: PAT owner。不用 REST 处理工具缺失、注册缺失、OAuth 过期、403/404、指定账号请求或任何写入。
使用方式 典型调用为 /figma-mcp <Figma 链接> <UI 任务>，在只读快速路径下直接执行所请求的第一次读取，无需单独 whoami。裸 /figma-mcp 仅做就绪检查，执行一次 whoami 并只回复 FIGMA_MCP_READY。指定账号、切换账号、恢复、写入或多宿主验收时执行一次 whoami。缺少链接或文件 key 时停止并索取。任务成功后继续完成工作，不在任务中途输出就绪标记或身份细节。
工具前置与写入
- get_design_context 前先加载 figma-design-to-code。
- use_figma 前先加载 figma-use。
- create_new_file、generate_diagram、shader/plugin 需要 whoami 获取 planKey，仅在工具参数中传递，不显示在可见文本中。
- get_metadata、get_screenshot、get_variable_defs 无前置要求。
- 写入应在副本或可丢弃文件中测试，写入前刷新目标节点上下文，避免两个智能体同时修改同一文件或节点。
适用场景 在 Claude Code、Codex、Cursor、Grok 等 Figma 当前 MCP 目录所列宿主中，检查设计、按设计稿实现或还原 UI、校验账号与工具链是否就绪，以及在支持目录外宿主做只读设计数据获取。
限制
- 不用于普通网页浏览、桌面导航、通用截图或非 Figma 文件。
- 官方 MCP 不支持的宿主应失败关闭，不得用代理、共享包装或借用客户端身份绕过目录。
- 还原度实现本身由 figma-design-to-code 负责，本技能不重复其工作流。
- 文件中缺少 URL 或 key 时无法继续。
- 官方 MCP 无文件评论工具。
- REST 回退返回内容较少，不含参考代码或 Code Connect，且以令牌所有者身份运行。 有关收费、价格、平台支持范围等更多细节暂未提供。