aman-sharma-nine/agent-skills

Hermes 远程 MCP 设置

何时使用

当需要在 Hermes 中添加、授权、故障排查或验证远程 OAuth MCP 服务器时使用此技能。

流程

1. 保留请求的服务器标识和端点。 首先使用用户提供的确切 URL。如果该 URL 返回非 MCP 响应，请先查阅供应商的官方文档或端点元数据，然后再尝试替代端点；切勿悄悄替换为猜测的 URL。
2. 使用原生 CLI 添加支持 OAuth 的服务器。 运行：

   hermes mcp add <名称> --url <端点> --auth oauth
   

   当授权或工具发现速度较慢时，可添加 --connect-timeout 120。
3. 通过 PTY 运行交互式设置。 初始的 OAuth 流程可能会打开浏览器并等待授权。保持进程存活，告知用户在浏览器中完成授权，并且切勿在聊天中请求或接受 OAuth 代码。
4. 显式启用工具。 当 Hermes 列出发现的工具时，仅在用户要求通用安装服务器时才选择全部；否则，选择请求的子集。在 PTY 流程中，如果选择提示仍处于打开状态，则可能需要在正常提交后使用原始的 y\r。
5. 在报告成功前进行验证。 运行：

   hermes mcp list
   hermes mcp test <名称>
   hermes config get mcp_servers.<名称>
   

   报告端点、认证方法、连接状态以及已发现/启用的确切工具数量。
6. 说明激活作用域。 原生 MCP 发现是启动/会话作用域的。告知用户在已打开的对话中使用新添加的工具之前，运行 /reload-mcp 或启动新会话。

陷阱

• 除非用户明确需要延迟的、未验证的配置，否则不要在端点探测失败后保存服务器；403 HTML 页面或 SSE 内容类型不匹配是 URL 不可用 MCP 端点的证据。
• 不要仅仅因为 Hermes 写入了配置就声称 OAuth 设置成功；需要通过成功的已认证 hermes mcp test 来确认。
• 将凭据、授权代码、Bearer 令牌和完整的 OAuth URL 排除在内存、技能和聊天之外；它们属于秘密信息或短期会话数据。
• 将供应商的端点重定向视为一个发现问题，而不是静默规范化用户 URL 的理由；在报告中保留原始 URL，并命名已验证的替代端点。