
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/harnessrouterHarnessRouterHarnessRouter Community Edition是一个自托管的 Agent 统一接口层把 Codex、Claude Code、Hermes 等 Agent 运行时harness变成一个 API 背后的可插拔后端。这篇教程讲透它最容易被忽略的一层能力如何通过Plugins插件与MCP 服务器把 Browser、GitHub、Vercel 这三类外部服务能力装进同一个 Agent让它既能打开网页、又能读写你的代码仓库、还能查看 Vercel 项目的部署。先搞清楚Plugins 和 MCP 是两层不同的东西很多新手会把这两个概念混为一谈但在 HarnessRouter 里它们处在两个层次层次是什么连接一次还是每次典型例子Pluginsplugs工作区workspace级别的服务连一次所有 harness 共享连一次Browser、GitHub、Vercel、InsForgeMCP 服务器harness 级别的工具挂在某个具体 harness 上每个 harness 配置你自己接入的任意 MCP 端点一句话理解Plugins 是“水电煤”MCP 是“自定义插座”。Plugins 由实例统一管理、统一记账、统一安全护栏MCP 服务器则是你在单个 harness 的 Tools 配置里按需添加的外部能力。两者的产物最终都会合并成 Agent 每一轮任务真正生效的工具集合详见协议定义 harnesses.md 中mcpServers与plugins字段的说明。一键装进 BrowserAgent 从此会看网页Browser 插件让 Agent 拥有一个真实浏览器打开页面、读取正文、点击、输入、滚动、等待、截图、前进后退、切换标签页——共 13 个工具但刻意不提供JavaScript 执行和下载能力这是刻意的安全设计。它的后端是一个“云浏览器”浏览器跑在第三方云服务里Browser Use CloudHarnessRouter 通过 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 装进同一个 AgentGitHub 和 Vercel 插件属于“需要凭证”的类型流程是Connect而不是 Turn on插件Agent 得到什么你要提供什么GitHub已连接仓库的文件、分支、提交、Pull Request一个 access token 仓库地址owner/nameVercel已连接项目的部署与域名信息access token、project id、team id操作路径很简单Plugins 页面 → 找到对应行 → 点Connect→ 填入凭证。凭证会被写进实例的密钥库secret store保存后永远不再明文显示。之后同样是打开 harness、在其设置里把插件标记IncludedAgent 在每次任务中就会自动带上这些工具。 一个容易混淆的点控制台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.mdMCP 服务器的 harness 字段定义protocol/versions/2026-09-12/harnesses.mdPlugins 子协议规范protocol/versions/2026-09-12/plugins.mdMCP 添加弹窗ui/src/components/HarnessEditors.tsx小结把 Browser、GitHub、Vercel 装进一个 Agent 的完整链路只有四步实例配好外部服务密钥 → Plugins 页面 Turn on / Connect → harness 设置里 Included → Add MCP 补上专属工具。共享服务走 Plugins个性化能力走 MCP想整体复用就打包成插件包。一次连接处处生效——这正是 HarnessRouter “统一接口”理念在工具层的落地。【免费下载链接】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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考