HarnessRouter Plugins 与 MCP 详解：Browser、GitHub、Vercel 如何装进一个 Agent-二趣网

HarnessRouter Plugins 与 MCP 详解：Browser、GitHub、Vercel 如何装进一个 Agent

【免费下载链接】harnessrouterHarnessRouter Community Edition: the self-hosted, Apache-2.0 edition of the unified interface for agent harnesses. Run Codex, Claude Code, Hermes, PI, DSH, and more through one API, with sessions, streaming, files, cancellation, and failure handling. Implements the Unified Harness Protocol (UHP), an open standard. Your keys, your infrastructure.项目地址: https://gitcode.com/gh_mirrors/ha/harnessrouter

HarnessRouter（HarnessRouter Community Edition）是一个自托管的 Agent 统一接口层，把 Codex、Claude Code、Hermes 等 Agent 运行时（harness）变成一个 API 背后的可插拔后端。这篇教程讲透它最容易被忽略的一层能力：如何通过Plugins（插件）与MCP 服务器，把 Browser、GitHub、Vercel 这三类外部服务能力装进同一个 Agent，让它既能打开网页、又能读写你的代码仓库、还能查看 Vercel 项目的部署。

先搞清楚：Plugins 和 MCP 是两层不同的东西

很多新手会把这两个概念混为一谈，但在 HarnessRouter 里它们处在两个层次：

层次	是什么	连接一次还是每次	典型例子
Plugins（plugs）	工作区（workspace）级别的服务，连一次，所有 harness 共享	连一次	Browser、GitHub、Vercel、InsForge
MCP 服务器	harness 级别的工具，挂在某个具体 harness 上	每个 harness 配置	你自己接入的任意 MCP 端点

一句话理解：Plugins 是“水电煤”，MCP 是“自定义插座”。Plugins 由实例统一管理、统一记账、统一安全护栏；MCP 服务器则是你在单个 harness 的 Tools 配置里按需添加的外部能力。两者的产物最终都会合并成 Agent 每一轮任务真正生效的工具集合（详见协议定义 harnesses.md 中mcpServers与plugins字段的说明）。

一键装进 Browser：Agent 从此会看网页

Browser 插件让 Agent 拥有一个真实浏览器：打开页面、读取正文、点击、输入、滚动、等待、截图、前进后退、切换标签页——共 13 个工具，但刻意不提供JavaScript 执行和下载能力，这是刻意的安全设计。

它的后端是一个“云浏览器”：浏览器跑在第三方云服务里（Browser Use Cloud），HarnessRouter 通过 Chrome DevTools 协议驱动它，Agent 全程拿不到浏览器的地址和密钥（实现见 browser_plane.py）。

安装步骤：

给实例配置密钥：在容器环境变量里设置BROWSER_USE_API_KEY，没有它，Browser 工具会直接回答“服务未配置”。
在 Plugins 页面打开插件：打开控制台的Plugins页，找到 Browser 一行，点Turn on。浏览器无需你提供任何页面凭证，但可以在Settings里配置域名白名单/黑名单（allow_domains/deny_domains，按域名后缀匹配，留空表示允许任意公开站点）。
把插件挂到 harness 上：打开目标 harness，在其设置里找到Plugins，把 Browser 标记为Included。插件打开 ≠ Agent 就一定会用，这一步才是“装进 Agent”。

装好之后最有意思的是旁观与接管：任务一旦打开浏览器，控制台会在对话旁弹出 Browser 卡片，实时直播浏览器的屏幕；Agent 的动作会化作幽灵光标在画面上滑动。你随时可以点Take over抢过鼠标键盘，Agent 的下一个浏览器调用会暂停等待（不消耗 token），你点Hand back to the agent它继续干活。私有地址、回环地址、内网段永远不可达，每次调用和会话都记在任务的 trace 里，计费按供应商原价透传、不加价。

Connect 一次：GitHub 与 Vercel 装进同一个 Agent

