본문으로 건너뛰기

업데이트와 Agent 연결

앱 자체 업데이트​

  1. 메인 화면 위쪽의 버전 번호 진입점을 클릭하여 업데이트 패널을 엽니다.
  2. 패널에서 업데이트 확인을 클릭합니다.
  3. 새 버전이 발견되면 패널에 버전 비교와 업데이트 내용 요약이 표시됩니다.
  4. 업데이트 내용을 확인한 뒤 업데이트 적용를 클릭합니다.
  5. 업데이트가 완료되고 프로그램이 다시 시작될 때까지 기다립니다.

스크립트 실행 설정​

시스템 설정 → 스크립트 실행 설정에서 다음 항목을 제어할 수 있습니다.

  • 실행 전에 XXTLanControl.lua를 자동으로 전송할지 여부
  • <기기에서 선택됨>을 실행할 때도 XXTLanControl.lua를 전송할지 여부
  • 스크립트를 기기에 일괄 업로드할 때도 XXTLanControl.lua를 전송할지 여부
  • 스크립트 디렉터리에 이미 있는 XXTLanControl.lua를 현재 서버 버전으로 일괄 업데이트

Skill 설치 패널​

중앙 제어 작업에는 xxtlancontrol, XXT/XPP 프로젝트 및 XXTouch Lua 스크립트 개발에는 xxtouch-script를 선택하세요. 각 Skill을 개별 설치, 업데이트, 제거하거나 ZIP으로 다운로드할 수 있습니다. Claude Desktop 및 3p는 Customize > Skills > + > Create skill > Upload a skill에서 ZIP을 가져오고 Claude에서 관리합니다.

대상 Agent 행에서 설치, 업데이트 또는 제거를 클릭합니다. 수동으로 설치하려면 ZIP 다운로드를 선택합니다.

Agent는 MCP로 두 Skill과 참조 문서를 읽을 수도 있습니다. 로컬 스크립트와 프로젝트 템플릿에는 전체 Skill 패키지가 필요합니다.

MCP 설치 패널​

시스템 설정 → MCP 설치에서 사용할 Agent의 MCP를 설치하거나 제거합니다. 지원 대상:

  • Claude Code
  • Codex
  • Claude Desktop
  • Claude Desktop 3p
  • VS Code
  • GitHub Copilot
  • Cursor
  • Devin Desktop/CLI
  • Antigravity
  • Trae
  • TRAE CN
  • TRAE SOLO
  • Qoder IDE
  • Qoder Desktop/CLI
  • Qoder CN IDE
  • Qoder CN Desktop/CLI
  • CodeBuddy
  • WorkBuddy
  • WorkBuddy AI

WorkBuddy와 WorkBuddy AI의 설치, 감지 및 제거는 각각 독립적으로 처리됩니다. WorkBuddy AI의 사용자별 MCP 설정 경로는 ~/.workbuddy-ai/mcp.json이며 Windows에서는 %USERPROFILE%\.workbuddy-ai\mcp.json입니다. 기존 WorkBuddy는 계속 ~/.workbuddy/mcp.json을 사용합니다.

필요한 기능 및 Skill 조회​

MCP 도구는 공개 호출 진입점을 제공하며 업무 작업은 tool_call로 호출합니다. 이름과 매개변수를 알면 직접 호출할 수 있습니다.

대상 중앙 제어 주소와 템플릿​

  • 기본적으로 MCP 설치는 현재 XXTLanControl의 /mcp 주소를 가리킵니다.
  • 로컬 Agent를 다른 중앙 제어 서버에 연결하려면 패널에 대상 중앙 제어 주소를 입력할 수 있습니다. 패널이 해당 /mcp 주소를 자동으로 만듭니다.
  • 현재 목록의 설치 대상은 모두 HTTP 연결을 지원합니다.
  • 대상 목록에 없는 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 연결이 더 이상 필요하지 않다면 같은 패널로 돌아가 먼저 제거하는 것이 좋습니다.