メインコンテンツへ移動

アップデートと Agent 接続

アプリケーションの自動アップデート​

  1. メイン画面上部のバージョン番号をクリックし、アップデートパネルを開きます。
  2. パネルで アップデートを確認 をクリックします。
  3. 新しいバージョンが見つかると、バージョンの比較と変更内容の概要が表示されます。
  4. 内容を確認して アップデートを適用 をクリックすると、サービスがバックグラウンドで新しいバックエンドとフロントエンドのリソースをダウンロードして置き換えます。
  5. アップデート完了後、プログラムが自動的に再起動します。トレイモードでは、トレイアプリが処理を支援します。

スクリプト実行設定​

システム設定 → スクリプト実行設定 では、次の内容を制御できます。

  • 実行前に XXTLanControl.lua を自動転送するか
  • <デバイス側で選択済み> を実行するときも XXTLanControl.lua を転送するか
  • スクリプトをデバイスへ一括アップロードするときも XXTLanControl.lua を転送するか
  • スクリプトディレクトリ にある既存の XXTLanControl.lua を、現在のサーバーバージョンへ一括更新する

これらの設定は主に、スクリプトの実行フローとスクリプト資産の保守に影響します。

Skill インストールパネル​

システム設定 → Skill インストール では、組み込みの xxtouch-script Skill を Agent Skills 対応クライアントへインストールできます。現在、次のインストール先が組み込まれています。

  • Claude Code
  • Codex
  • Claude Desktop（macOS / Windows、ローカルプラグインとしてインストール）
  • Claude Desktop 3p（macOS / Windows、ローカルプラグインとしてインストール）
  • GitHub Copilot
  • Cursor
  • Windsurf
  • Antigravity
  • Trae
  • Qoder

Claude Desktop と Claude Desktop 3p には、Claude Desktop のローカルプラグイン形式でインストールされます。プラグインには xxtouch-script Skill と XXTLanControl MCP 接続設定の両方が含まれ、ローカルで利用可能な Node.js / npx に依存します。Claude のプラグインチャンネルにあるツール名の長さ制限へ対応するため、プラグイン内部の識別子には xxtlc を使用しますが、画面上の表示名は引き続き XXTLanControl、MCP サービス名も引き続き XXTLanControl です。

MCP インストールパネル​

システム設定 → MCP インストール では、一般的な Agent の設定を直接書き込むか、削除できます。新規インストールでは、既定で現在のバックエンドの /mcp Streamable HTTP アドレスを書き込みます。このコンピューター上の現在の集中管理サーバーを指す古い xxtlancontrol-mcpserver 設定は HTTP 設定へ自動移行されますが、別の集中管理サーバーを指す古い設定は変更されません。現在、次のインストール先が組み込まれています。

  • Claude Code
  • Codex
  • Claude Desktop
  • Claude Desktop 3p
  • VS Code
  • GitHub Copilot
  • Cursor
  • Windsurf
  • Antigravity
  • Trae
  • TRAE CN
  • TRAE SOLO
  • Qoder

ツールセットモード​

インストールパネルには 2 種類のツールセットモードがあります。

  • 開発テスト：デバッグや結合テストを中心とする用途に適しています
  • 完全：Agent から集中管理サーバーのより多くの機能を直接使用する用途に適しています

インストールボタンと、その下に表示される設定テンプレートは、ここで現在選択しているツールセットモードに応じて変わります。

接続先の集中管理アドレスとテンプレート​

  • 既定では、MCP のインストール先は現在の XXTLanControl の /mcp アドレスです。
  • ローカルの Agent から別の集中管理サーバーへ接続する場合は、パネルに接続先の集中管理アドレスを入力します。対応する /mcp?toolProfile=... が自動生成されます。
  • 現在、リモート HTTP MCP に対応する Agent にのみワンクリックインストールが提供されます。未対応の Agent には「ワンクリックインストールは現在サポートされていません」と表示され、古い xxtlancontrol-mcpserver 設定へのフォールバック書き込みは行いません。
  • インストール先一覧にない Agent では、パネル下部にある JSON / TOML HTTP テンプレートを直接コピーできます。
  • Claude Desktop と Claude Desktop 3p は、ローカルの npx -y mcp-remote@latest を介して現在の /mcp アドレスへ接続するため、ローカルで Node.js / npx を利用できる必要があります。設定を書き込んだ後は、MCP を再読み込みするため Claude Desktop を完全に再起動してください。
  • Claude Desktop の設定は通常、~/Library/Application Support/Claude/claude_desktop_config.json または %APPDATA%\Claude\claude_desktop_config.json にあります。Claude Desktop 3p は独立したディレクトリを使用し、macOS では ~/Library/Application Support/Claude-3p/claude_desktop_config.json、Windows では現在 %LOCALAPPDATA%\Claude-3p\claude_desktop_config.json が優先されます。
  • Claude Desktop の MCP 接続を調査する場合、標準モードのログは macOS では ~/Library/Logs/Claude、Windows では %APPDATA%\Claude\logs にあります。Claude Desktop 3p のログは macOS では ~/Library/Logs/Claude-3p、Windows では現在 %LOCALAPPDATA%\Claude-3p 以下のログディレクトリが優先されます。

利用要件​

  • バックエンドの /mcp は既定ではアクセスキーを必要としません。集中管理サーバーのポートへアクセスできる Agent であれば接続できます。
  • Agent 接続が不要になった場合は、同じパネルへ戻って先にアンインストールすることを推奨します。