Open Design Docs

集成

了解集成页面中的 MCP、连接器、技能和随处使用分别解决什么问题。

左侧导航里的「集成」用于把 Open Design 和外部工具连接起来。普通用户日常生成页面、PPT、图片时,不一定需要配置集成;当任务需要读取外部资料、调用外部工具,或把 Open Design 接到其他智能体工具里时,才会用到这里。

GLOSSARY / 术语说明

集成

集成是把 Open Design 和外部工具连接起来的能力。外部工具可以是文件服务、设计工具、代码工具、数据工具、MCP 服务器、账号服务或其他智能体工作环境。

当你希望 Open Design 使用外部资料、调用外部能力,或让别的工具也能使用 Open Design 时,就会用到集成。它解决的是「Open Design 不只在自己窗口里工作,还能和其他工具配合」的问题。

使用前,需要知道要连接哪个工具、为什么要连接、是否需要账号或密钥。如果涉及密钥、权限或账号授权,建议按配置说明操作,或让维护者协助。

集成页面有哪些标签

标签作用适合谁使用
MCP 服务器添加外部 MCP 工具,让 Open Design 或 Coding Agent 可以调用需要图片理解、网页抓取、文件访问、专业工具能力时使用
连接器连接账号和 API,例如日历、文档、任务系统等需要读取外部账号资料或业务系统数据时使用
技能预留给技能级集成管理当前普通用户可以先不用
随处使用把 Open Design 接入 CLI、HTTP、MCP 或其他智能体环境主要给熟悉工具配置的用户使用

MCP 服务器

MCP 服务器是集成页里最常见也最容易被问到的区域。它可以让 Open Design 连接某个外部能力,例如图片理解、网页读取、文件处理、浏览器操作、设计工具或其他专项工具。

GLOSSARY / 术语说明

MCP

MCP 是一种让 AI 工具互相连接的协议。不需要记住它的英文全称,可以把它理解为「给 AI 助手接外部工具的标准插口」。

当模型本身做不了某件事,或者需要额外工具辅助时,就可能用到 MCP。例如文字模型不擅长看图,就可以通过图片理解 MCP 帮它读取图片信息;需要读取网页、文件或外部系统时,也可以通过相应 MCP 提供能力。

使用 MCP 前,需要知道要添加哪个 MCP、它需要哪些账号或密钥、是否由统一提供。如果只是普通文字生成任务,不需要先配置 MCP。

添加 MCP 的基本流程

  1. 点击左侧导航「集成」
  2. 打开 MCP 服务器 标签
  3. 点击 添加服务器
  4. 在模板列表里搜索要添加的 MCP
  5. 如果有模板,点击模板卡片;如果没有模板,选择 Custom server
  6. 展开新增的 MCP 配置行
  7. 按配置说明中的信息填写名称、连接方式、地址或命令、密钥等内容
  8. 打开启用开关
  9. 点击 保存更改
  10. 如果页面出现 Connect,点击后在弹出的授权页面完成连接
  11. 回到主页或项目页,在输入框中用 @ 提及这个 MCP,或直接说明「使用已配置的图片理解 MCP 处理这张图」

MCP 配置项怎么理解

配置项通俗解释怎么选
ID这个 MCP 的标识名称保持默认或使用配置说明中的名称
Display name显示名称写成自己能看懂的名字,例如「图片理解 MCP」
Transport连接方式按配置说明选择,不确定不要乱改
Command本机启动命令只有 stdio 类型会用到,通常照配置填写
Args命令参数通常照配置填写
Env环境变量或密钥填对应服务的 Key、Token 等,注意不要发到公开群
URL远程服务地址HTTP 或 SSE 类型会用到,照配置填写
Headers请求头信息某些服务需要 Token 时填写,按配置来
OAuth mode授权方式需要登录授权时选择 Managed OAuth,否则保持默认
GLOSSARY / 术语说明

密钥

密钥是一串用于证明你有权限访问某个服务的字符,例如 API Key、Token。可以把它理解成「给系统看的密码」。

当 Open Design 需要连接外部服务时,外部服务可能会要求密钥。没有正确密钥,就无法读取资料或调用能力。