GitHub 和 Vercel 插件属于“需要凭证”的类型，流程是Connect而不是 Turn on：

插件	Agent 得到什么	你要提供什么
GitHub	已连接仓库的文件、分支、提交、Pull Request	一个 access token + 仓库地址（`owner/name`）
Vercel	已连接项目的部署与域名信息	access token、project id、team id

操作路径很简单：Plugins 页面 → 找到对应行 → 点Connect→ 填入凭证。凭证会被写进实例的密钥库（secret store），保存后永远不再明文显示。之后同样是打开 harness、在其设置里把插件标记Included，Agent 在每次任务中就会自动带上这些工具。

💡 一个容易混淆的点：控制台Integrations里的 “Vercel” 指的是 Vercel AI Gateway 这个模型提供方（给 harness 提供模型）；而Plugins里的 Vercel 是项目部署服务。前者是“给 Agent 的大脑”，后者是“给 Agent 的手脚”。

如何 Add MCP：给单个 Agent 加一个专属工具

Plugins 解决的是“大家都能用的共享服务”，而你自己的场景往往需要更细粒度的控制——这时用 MCP。

在 harness 的Harness Settings里，找到Tools区域，点Add MCP，填入 MCP 服务器的名称与端点（HTTP 传输），保存后该服务器就成为这个 harness 的mcpServers条目，Agent 每一轮任务都会连上它（界面逻辑见 HarnessSettings.tsx，弹窗定义在 HarnessEditors.tsx）。

几个实用的配置细节：

按需启用：每个 MCP 服务器都有 enabled 开关，随时可以只保留配置、暂停连接；
请求头转发：harness 设置里有“Request headers”区域，可以把任务请求里的上下文转发给 MCP 服务器——但注意，凭证应存可信的密钥管理器，不要把明文密钥写进这里；
禁用手：disabledTools可以按工具名精确屏蔽插件或 MCP 带来的某些工具，粒度比关掉整个插件更细。

进阶：把整套工具打包成一个“插件包”

如果你希望把“工具 + 技能”做成可复用、可迁移的资产，UHP2026-09-12版定义了Harness Plugins 子协议：一个插件就是一个标准Agent Plugins 包——根目录有plugin.json清单、mcp.json声明 MCP 服务器、skills/下放技能（每个技能一个带SKILL.md的文件夹）。仓库里就有一个最小示例：plugin-probe/SKILL.md 所在的 fixture 包。

这个设计的精妙之处：

格式不是私有标准：插件遵循公开的 Agent Plugins 规范，为其他 Agent 客户端写的插件可以原样装进 UHP harness，反之亦然；
装错不装死：包里某个组件损坏时，其余组件照常加载，失败项连同原因记录在skipped字段里，配置时就能看到；
可以反向导出：GET /v1/harnesses/{harness_id}/plugin能把某个 harness 的直接 MCP 配置和技能打包成一个标准插件包——注意它会主动剥离auth和headers，因为那是凭证，跟着包走出去就是泄露。

完整规则值得通读一遍：protocol/versions/2026-09-12/plugins.md。

关键文件索引

插件目录与连接逻辑：ui/src/app/(app)/plugins/page.tsx/plugins/page.tsx)
Browser 插件的网关实现：gateway/browser_plane.py
自托管指南的 Plugins 章节：docs/self-hosting-guide.md
MCP 服务器的 harness 字段定义：protocol/versions/2026-09-12/harnesses.md
Plugins 子协议规范：protocol/versions/2026-09-12/plugins.md
MCP 添加弹窗：ui/src/components/HarnessEditors.tsx

小结

把 Browser、GitHub、Vercel 装进一个 Agent 的完整链路只有四步：实例配好外部服务密钥 → Plugins 页面 Turn on / Connect → harness 设置里 Included → Add MCP 补上专属工具。共享服务走 Plugins，个性化能力走 MCP，想整体复用就打包成插件包。一次连接，处处生效——这正是 HarnessRouter “统一接口”理念在工具层的落地。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析