MCP エージェント

MCP を使うと、Codex、Claude Code、または Antigravity CLI が DR-Terminal のツールを利用できます。エージェントはセッションや保存済みの接続を調べ、接続を開き、端末出力を読み取り、コマンドを入力し、ファイルを転送し、アプリ内を移動できます。MCP モードは、有効な試用期間中および Pro で利用できます。

エージェントに DR-Terminal を追加する

  1. DR-Terminal のタイトルバーで MCP をクリックします。
  2. Add to Codex、Add to Claude、または Add to Antigravity を選択します。これにより、インストール済みの DR-Terminal のブリッジを実行するユーザーレベルの dr-terminal エントリが作成されます。クライアントの設定にトークンやエンドポイントは保存されません。Antigravity 2.0、Antigravity IDE、agy は ~/.gemini/config/mcp_config.json にあるこのエントリを共有します。
  3. 開く を選ぶか、クライアントを普段どおり開きます。最初の接続で DR-Terminal が前面に出て、Allow か 拒否 かを尋ねられます。
  4. 接続を許可したら、最初のプロンプトを貼り付けて送信します。
アクティブな DR-Terminal セッションを表示してください。

選択した CLI はインストール済みで、PATH から利用できる必要があります。インストールは、インストール済みの DR-Terminal パッケージからのみサポートされます。Gradle や IDE からの開発実行は、意図的に永続エントリを作成しません。Remove は、DR-Terminal 自身のものと正確に一致するエントリだけを削除し、確認を求めます。別の既存の dr-terminal エントリは競合として報告され、決して上書きされません。

便利なプロンプト

複数のセッションが開いているときは、セッション名か識別子を指定してください。セッションが存在しないとエージェントが報告した場合は、DR-Terminal で接続を開くか、先に保存済みの接続を一覧表示するようエージェントに頼んでください。

承認とインジケーター

セッションのメタデータや端末出力の読み取りは、通常は作業を中断しません。文字入力、キー操作、ファイル転送、切断などの機密性の高い操作には、あなたの承認が必要です。

承認が必要になると、MCP チップが点滅し、確認ダイアログがキーボードフォーカスを受け取ります。対象のセッションとペイロードを確認したうえで、1 回許可、このセッションでは許可、または 拒否 を選択してください。操作の実行中、対象セッションのタブには静的な MCP マーカーが表示され、チップの色は MCP の全体状態を示します。

エージェントが DR-Terminal に保存されたパスワードや秘密鍵を受け取ることはありません。セッションへの承認は、現在の MCP サーバーの実行が有効な間だけ適用されます。

ローカル接続のセキュリティ

MCP サーバーはループバックインターフェースでのみ待ち受けるため、ネットワークには公開されません。それでもすべてのリクエストには、所有者のみが読めるローカルファイルに保存されたベアラートークンが必要です。タイトルバーのポップオーバーがそのトークンを表示したりコピーしたりすることはありません。

エンドポイントは診断用に エンドポイントと最近の操作 の下にのみ表示されます。トークンファイルを共有したり、その内容をプロンプト、チャットメッセージ、ログ、スクリーンショットにコピーしたりしないでください。

MCP の停止

MCP ポップオーバーで 停止 を選ぶと、保留中の承認を拒否し、ツール呼び出しの受け付けを止め、現在の MCP 実行が起動したクライアントを閉じます。MCP を再度開始すると新しい実行が作られ、以前のセッション承認は引き継がれません。

MCP バッジをクリックしてもポップオーバーが開くだけで、サーバーが暗黙的に起動することはありません。手動で起動するには明示的な Start MCP 操作を使ってください。登録済みのクライアントも、目に見える接続承認フローを通じてサーバーを起動できます。

トラブルシューティング

CLI が見つからない

選択した Codex、Claude Code、または Antigravity CLI（agy）をインストールし、その実行ファイルが PATH から利用できることを確認してください。シェル環境を変更したら DR-Terminal を再起動し、再確認 を選択してください。

ポートがすでに使用中

別のプロセスが、設定された MCP ポートを使用しています。そのプロセスを停止するか、設定 → MCP モード で別のポートを選択して、MCP をもう一度開始してください。

アクティブなセッションがない

まず SSH、Telnet、シリアル、またはローカル端末のセッションを開いてください。保存済みの接続を表示させ、あなたが操作を承認した後にどれかを開くようエージェントに頼むこともできます。

クライアントは動いているが MCP が確認されない

CLI プロセスは起動しましたが、DR-Terminal はまだ MCP ツール呼び出しを受け取っていません。新しい端末タブでログイン、設定、ハンドシェイクのエラーを確認してください。その後、サンプルのプロンプトをもう一度送信してください。実行中 はローカルプロセスの状態を表すもので、確認済みの MCP 接続を意味しません。

承認ダイアログが待機している

DR-Terminal に戻り、フォーカスされているダイアログを確認してください。あなたが許可するか拒否するまで、エージェントはその機密性の高い操作を続行できません。MCP を停止すると、保留中のリクエストは拒否されます。

Previous
Telnet