リモートアクセス

VPS または別のマシンで実行しているエージェントから、セキュアトンネル経由で SimpliGen に接続します。

View as Markdown Open in ChatGPT Open in Claude

デフォルトでは、エージェントは同じマシン上の SimpliGen に接続します。エージェントを VPS などの別の場所で実行する場合でも、セキュアトンネル経由で SimpliGen に接続でき、アプリケーションに変更を加える必要はありません。

仕組み

SimpliGen のコントロールサービスはセキュリティのため localhost でのみリッスンします。トリックは、リモートマシンの localhost を SimpliGen マシンの localhost にトンネリングすることです。SSH リバーストンネルはそれを正確に行い、SSH がすべての暗号化と認証を処理します。

必要な環境

ホームマシンで実行されている SimpliGen (ペアリングトークンを作成してください: Settings -> Connect an agent -> Manual setup)
コントロール API ポート。Windows では %APPDATA%\simpligen\agent-api.json に記載されています (例: 48199)
ホームマシンからリモートマシンへの SSH アクセス

トンネルを開く

SimpliGen が実行されているホームマシンからリモートマシンへのリバーストンネルを開きます。48199 をポートに置き換え、user@your-vps をサーバーに置き換えてください:

ssh -N -R 48199:localhost:48199 user@your-vps

これにより、リモートマシンの localhost:48199 がホームマシンの localhost:48199 にフォワードされます。エージェントが動作している間、実行したままにしてください。

エージェントを設定する

リモートマシンで、エージェントの MCP サーバーをトークンとポートで設定します:

{
  "mcpServers": {
    "simpligen": {
      "command": "npx",
      "args": ["-y", "@simpligen/mcp"],
      "env": {
        "SIMPLIGEN_TOKEN": "sg-agent-...",
        "SIMPLIGEN_API_PORT": "48199"
      }
    }
  }
}

SIMPLIGEN_API_PORT はコネクタに使用するポートを指示します。リモートマシンには SimpliGen インストール検出がないためです。各リクエストはトンネルを通ってホームマシンの SimpliGen に送信されます。

両方を実行中に保つ

SimpliGen はホームマシンで開いたままにしておき、トンネルを稼働させたままにしておく必要があります。どちらか一方が停止すると、エージェントは再起動するまで接続を失います。

Tailscale またはプライベートネットワークを使用する

Tailscale などのプライベートメッシュネットワークを使用する場合は、同じ SSH リバーストンネルをこの上で実行して、ホームルーターのポートを開く必要なく安定したリンクを得られます。メカニズムは同じです: リモートマシンの localhost は依然としてホームマシンの localhost にフォワードされます。

セキュリティについての注意

トンネルは両端の localhost で終了するため、SimpliGen をパブリックインターネットに公開していません。SSH は接続を暗号化して認証し、ペアリングトークンがエージェントを認可します。Connected agents からいつでもそのトークンを取り消して、アクセスを遮断できます。