接入编程工具

通过 MCP 把 Ardot 的设计上下文接入日常编程工具，支持两种方式：云端 MCP 无需安装客户端，完成授权后即可在对话中读取有权限的设计稿；本地 MCP 由本机 Ardot 客户端提供，无需授权，可直接操作当前打开的设计稿。

概览

任何支持 MCP HTTP 服务的 AI Agent，都可以接入 Ardot MCP，支持云端与本地两种方式。接入前请先确认以下连接信息：

参数	云端 MCP	本地 MCP
服务名称	ardot-remote	ardot-local
连接类型	HTTP	HTTP
鉴权方式	OAuth 授权	无需授权
服务地址	https://ardot.tencent.com/mcp	http://127.0.0.1:50501/api/v1/mcp
前置条件	无	启动 Ardot 客户端并打开设计文件，连接本地 MCP

整个接入过程分为四步（标注 仅云端 的步骤在接入本地 MCP 时可跳过）：

1. 添加服务：填写服务名称与地址。
2. 确认信任：允许工具调用该 MCP。
3. 仅云端 账号授权：在浏览器中完成 OAuth 授权。
4. 验证连接：在新对话中调用，确认可用。

说明

本地 MCP 由 Ardot 客户端在打开设计文件时自动提供服务，端口被占用时会自动切换，以客户端首页右上角「MCP 配置入口」显示为准，也可在该入口一键启用。各工具章节均按「云端 MCP」与「本地 MCP」两个选项卡分别给出配置步骤。

下面提供两种接入方式。若所用 AI Agent 支持协助写入配置，优先使用 方式一；需要手动设置时，直接在 方式二 中选择对应工具。

方式一：让 AI Agent 协助配置

把对应提示词粘贴到所用 AI Agent 的对话中，让它协助写入 MCP 配置。

在 AI Agent 的对话中粘贴以下提示词：

请帮我配置 Ardot 云端 MCP：服务名称 ardot-remote，类型 http，地址 https://ardot.tencent.com/mcp。配置完成后如需信任确认或 OAuth 授权，请提示我完成当前 AI Agent 的授权流程。

提示

若当前 AI Agent 不支持直接写入配置，请使用下方 方式二 按工具手动添加。

方式二：手动添加 MCP 服务

选择所用 AI Agent 查看对应步骤。云端接入为服务名 ardot-remote 与地址 https://ardot.tencent.com/mcp；本地接入为服务名 ardot-local 与地址 http://127.0.0.1:50501/api/v1/mcp。各工具章节均提供「云端 MCP」与「本地 MCP」两个选项卡，点击切换查看对应配置步骤。

• WorkBuddy —— 在连接器中配置
• CodeBuddy Code —— 通过命令行添加
• Claude Code —— 通过命令行添加
• Codex CLI —— 通过命令行添加
• Cursor —— 在定制页添加
• VS Code —— 在命令面板添加
• 其他支持 MCP 的 AI Agent —— 使用通用 HTTP 配置

WorkBuddy

1. 打开 WorkBuddy，在左侧边栏点击 专家 · 技能 · 连接器，再选择 连接器。

   

2. 在页面右上角点击 自定义连接器，打开「MCP 服务管理」，再点击 添加 MCP。

   

3. 在 mcp.json 编辑器中，于 mcpServers 内加入以下配置（若已有其他服务，保留原有条目即可），然后点击 保存。

   {
     "mcpServers": {
       "ardot-remote": {
         "type": "http",
         "url": "https://ardot.tencent.com/mcp"
       }
     }
   }

   

4. 首次添加后，WorkBuddy 会提示需要信任确认该 MCP，点击 信任。

5. 状态变为「需要认证」后，点击 连接。

   

6. 浏览器打开 Ardot 授权页，确认账号无误后点击 同意授权。

   

7. 验证连接： 回到「MCP 服务管理」，ardot-remote 应显示为已启用，并列出可用工具。

   

CodeBuddy Code

环境要求

Node.js 18.0+

1. 在终端执行以下命令。

   codebuddy mcp add ardot-remote --transport http https://ardot.tencent.com/mcp --scope user

   

2. 输入 codebuddy 进入 CodeBuddy Code，输入 /mcp 可看到新增的 ardot-remote，显示需要 OAuth 授权。

   

3. 切换选中并回车进入二级菜单，选择 Authenticate 回车，浏览器会打开授权页，确认账号无误后点击 同意授权。

   

   

4. 验证连接： 输入 codebuddy mcp list 查看 mcp 是否连接成功。

   

更多配置信息见 CodeBuddy Code 文档。

Claude Code

1. 在终端执行以下命令。

   claude mcp add ardot-remote --transport http https://ardot.tencent.com/mcp --scope user

   

2. 输入 claude 进入 Claude Code，输入 /mcp 可看到新增的 ardot-remote，显示需要 authentication 授权。

   

3. 切换选中并回车进入二级菜单，选择 Authenticate 回车，浏览器会打开授权页，确认账号无误后点击 同意授权。

   

   

4. 验证连接： 输入 claude mcp list 查看 mcp 是否连接成功。

   

更多配置信息见 Claude Code 文档。

Codex CLI

1. 在终端执行以下命令。

   codex mcp add ardot-remote --url https://ardot.tencent.com/mcp

   

2. 浏览器会打开授权页，确认账号无误后点击 同意授权。

   

3. 验证连接： 输入 codex mcp list 查看 mcp 是否连接成功，ardot-remote 显示已连接即成功。

   

更多配置信息见 Codex CLI 文档。

Cursor

1. 点击侧边栏的 Customize 菜单，选择 MCPs 选项，点击 +New。

   

2. 在 mcp.json 编辑器中，于 mcpServers 内加入以下配置（若已有其他服务，保留原有条目即可），然后保存。

   {
     "mcpServers": {
       "ardot-remote": {
         "type": "http",
         "url": "https://ardot.tencent.com/mcp"
       }
     }
   }

   

3. 浏览器打开 Ardot 授权页，确认账号无误后点击 同意授权。

   

4. 验证连接： ardot-remote 显示为已启用。

   

更多配置信息见 Cursor 文档。

VS Code

1. 使用快捷键 Cmd + Shift + P 打开命令面板，执行 MCP: Add Server。

   

2. 选择 HTTP。

   

3. 输入 URL https://ardot.tencent.com/mcp。

   

4. 输入服务名称 ardot-remote。

   

5. 得到如下配置，并弹出授权对话框。

   {
     "servers": {
       "ardot-remote": {
         "type": "http",
         "url": "https://ardot.tencent.com/mcp"
       }
     }
   }

   

6. 弹出打开外部网站对话框，点击 打开，在浏览器完成授权。

   

7. 浏览器打开 Ardot 授权页，确认账号无误后点击 同意授权。

   

8. 添加后效果如下图所示。

   

更多配置信息见 VS Code 文档。

其他支持 MCP 的 AI Agent

文档未单独列出的 AI Agent，只要支持 MCP HTTP 服务，均可在其 MCP 设置中添加。云端与本地两种方式仅服务名与地址不同：

需 OAuth 授权：

{
  "mcpServers": {
    "ardot-remote": {
      "type": "http",
      "url": "https://ardot.tencent.com/mcp"
    }
  }
}

说明

字段名（如 mcpServers、type）以所用 AI Agent 的文档为准；核心是服务名（云端 ardot-remote、本地 ardot-local）与对应地址。云端首次连接通常需完成信任确认与 OAuth 授权。

遇到连接问题时，见 故障排查。