aman-sharma-nine/agent-skills

Hermes 遠端 MCP 設定

使用時機

當需要在 Hermes 中新增、授權、疑難排解或驗證遠端 OAuth MCP 伺服器時，使用此技能。

步驟

1. 保留請求的伺服器身分和端點。 首先使用使用者提供的確切 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 Token 和完整的 OAuth URL 排除在記憶體、技能和聊天之外；它們是機密或短暫的工作階段資料。
• 將供應商端點重定向視為發現問題，而非靜默標準化使用者 URL 的理由；在報告中保留原始 URL，並說明已驗證的備用端點。