Hermes リモート MCP セットアップ

Hermes リモート MCP セットアップ は何をしますか？

使用するタイミング

このスキルは、Hermes でリモート OAuth MCP サーバーを追加、認証、トラブルシューティング、または検証するときに使用します。

手順

1. 要求されたサーバー ID とエンドポイントを保持します。 最初にユーザーから提供された正確な URL を使用します。MCP 以外のレスポンスが返ってきた場合のみ、ベンダーの公式ドキュメントまたはエンドポイントのメタデータを参照して代替エンドポイントを試します。推測した URL を黙って置き換えないでください。
2. ネイティブ CLI を使用して OAuth 対応サーバーを追加します。 次を使用します:

   hermes mcp add <name> --url <endpoint> --auth oauth
   

   認証またはツールの検出が遅い場合は、--connect-timeout 120 を追加します。
3. PTY 経由でインタラクティブセットアップを実行します。 最初の OAuth フローではブラウザが開き、認証のために一時停止する場合があります。プロセスを生かしたまま、ユーザーにブラウザで認証を完了するように伝え、チャットで OAuth コードを要求したり受け取ったりしないでください。
4. ツールを明示的に有効にします。 Hermes が検出したツールを一覧表示するとき、ユーザーがサーバーを全般的にインストールするよう要求した場合のみすべてを選択し、それ以外の場合は要求されたサブセットを選択します。PTY フローでは、選択プロンプトが開いたままの場合、通常の送信後に生の y\r が必要になることがあります。
5. 成功を報告する前に確認します。 次を実行します:

   hermes mcp list
   hermes mcp test <name>
   hermes config get mcp_servers.<name>
   

   エンドポイント、認証方法、接続ステータス、および検出/有効化された正確なツール数を報告します。
6. アクティベーションのスコープを記載します。 ネイティブ MCP 検出は起動/セッション範囲です。新しく追加されたツールを既存の会話で使用する前に、/reload-mcp を実行するか新しいセッションを開始するようにユーザーに伝えます。

落とし穴

• エンドポイントプローブが失敗した後にサーバーを保存しないでください。ユーザーが明示的に延期され未確認の構成を希望する場合を除きます。403 HTML ページや SSE Content-Type の不一致は、その URL が使用可能な MCP エンドポイントではないことを示す証拠です。
• Hermes が設定を書き込んだという理由だけで OAuth セットアップが成功したと主張しないでください。認証済みの hermes mcp test が成功する必要があります。
• 認証情報、認証コード、ベアラートークン、および完全な OAuth URL をメモリ、スキル、チャットに保持しないでください。これらは機密情報または短命のセッションデータです。
• ベンダーのエンドポイントリダイレクトは発見の問題として扱い、ユーザーの URL を黙って正規化する理由にはなりません。元の URL をレポートに保持し、検証された代替エンドポイントに名前を付けます。