03 接入任意兼容 Agent

文档摘要

03 接入任意兼容 Agent 本节摘要:OpenWork 最核心的承诺是「跨工具复用」——你不需要换掉正在用的 Agent(Codex、Claude Code、Cursor 等),只要给它加一个 OpenWork MCP,它就能用上你创建的技能、MCP 连接、服务。本节就讲这件事:怎么把你的 Agent 接进来。这里的关键认知是:OpenWork 对 Agent 是「能力提供者」,不是「Agent 替代品」——你的 Agent 还是你的 Agent,OpenWork 只是让它多了一双能看见你能力库的眼睛和一双能调用它们的手。一、核心承诺:加一个 MCP,不改 Agent 先把这个承诺钉死。OpenWork 的接入方式是给 Agent 加一个 MCP 连接,而不是要求你换 Agent。

03 接入任意兼容 Agent

本节摘要:OpenWork 最核心的承诺是「跨工具复用」——你不需要换掉正在用的 Agent(Codex、Claude Code、Cursor 等),只要给它加一个 OpenWork MCP,它就能用上你创建的技能、MCP 连接、服务。本节就讲这件事:怎么把你的 Agent 接进来。这里的关键认知是:OpenWork 对 Agent 是「能力提供者」,不是「Agent 替代品」——你的 Agent 还是你的 Agent,OpenWork 只是让它多了一双能看见你能力库的眼睛和一双能调用它们的手。

一、核心承诺:加一个 MCP,不改 Agent

先把这个承诺钉死。OpenWork 的接入方式是给 Agent 加一个 MCP 连接,而不是要求你换 Agent。这意味着:

✅ 你继续用你熟悉的 Agent(Claude Code、Cursor、Codex......)
✅ 你的 Agent 的所有习惯、配置、快捷键都不变
✅ 只是它多了一个 MCP server 可调
✅ 这个 MCP server 背后是 OpenWork 的整个能力库


你的 Agent(Claude Code / Cursor / ...)
   │
   ▼ 加一个 OpenWork MCP 连接
   │
你的 Agent + OpenWork 能力库
   (原来能做的 + OpenWork 的技能/MCP/服务)

💡 这个承诺的价值:很多工具要求你「换一个生态」——换编辑器、换 Agent、换工作流。OpenWork 反过来:它适应你现有的工具,只增量地加一个连接。这是它「一次创建、随处分享」理念的体现——能力是平台无关的,接入是无侵入的。

二、MCP:接入的「插头」

接入用的「插头」是 MCP(Model Context Protocol)。MCP 是一个让 AI 标准化连接外部资源的协议(OpenCode 教程第 10 章详讲)。OpenWork 提供一个 MCP server(可以是本地的,也可以是云端的),你的 Agent 作为 MCP 客户端连上它。


你的 Agent(MCP 客户端)
   │ MCP 协议
   ▼
OpenWork MCP server
   │
   ▼
OpenWork 能力库(技能/MCP/服务/记忆)

接入的具体步骤大致是:

拿到 OpenWork MCP 的连接信息:一个 URL(云端)或一个命令(本地),加上必要的凭据。
在你的 Agent 配置里加一个 MCP 连接:不同 Agent 配置方式不同,但都是在它的 MCP 配置里加一条。
重启或刷新 Agent:让它感知到新的 MCP 连接。
验证:问 Agent「你有哪些新工具/能力」,看它能不能看到 OpenWork 提供的能力。

⚠️ 具体配置方式因 Agent 而异:Claude Code、Cursor、Codex 各自的 MCP 配置位置和格式不同。本教程不写死步骤(避免与你的版本不一致),建议查你的 Agent 的官方文档「如何配置 MCP」一节,把 OpenWork 提供的连接信息填进去。

三、接入后:Agent 看到了什么

接入成功后,你的 Agent 通过 OpenWork MCP 看到的是什么?这是第 7 章「meta-MCP」的预告,但这里先给你一个直觉:

Agent 看到的工具永远只有两个(这是 OpenWork 最精巧的设计):

一个检索能力(search):「我想要能做 X 的能力」→ OpenWork 返回匹配的能力列表
一个执行能力(execute):「执行能力 Y」→ OpenWork 帮你跑那个能力


Agent 视角:
   「我有两个新工具:检索能力、执行能力」
   │
   ├─ 检索:「我要处理 PDF」 ──► OpenWork 返回 [能力A, 能力B, ...]
   └─ 执行:「执行能力A」 ──► OpenWork 跑能力A,返回结果

为什么只暴露两个?因为能力数量可以无限增长,如果每个能力都是一个工具,Agent 的工具列表会爆炸(上下文膨胀)。两个工具 + 背后的能力库,既让 Agent 想用什么都能用,又不让它被工具列表淹没。这个设计的完整原理在第 7 章。

四、云端 vs 本地 MCP

OpenWork 的 MCP 有两种部署形态,接入方式略有不同:

形态	连接信息	适合
云端 MCP	一个 URL + 凭据	团队/跨设备复用,能力在云端
本地 MCP	本地命令/端口	个人使用,能力在本地服务端

第一次接触,两种都行——云端 MCP 更简单(不用本地起服务),本地 MCP 更适合你已经在跑桌面形态的场景(直接连本地服务端)。

五、接入失败的常见原因

接入没成功?按这三个方向排查:

症状	最可能原因
Agent 说「连不上 MCP」	连接信息(URL/命令/凭据)填错,或网络不通
Agent 连上了但看不到新工具	MCP 连上了但能力库为空(还没创建能力)
Agent 调能力报错	权限不足、能力本身有问题、或凭据 scope 不够

💡 验证连接的最快方式:接入后,问 Agent「列出你能用的所有工具」,看 OpenWork 提供的两个工具(检索/执行)在不在列表里。在,就说明连上了;不在,就是连接没成功。

六、本节的哲学:无侵入接入

本节背后有一个重要的设计哲学:OpenWork 适应你,不是你适应 OpenWork。这一点贯穿整个产品:

不要求你换 Agent(加 MCP 即可)
不要求你换工作流(能力是增量)
不要求你换平台(桌面/浏览器/消息平台都支持)

理解了这个哲学,你就能理解后续很多设计——为什么 OpenWork 这么强调「分享」「跨工具」「可组合」。它的目标不是成为「另一个孤岛工具」,而是成为「连接所有工具的能力层」。

本节要点回顾

核心承诺:加一个 OpenWork MCP,不改 Agent——你的 Agent 还是你的 Agent,只是多了能力库。
MCP 是接入插头:Agent 作为 MCP 客户端,连 OpenWork 的 MCP server。
接入三步:拿连接信息 → 在 Agent 配置加 MCP → 重启验证;具体格式因 Agent 而异。
接入后 Agent 只看到两个工具(检索/执行)——这是第 7 章 meta-MCP 的预告。
云端 MCP vs 本地 MCP:云端简单,本地适合已跑桌面形态的场景。
哲学:OpenWork 适应你,不是你适应它——这是「能力层」而非「孤岛工具」的定位。

Agent 接进来了,下一步就是真的发起一次会话、看看它如何调用 OpenWork 的能力——下一节。