본문으로 건너뛰기

업데이트와 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

도구 세트 모드​

설치 패널은 두 가지 도구 세트 모드를 제공합니다.

  • 개발 테스트: 디버깅과 연동 테스트 중심의 사용 방식에 적합합니다.
  • 전체: 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를 사용할 수 있어야 합니다. 설정을 작성한 뒤에는 Claude Desktop을 완전히 다시 시작해야 MCP가 다시 로드됩니다.
  • 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 연결이 더 이상 필요하지 않다면 같은 패널로 돌아가 먼저 제거하는 것이 좋습니다.