> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes の MCP 設定

> ネイティブのリモート MCP の設定、ブラウザでの認証、ツールの検証、トラブルシューティング

このページでは、Hermes でのネイティブ MCP を扱います。リモートのサービスは Streamable HTTP とブラウザの OAuth を使い、EvoLink CLI は必要ありません。コマンドやスキルを実行する場合は、別の [CLI ガイド](https://evolink.ai/docs/ja/cli/hermes-agent.md)を使ってください。

## リモート MCP を接続する

ネイティブツールを使う場合は、**Streamable HTTP + OAuth** と、次のサーバー URL を使います：

```text theme={null}
https://mcp.evolink.ai/mcp
```

CLI のインストールは必要ありません。既存の設定をバックアップし、EvoLink の部分だけをマージして、ほかのサービスはそのまま残してください。コマンドによる登録か、手動での登録のどちらかを選びます。

**1. サーバーの設定をマージする**

OAuth に対応したバージョンの Hermes で、`~/.hermes/config.yaml` をバックアップしてから編集します。トップレベルのキーを重複させずに、既存の `mcp_servers` マッピングにマージしてください。インデントにはスペースを使います：

```yaml theme={null}
mcp_servers:
  evolink:
    url: "https://mcp.evolink.ai/mcp"
    auth: oauth
    connect_timeout: 300
```

**2. 新しいターミナルから認証する**

```bash theme={null}
hermes mcp login evolink
```

コマンドを実行したまま、ブラウザで EvoLink にログインして承認します。新しいターミナルから明示的にログインすると、実行中のセッションの設定を編集したあとの自動再読み込みに適用される、より短い制限時間を避けられます。

**3. ツールを再読み込みし、無料で検証する**

Hermes の会話で、次を入力します：

```text theme={null}
/reload-mcp
```

または、新しいセッションを開いて、下記のプロンプトを送信します。EvoLink のツールが有効になっていることを確認してください。ツールが一覧に表示されるだけでは、呼び出しが認証されていることにはなりません。

SSH でのコールバックについては、EvoLink CLI のフラグではなく、Hermes 自身の設定に従ってください。[Hermes のドキュメント](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp/)を参照してください。

認証が済んだら、エージェントのチャットで次を送信します：

```text theme={null}
EvoLink でアカウントの残高を確認し、利用可能な画像モデルを検索してください。まだ生成しないでください。
```

**成功の目安**：`check_balance` と `search_models` の実際の呼び出しが結果を返すこと。これらのツールは、実際の MCP 接続で検証してください。

## アップデート、切断、トラブルシューティング

ホスト型の MCP サーバーは、EvoLink が更新します。設定を変更したら、実際に使っているクライアントのセッションを再読み込みしてください。必要に応じて、そのクライアントの OAuth 操作から再認証します。切断するには、ホストの MCP 設定で EvoLink を無効にするか、ログアウトするか、削除してください。ほかのサーバーはそのまま残します。

| 症状 | 対処 |
| - | - |
| URL を追加したのにツールがない | 接続を有効にし、認証を完了して、再読み込みし、組織のポリシーを確認します |
| 401、または認証を求められる | この MCP 接続を再認証し、元のタスク ID を保持します |
| 403、またはツールが拒否される | ホストの権限、アカウントやキーの状態、ネットワークのエラーを確認します |
| タイムアウト、またはレスポンスを受け取れない | 生成し直すのではなく、元の操作を照会して復旧します |
| リンクだけが表示される、またはプレビューがグレーになる | 自動的に作り直さずに、オリジナルファイルを開いて渡します |

[MCP の料金、アクセス、トラブルシューティング](https://evolink.ai/docs/ja/mcp/billing.md#faq)を参照してください。送信の前に、[制作のワークフロー](https://evolink.ai/docs/ja/mcp/overview.md#workflows)を読んでください。呼び出しの形は、[MCP ツールリファレンス](https://evolink.ai/docs/ja/mcp/tools.md)にあります。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.