【2026年】OpenRouter MCPをHermes Agentに設定する完全ガイド！コスト最大24倍削減の最強連携

OpenRouter MCPをHermes Agentに設定すれば、AIエージェントがリアルタイムで最適なモデルを選びながら動作するようになる。設定はたった3行のYAMLを追加するだけだ。

この記事でわかること

OpenRouter MCPとは何か
Hermes AgentにMCPサーバーを追加する方法（config.yaml編集）
設定後の確認方法
実際の使い方と活用例
よくあるトラブルと対処法

OpenRouter MCPとは

OpenRouter MCP（Model Context Protocol）は、OpenRouterが提供するMCPサーバーだ。これをHermes Agentに接続すると、以下のツールが使えるようになる：

list-models — 利用可能なモデル一覧を取得
get-model — 特定モデルの詳細情報を取得
list-daily-model-rankings — 日次モデルランキングを取得
list-benchmarks — ベンチマークデータを取得
send-message — 実際にモデルにメッセージを送信してテスト
get-credits — 残りクレジットを確認
get-generation — 過去の生成結果を取得

これらのツールにより、Hermes Agentがリアルタイムの価格・ベンチマーク・ランキングを参照しながら、タスクに最適なモデルを動的に選択できるようになる。

OpenRouterのX投稿では、このMCPを使ってコストを最大24倍削減できた事例が報告されている。

前提条件

始める前に、以下の準備が必要：

✅ Hermes Agentがインストール済み（まだの人は hermes-agent.nousresearch.com を参照）
✅ OpenRouterのアカウントを持っている
✅ OpenRouterのAPIキーを取得している

APIキーは openrouter.ai/keys から取得できる。

設定手順（3ステップ）

ステップ1：config.yamlを開く

Hermes Agentの設定ファイルは以下の場所にある：

~/.hermes/config.yaml

このファイルをテキストエディタで開く：

nano ~/.hermes/config.yaml

または

code ~/.hermes/config.yaml

ステップ2：MCPサーバー設定を追加

config.yaml の末尾に以下の設定を追加する：

mcp:
  servers:
    openrouter:
      url: https://mcp.openrouter.ai/
      auth:
        bearer: ${OPENROUTER_API_KEY}

ポイント：

${OPENROUTER_API_KEY} は ~/.hermes/.env から自動で読み込まれる
すでに OPENROUTER_API_KEY が設定済みならそのまま使える
まだ設定していない場合は ~/.hermes/.env に以下を追加する：
```
OPENROUTER_API_KEY=sk-or-v1-あなたのAPIキー
```

ステップ3：反映確認

設定を反映させるために、Hermes Agentを起動して以下のコマンドを実行する：

hermes mcp list

以下のように表示されれば成功だ：

MCP Servers:
  - openrouter (connected): https://mcp.openrouter.ai/
    tools: list-models, get-model, list-daily-model-rankings, list-benchmarks, send-message, get-credits, get-generation

もし繋がらない場合は /reload-mcp コマンドも試してみてほしい。

使い方

設定が完了すると、Hermesのチャット内で普通に指示するだけでMCPツールが自動で利用可能になる。

基本的な使い方

「OpenRouter MCPで最適なモデルを調べて」と伝えるだけで、Hermesが自動でツールを呼び出して結果を返してくれる：

あなた：このタスクに最適で一番安いモデルは？

Hermes：OpenRouter MCPで調べてみます...
（list-models + list-benchmarks を自動実行）
→ 「DeepSeek V4 Flashが$0.42/100万トークンで最高のコスパです」

活用例

例1：コーディングに最適な安いモデルを探す

あなた：list-modelsツールを使って、コーディングに強い安いモデルをトップ5教えて

例2：モデルの品質とコストを比較する

あなた：GPT-5.6 SolとClaude Fable 5を、品質とコストで比較して

例3：実際にモデルをテストする

あなた：send-messageでDeepSeek V4 Flashをテストして、実際の応答品質を確認して

例4：予算管理

あなた：今月のクレジット残高を確認して

ツール一覧

OpenRouter MCPで利用できる主なツールは以下の通り：

ツール名	機能	ユースケース
list-models	全モデル一覧を取得	どんなモデルがあるか確認
get-model	特定モデルの詳細を取得	モデルの仕様や料金を確認
list-daily-model-rankings	日次ランキングを取得	今日人気のモデルを知る
list-benchmarks	ベンチマークデータを取得	モデルの性能を比較
send-message	モデルにメッセージを送信	実際にテスト
get-credits	残クレジットを確認	予算管理
get-generation	過去の生成結果を取得	履歴確認

これらのツールには、Hermes内では mcp_openrouter_ というプレフィックスが付く。例えば list-models は mcp_openrouter_list-models として認識される。

認証方式の選び方

OpenRouter MCPの認証には2種類ある：

Bearer認証（推奨）

Hermes Agentのような常時稼働するエージェントにはBearer認証が安定している：

auth:
  bearer: ${OPENROUTER_API_KEY}

通常のOpenRouter APIキーを使う。キーの有効期限を気にする必要がない。

OAuth認証（非推奨）

auth:
  oauth: true

7日間有効の専用キーが発行される。ブラウザ認証が必要になるため、CLIで長時間動かすHermesには不向き。

高度な設定

ツールのフィルタリング

特定のツールだけを有効にしたい場合は、include または exclude を設定する：

mcp:
  servers:
    openrouter:
      url: https://mcp.openrouter.ai/
      auth:
        bearer: ${OPENROUTER_API_KEY}
      tools:
        include:
          - list-models
          - get-model
          - send-message

これにより、Hermesが使えるツールを制限できる。必要なツールだけに絞ることで、余計なAPI呼び出しを防げる。

よくある質問（FAQ）

Q1: 設定したのにMCPが認識されません

hermes mcp list で確認しよう。エラーが出る場合は .env のAPIキーが正しいか確認。必要に応じて /reload-mcp を実行。

Q2: 再起動は必要？

不要。hermes mcp list で即反映される。それでも反映されない場合は /reload-mcp を試す。

Q3: BearerとOAuthの違いは？

Bearerが推奨。OAuthは7日ごとに再認証が必要で、Hermesのような長時間稼働エージェントには不向き。

Q4: コストはどれくらい削減できる？

OpenRouterの事例では最大24倍のコスト削減が報告されている。無料モデルを活用すればさらに削減可能。

Q5: ツールにプレフィックスが付くのはなぜ？

HermesがMCPサーバーを識別するため。mcp_openrouter_list-models のように、サーバー名がプレフィックスとして付く。

Q6: 他のMCPサーバーと併用できる？

もちろん可能。複数のMCPサーバーを同時に設定できる。

参考リンク

この記事は2026年7月13日時点の情報を基にしています。最新情報は各公式ドキュメントでご確認ください。