Ardot腾讯设计MCP生图连接器

Ardot MCP(ardot-mcp)

在 AI大模型或AI智能体 里连接腾讯设计 Ardot,用 MCP 工具生图 / 做设计并导出 PNG 的完整方法

一、这个 skill 是做什么的

ardot-mcp 记录的是「如何在 AI大模型或AI智能体 里用腾讯设计 Ardot 来生图、做设计」的已验证端到端流程。Ardot(ardot.tencent.com)是 AI 设计协作平台,它会在你电脑本地起一个 MCP 服务,让 AI大模型或AI智能体 这样的工具直接驱动它画图、排版面。

通过这套 MCP 工具,你可以:在 Ardot 画布里插入画框、用 AI 生成真实图像作为画框填充、把设计稿导出成 PNG、还能截图复核。生成的图是在 Ardot 画布里的可编辑设计稿,适合后续继续在 Ardot 里编辑或转代码。

这个 skill 最关键的价值是踩坑记录:它明确指出「配置对了但工具加载不出来」的根因,以及正确的连接、信任、自检、生图、导出步骤,避免你走弯路。

二、什么时候用它

三、前置条件 / 准备

四、具体用法(步骤)

  1. 连接自检:动手前先确认工具已加载。让 AI大模型或AI智能体 用 ToolSearch 查 ardot,应返回 fetch_editor_state、batch_edit、export_nodes、capture_screenshot 等。若返回「not found」,回到上一步点「信任」。
  2. 确认有打开的设计文件:调 fetch_editor_state 看当前页面,返回类似 {"currentPage":{"id":"0:1"}} 即表示有一个空画布(根容器 0:1)可直接用。
  3. 插入画框并 AI 生图(单批 batch_edit):用 batch_edit 的 operations 参数(注意:必须是字符串,多行用 \n 连接,不能是数组)。先 I() 建画框,再 G(frame, "ai", "prompt") 按提示词生成真实图像作为画框填充。
  4. 导出 PNG:调 export_nodes,传入生成的 nodeId、输出目录、format: png、scale: 2,得到绝对路径,可直接交给你。
  5. 截屏复核:调 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 的本地服务有没有真的在跑)。

netstat -ano | grep 50501 # 正常应显示 LISTENING;什么都没有说明 Ardot 桌面端 MCP 开关没开或服务未启动

六、常见注意 / 避坑

七、相关 skill / 延伸

← 返回 SKILL 库