ardot-mcp 记录的是「如何在 AI大模型或AI智能体 里用腾讯设计 Ardot 来生图、做设计」的已验证端到端流程。Ardot(ardot.tencent.com)是 AI 设计协作平台,它会在你电脑本地起一个 MCP 服务,让 AI大模型或AI智能体 这样的工具直接驱动它画图、排版面。
通过这套 MCP 工具,你可以:在 Ardot 画布里插入画框、用 AI 生成真实图像作为画框填充、把设计稿导出成 PNG、还能截图复核。生成的图是在 Ardot 画布里的可编辑设计稿,适合后续继续在 Ardot 里编辑或转代码。
这个 skill 最关键的价值是踩坑记录:它明确指出「配置对了但工具加载不出来」的根因,以及正确的连接、信任、自检、生图、导出步骤,避免你走弯路。
http://127.0.0.1:50501/api/v1/mcp。~/.ai-agent/mcp.json 里会出现(或需手动写入)ardot-design 条目(type: http,url 为上面的地址,disabled: false)。ardot-design,点击「信任 / 启用」。点击后 AI大模型或AI智能体 会热加载 Ardot 的 MCP 工具到当前会话(不用重开对话)。这是本项目踩过的最大坑。ardot,应返回 fetch_editor_state、batch_edit、export_nodes、capture_screenshot 等。若返回「not found」,回到上一步点「信任」。fetch_editor_state 看当前页面,返回类似 {"currentPage":{"id":"0:1"}} 即表示有一个空画布(根容器 0:1)可直接用。batch_edit 的 operations 参数(注意:必须是字符串,多行用 \n 连接,不能是数组)。先 I() 建画框,再 G(frame, "ai", "prompt") 按提示词生成真实图像作为画框填充。export_nodes,传入生成的 nodeId、输出目录、format: png、scale: 2,得到绝对路径,可直接交给你。capture_screenshot 看截图,确认无视觉错位 / 异常后再交付。你直接对 AI大模型或AI智能体 说:
「在 Ardot 里帮我生成一张 600×800 的写实人像,导出成 PNG 给我。」
AI大模型或AI智能体 会:
先确认 Ardot 工具已加载(没加载就提醒你去连接器点「信任」);然后在一个画框上用 G(ai) 生成图像作填充,再把该画框导出为 PNG 并截图给你复核。你拿到的图是在 Ardot 画布里可继续编辑的设计稿。
你直接对 AI大模型或AI智能体 说:
「AI大模型或AI智能体 里找不到 Ardot 的工具,端口应该是通的。」
AI大模型或AI智能体 会:
先告诉你「十有八九是没点信任」:让你去 AI大模型或AI智能体 右上角「连接器管理 → 自定义连接器」找到 ardot-design 点「信任 / 启用」,热加载后工具就出现在索引里(无需重开对话)。这是配置正确却加载不出来的根因。
进阶 / 可选(端口核查命令)
如果怀疑 MCP 服务根本没起来,可以在命令行核对 50501 端口是否在监听(大白话:看看 Ardot 的本地服务有没有真的在跑)。
batch_edit 的 operations 传多行字符串(含 \n),传数组会报 must be string。I() 建画框,再 G() 给画框上图像填充;不要试图创建独立 image 节点。type: "ai" 走真实生图(长提示词);type: "placeholder" 只是灰色占位框(≤20 字短标签,不是长 prompt)。