截至 2026 年 10 月 26 日，Figma 已确认可通过 Figma MCP 调用 Weave 图片和视频模型；但账户关联、活动工作区、客户端支持或模型边界不匹配，仍会让工具消失或任务停住。(Figma 发布说明)
症状 → 最快解法：工具不可见，先确认 Figma 与 Weave 账户已关联、当前 Weave 工作区选对，再核对 Agent 客户端是否受支持。
症状 → 最快解法：工具能看见但任务不运行，先分清是运行已发布的 Weave 工具还是直接调用模型，再核对输入素材与费用确认。通过 MCP 不需要另配独立的 Weave MCP 服务器，也不能创建或编辑 Weave 工作流。(Figma Weave MCP 官方说明)
谁该看：使用外部 AI Agent 制作图片或视频、遇到工具不可见或任务无法启动的设计师。
负责创意工具链的维护者，可用本文核对账户、工作区与共享权限。
以 Windows 为主的自由职业者，也可以据此判断问题是否真的需要 macOS 环境。
最后更新于 2026 年 10 月 27 日，功能与额度信息核对自 Figma 官方发布说明、Weave MCP 帮助中心及 Figma MCP 指南。
SECTION 01工具不可见：先分清连接故障与客户端范围
Agent 中完全没有 Figma Weave 工具时，先查什么？先不要重装软件：确认 Figma 账户与 Weave 账户已关联，再看 Figma MCP 是否连接成功，以及当前客户端是否在官方支持列表内。Figma 的远程 MCP 服务器连接到 Figma；Weave 工具通过这条连接提供，不是需要分别安装的两套 MCP 服务器。(Figma MCP 连接指南)
Figma 官方说明了远程服务器与桌面服务器两种连接方式：远程方式不要求打开 Figma 桌面应用，桌面方式则依赖桌面应用和相应账户条件。不要把“客户端能连接 Figma MCP”直接等同于“该客户端已经支持 Weave 工具”；按官方支持目录核对范围，未列出的客户端不要假设可用。(Figma MCP 服务器指南)
| 症状 | 优先核对 | 下一步 |
|---|---|---|
| Agent 没有任何 Figma 工具 | MCP 服务器地址、登录状态、客户端支持范围 | 重新授权并刷新客户端工具列表 |
| Figma 工具可见，Weave 工具缺失 | Figma 与 Weave 账户关联、当前活动工作区 | 到 Weave 的关联账户设置检查登录账户 |
| 某个 Weave 工具不在列表里 | 发布状态、工作区共享、个人访问权限 | 确认工具已发布，并对你或当前工作区开放 |
Figma 与 Weave 是分开的产品；即使使用同一组登录凭据，也应实际确认关联状态，而不是只凭“我能登录两个产品”推断已经连接。Weave 的账户设置中，可以在 Settings → Profile → Linked accounts 检查并关联 Figma 账户。(Figma Weave 常见问题)
是否还要另外添加 Weave 的 MCP 地址？不需要另建独立的 Weave MCP 连接；需要检查的是 Figma MCP 连接、账户关联和客户端支持。首次连接 Figma 远程 MCP 时，按客户端说明完成账户授权即可。
SECTION 02工具列表不对：检查活动工作区和共享范围
账户已关联但列表仍不对时，检查 Weave 当前选中的活动工作区。Agent 能列出的工具包括你自己的工具、共享给该工作区的工具，以及通过电子邮件分享给你的工具；未发布的私人工具不会因为账户已关联就自动出现在列表中。(Figma Weave MCP 官方说明)
不要把切换 Figma 团队当作切换 Weave 工作区：两者不是同一个工作区选择。可在 Weave 中确认当前工作区，再让 Agent 重新列出工具；若目标工具仍缺席，核实它是否已发布、是否共享给当前工作区或你的账户。已有工具链接时，直接提供给 Agent，有助于跳过列表搜索。
账户已关联但工具列表依旧不完整，通常是哪里没对上？关联只解决账户之间的连接，不会自动授予每个 Weave 工具的访问权限。当前工作区、工具发布状态和共享对象仍会决定 Agent 能否列出或运行该工具；逐项检查比反复重新连接更有效。
SECTION 03模型不可运行：不要把“工具”与“模型”混为一谈
Weave 中的“工具”是已发布的工作流；“直接调用模型”则是让 Agent 查找系统模型并运行。两种方式都可以从 Figma MCP 发起，但输入要求和错误位置不同。官方工具说明中列出了列出工具、查看工具输入、运行工具、查找模型及查看运行结果等操作，可据此判断 Agent 是否选错路径。(Figma MCP 工具与示例说明)
| 你的任务 | 对应路径 | 需要记住的边界 |
|---|---|---|
| 运行团队或个人发布的创意流程 | 列出并运行 Weave 工具 | 工具必须已发布，并对你或当前工作区开放 |
| 直接生成图片或视频 | 查找并运行系统模型 | 通过 MCP 直接运行仅支持现有系统模型，不支持导入模型 |
| 新建或修改 Weave 节点工作流 | 在 Weave 产品中编辑 | 不能通过 Figma MCP 创建或编辑 Weave 工作流 |
目标是导入模型时，能否让 MCP 直接运行它？不能把“模型可在 Weave 使用”推断成“可由 MCP 直接运行”。官方说明当前 MCP 的直接模型路径只支持现有系统模型；如果目标是导入的模型，改用已经发布且适用的 Weave 工具，或在 Weave 中处理工作流，不要继续尝试 MCP 直调。(Figma Weave MCP 官方说明)
SECTION 04启动前卡住：逐个核对输入、授权和额度
运行请求尚未开始时，优先看 Agent 是否提示缺少或无效输入，以及是否需要费用确认。前一种情况表示必填输入不完整；后一种情况表示需要你先批准本次费用。若 Agent 没展示确认信息或你没有批准，不要把任务误判为已经开始运行。(Figma MCP 工具与示例说明)
上传素材也要按目标工具要求检查。官方工具说明列出可上传的常见图片、视频、音频和三维文件格式；具体工具还可能要求特定输入节点、提示词或素材类型。无法满足时，先查工具的输入定义，或按要求重新上传，不要把格式不合或缺少必填项当成 MCP 断连。
调用图片或视频模型时，会扣哪类额度？Weave 工具和直接模型运行使用 Weave credits，不是 Figma AI credits；运行前 Agent 会展示费用并要求确认。具体消耗随所选模型或工具而变，不应假定固定点数或免费条件，也不要把在 Figma 内运行 Weave 工具的额度规则套用到通过 MCP 发起的运行。(Figma MCP 常见问题)
SECTION 05任务已启动但无结果：看状态而不是猜故障
任务已经启动，却没有结果时，区分“仍在处理”“运行失败”和“结果已完成但未显示”。对于已发布工具，Agent 可查询运行状态、错误和输出；直接模型运行则有对应的模型运行状态与结果查询。确认 Agent 正在追踪正确的运行记录，再检查结果是否返回到对话或预期位置。
如果确实需要停止未完成的工具运行，可使用支持的取消操作；取消不能撤销。长时间等待本身不足以证明模型故障，先检查当前状态与错误详情，再决定是否取消、补交输入或重新发起任务。模型运行与已发布工具运行使用不同的结果查询路径，检查错路径可能让你误以为输出丢失。
⚠️ 如果错误明确写着客户端连接模型提供方失败，这类信息可能来自 Agent 客户端，而非 Figma MCP 服务器；先查看客户端登录状态与错误日志，再决定是否报告服务器问题。
SECTION 06执行清单：按顺序缩小故障范围
- [ ] 确认你正在使用的 Figma 账户，并在 Weave 的关联账户设置中确认它已连接。
- [ ] 确认 Figma MCP 客户端出现在官方支持列表中，并核对该客户端的连接方式。
- [ ] 检查当前活动的 Weave 工作区，不要用切换 Figma 团队代替这一步。
- [ ] 确认目标 Weave 工具已经发布，并已共享给你或当前工作区。
- [ ] 判断任务是运行已发布工具，还是直接调用系统模型；若模型是导入的，不要尝试 MCP 直调。
- [ ] 对照工具输入定义核验必填内容与素材格式，并留意费用确认提示及 Weave credits 余额。
- [ ] 任务启动后查询对应运行状态；区分仍在运行、失败、取消和已完成但结果未显示。
SECTION 07是否需要 Mac：先修复调用链，再看后续创作需求
如果故障来自账户关联、活动工作区、工具共享、客户端支持、模型类型或费用确认，租用 Mac 并不会替你修复这些配置；Figma MCP 的远程服务器也不等于必须在 Mac 上运行。先按官方连接指南排除调用问题，只有后续创作环节确实依赖 macOS 专属软件或客户端时，再评估远程 Mac 是否合适。
当前方案的限制也应算清：你仍受账户与工作区权限约束，客户端必须在支持范围内，生成任务还会消耗 Weave credits；而切换到 Mac 本身不会绕过这些限制。若只是临时需要 macOS 创作环境，可先查看 MACNOX 的方案信息，并通过 MACNOX 服务说明核对是否符合你的具体软件与工作流需求；如果创作长期依赖本地设备或实体接口，则优先评估自购设备。