HermesエージェントがMCPサービスに接続すると、サービスが開始直後に終了した場合、コマンドパス、ワーキングディレクトリ、環境変数、stderrログを優先します。MCPの設定は軽微なJSON/YAMLの問題のように見えますが、実際の問題はしばしば「Hermesの実行環境でコマンドが見つからない」ことです。
ターミナルで最初の繁殖
MCPの設定内のコマンドとARGSを同じユーザーと同じシェルにコピーして実行してください。ターミナルが動かなければ、Hermesも突然動作しません。よくある状況としては、NodeやPythonがPATHに含まれていない、仮想環境がアクティブでない、パッケージがインストールされていない、スクリプトパスが相対パスを使う場合などがあります。
4つの主要なチェックポイント
- コマンドは絶対パスで一度だけ使います。例えば、
/usr/bin/nodeやVENVのPythonなどです。 - CWDで正解です:多くのMCPサーバーはプロジェクトのルートから起動する必要があります。
- env complete: API キー、設定パス、プロキシ変数はインタラクティブシェルにだけ存在するわけではありません。
- stderr付きのログ:本当の理由は通常、サービス終了前に印刷されます。
すべてのMCPを一緒に開かないでください
トラブルシューティング中は1台のMCPサーバーのみを有効にし、起動が安定し、ツールをリストアップし、最小限のリクエストを行ってから次のサーバーに接続してください。複数のMCPが同時に故障すると、ログが混ざり合い、誰が終了しているか判別しにくくなります。
MCPがCursorやClaudeコードで動作してもHermesでは動作できない場合、それはおそらく起動環境が異なるためでしょう。Hermes MCPの設定にパス、cwd、envを明示的に書き込むことは、シェルの暗黙の状態に依存するよりも安定しています。