使用密钥时,只填到对应配置框里,不要写进文档、截图、聊天记录或公开群。如果不确定某个密钥能不能使用,请先问维护者。

连接器

连接器用于连接外部账号和 API。它更像是「账号级连接」,例如让 Open Design 读取某个工具里的资料、任务、日历、文档或业务记录。

GLOSSARY / 术语说明

连接器

连接器是连接外部账号或业务系统的入口。它可以让 Open Design 在获得授权后读取某些外部信息,或调用外部服务完成动作。

当任务需要使用外部系统中的真实数据时,就可能用到连接器。例如根据日历准备会议摘要、根据项目管理工具整理任务、根据文档系统汇总资料。

使用连接器前,需要确认当前账号是否允许连接该账号、是否需要 Composio API Key 或其他授权信息。涉及业务数据时,优先按使用规范操作。

使用连接器的基本流程

  1. 点击左侧导航「集成」
  2. 打开 连接器 标签
  3. 如果页面要求 API Key,先按配置说明填写并保存
  4. 搜索要连接的服务
  5. 点击服务卡片上的 连接
  6. 在弹出的授权页面完成登录或授权
  7. 回到 Open Design,确认状态显示为已连接
  8. 在项目或自动化任务里,通过 @ 提及连接器,或在需求中说明要使用哪个连接器

常见按钮:

按钮作用使用方式
保存密钥保存连接器所需的 API Key填好对应服务的 Key 后点击
获取 API 密钥打开获取密钥的页面没有 Key 时使用
连接授权某个外部服务确认账号正确后点击
断开连接取消外部服务授权不再使用或账号连错时点击
配置调整连接器设置按配置说明修改
搜索查找连接器连接器很多时输入服务名称

技能

集成页里的「技能」用于后续管理更细粒度的能力接入。当前如果页面显示「即将上线」或说明还在迁移,普通用户可以先忽略。

如果只是想使用某个可复用流程,优先看 插件;如果只是想生成内容,直接回主页输入需求。

随处使用

「随处使用」用于把 Open Design 接到其他工作环境里,例如 CLI、HTTP、MCP 或智能体工具。它主要面向熟悉工具配置的用户。

GLOSSARY / 术语说明

随处使用

随处使用是把 Open Design 能力开放给其他工具的入口。它让外部智能体、脚本或 IDE 也能调用 Open Design 的能力,而不是只能在 Open Design 窗口里操作。

当需要把 Open Design 放进更大的工作流程里,例如自动化脚本、代码智能体或后台工具链时,就会用到它。

普通用户不需要主动配置这个功能。如果需要接入,请把页面里的配置说明发给维护者,由他们判断使用 CLI、HTTP 还是 MCP。

图片理解 MCP 和模型切换怎么配合

如果正在使用的文字模型不支持看图,上传图片后可能无法准确理解图片内容。通常有两种方式:

方式适合场景怎么做
切换到支持图片理解的模型当前任务主要围绕图片、截图、界面稿在模型设置里切到支持图片理解的模型后再发送图片任务
使用图片理解 MCP想继续使用当前文字模型,但需要额外工具帮忙读图在集成里配置图片理解 MCP,然后在任务里说明「使用图片理解 MCP 读取这张图」

对用户来说,最简单的判断是:如果只是偶尔上传截图让 Open Design 看图,优先切换到支持图片理解的模型;如果后续经常要在固定流程里处理图片,再配置图片理解 MCP。

常见问题

问题处理方式
我平时要不要配置集成不一定。普通生成任务可以直接用主页
MCP 和连接器有什么区别MCP 更像给 AI 接工具;连接器更像连接账号和业务系统
添加 MCP 后没有生效确认已启用、已保存,并在任务里明确提到要使用它
连接器连不上检查密钥、账号权限和授权页面是否完成
不知道某个 Key 填哪里不要乱填,把页面和配置说明发给维护者确认
担心暴露密钥不要截图完整密钥,不要把密钥写进需求、文档或群消息

Comments

评论与提问

欢迎补充问题或反馈。提交评论时需要登录,评论会先进入审核。

0 条

还没有公开评论。你可以提交第一个问题。

提交时会提示登录。 请勿填写手机号、API Key、密码等敏感信息。