外部 MCP | Open Design Docs

「外部 MCP」用于接入外部工具或服务。普通用户如果只是创建页面、PPT、图片，通常不需要配置这里；当某个任务明确要求添加 MCP 时，再按说明操作。

MCP 可以理解为一种「让 AI 工具连接外部服务的标准方式」。接入后，Open Design 或 Coding Agent 可以通过它读取外部系统的信息，或调用外部工具完成任务。

当模型本身能力不够，或者任务需要额外工具时，就会用到 MCP。例如图片理解、网页读取、GitHub、文件系统、设计工具等。

使用前，需要知道要添加哪个 MCP、它需要什么地址、命令、账号或密钥。配置以服务页面或配置说明为准。

它和「MCP 服务器」的区别

「外部 MCP」是让 Open Design 作为客户端去连接第三方 MCP 服务器，并在任务运行时把这些工具交给支持的 Coding Agent 使用。

设置里的「MCP 服务器」是另一件事：它用于把 Open Design 自己暴露成 MCP 服务器，方便 Cursor、Claude Code、VS Code 等外部客户端调用 Open Design 的能力。要接入第三方工具，请进入「外部 MCP」。

外部 MCP 不使用全局自动保存。新增、修改、排序、启用或删除服务器后，需要点击页面底部的 保存更改。保存后配置会写入本机的 .od/mcp-config.json，按钮会显示保存状态。

打开设置里的「外部 MCP」
点击 添加服务器
在模板选择器里搜索或按分类选择需要的 MCP；没有合适模板时选择 Custom server
展开服务器行，确认 ID、显示名称、连接方式和默认参数
stdio 服务器填写 Command、Args、Env；SSE 或 streamable HTTP 服务器填写 URL、OAuth mode 和 Headers
如果需要密钥，填入环境变量或请求头
打开启用开关
点击 保存更改
如果该 HTTP / SSE 服务器使用托管 OAuth，保存后点击 Connect 完成授权
回到任务输入框，用 @ 提及该 MCP，或在需求里说明要使用它

按钮	作用	使用方式
添加服务器	打开模板选择器	按分类或搜索选择模板，也可以选择自定义
保存更改	保存当前 MCP 配置	新增或修改后必须点击
启用开关	控制该 MCP 是否可用	暂时不用时可以关闭
展开 / 收起	查看或隐藏详细配置	需要修改 URL、命令、密钥时展开
上移 / 下移	调整服务器顺序	有多个服务器时整理列表
删除	移除这个 MCP	确认不再使用时删除
Connect	授权连接	使用托管 OAuth 的 HTTP / SSE MCP 保存后点击
Reconnect	重新授权	账号变化或授权失效时使用
Refresh	重新检查授权状态	已在浏览器完成授权但页面未更新时使用
Disconnect	断开授权	换账号或不再使用时点击

stdio 适合通过本机命令启动的 MCP，例如 npx、uvx、node 或某个可执行文件。这类服务器通常需要填写命令、参数和环境变量。

SSE 和 streamable HTTP 适合已经部署好的远程 MCP 服务。这类服务器通常需要填写 URL；如果服务需要 Token，可填在 Headers 中。如果服务支持 Open Design 托管 OAuth，页面会在保存后显示连接按钮。

模板会预填大部分字段，仍然可以在保存前手动修改。

页面顶部会显示当前已安装的 Coding Agent 中，哪些会接收这里配置的外部 MCP，哪些不会。部分 ACP 适配器只接收 stdio MCP；HTTP 和 SSE 项即使保存了，也可能不会传给这些适配器。

如果某个已安装 Agent 显示为不支持转发，请在该 Agent 自己的配置文件中单独配置 MCP。

如果当前文字模型不支持看图，但又需要处理截图或界面图，可以使用图片理解 MCP。它的作用是先帮模型读懂图片，再让模型继续完成文字、页面或文档任务。

如果只是偶尔上传截图，优先切换到支持图片理解的模型；如果固定流程经常需要读图，再配置图片理解 MCP。

问题	处理方式
添加后没生效	确认已启用、已保存，并在任务里明确提到要使用它
不知道填 stdio、HTTP 还是 SSE	按配置说明填写，不要自行猜
需要填密钥	只填到设置框里，不要写进任务文本或文档
保存按钮不能点	当前没有未保存更改，或正在保存
Connect 没出现	只有已保存的 HTTP / SSE 服务器，并且 OAuth mode 为托管 OAuth 时才会出现