Saltar al contenido principal

Actualizaciones e integración con Agent

Actualización automática de la aplicación​

  1. Haz clic en el acceso del número de versión en la parte superior de la interfaz principal para abrir el panel de actualización.
  2. Haz clic en Buscar actualizaciones en el panel.
  3. Cuando haya una versión nueva, el panel mostrará la comparación de versiones y un resumen de los cambios.
  4. Tras confirmar, haz clic en Aplicar actualización; el servicio descargará y sustituirá en segundo plano los nuevos recursos del backend y del frontend.
  5. La aplicación se reiniciará automáticamente al terminar; en el modo de bandeja, el proceso se completará con ayuda de la bandeja del sistema.

Configuración de ejecución de scripts​

En Configuración del sistema → Configuración de ejecución de scripts, puedes controlar:

  • Si se transfiere automáticamente XXTLanControl.lua antes de la ejecución
  • Si también se transfiere XXTLanControl.lua al ejecutar <script seleccionado en el dispositivo>
  • Si también se transfiere XXTLanControl.lua al subir scripts por lotes a los dispositivos
  • Actualizar por lotes los XXTLanControl.lua existentes en Directorio de scripts a la versión actual del servidor

Estas opciones afectan principalmente al flujo de ejecución y al mantenimiento de los recursos de scripts.

Panel de instalación de Skills​

En Configuración del sistema → Instalación de Skill, puedes instalar el Skill integrado xxtouch-script en clientes compatibles con Agent Skills. Los destinos de instalación integrados actualmente son:

  • Claude Code
  • Codex
  • Claude Desktop (macOS / Windows, instalación del plugin local)
  • Claude Desktop 3p (macOS / Windows, instalación del plugin local)
  • GitHub Copilot
  • Cursor
  • Windsurf
  • Antigravity
  • Trae
  • Qoder

Claude Desktop y Claude Desktop 3p se instalan con el formato de plugin local de Claude Desktop. El plugin incluye el Skill xxtouch-script y la configuración de conexión MCP de XXTLanControl, y requiere que Node.js / npx estén disponibles localmente. Para cumplir el límite de longitud de nombres de herramientas del canal de plugins de Claude, el identificador interno del plugin es xxtlc, mientras que el nombre mostrado y el nombre del servicio MCP siguen siendo XXTLanControl.

Panel de instalación de MCP​

En Configuración del sistema → Instalación de MCP, puedes escribir o limpiar directamente la configuración de los Agent habituales. Las instalaciones nuevas escriben de forma predeterminada la dirección Streamable HTTP /mcp del backend actual; las configuraciones antiguas xxtlancontrol-mcpserver que apuntan al control central local actual se migran automáticamente a una configuración HTTP, mientras que las configuraciones antiguas que apuntan a otro control central no se modifican. Los destinos de instalación integrados actualmente son:

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

Modos del conjunto de herramientas​

El panel de instalación ofrece dos modos del conjunto de herramientas:

  • Pruebas de desarrollo: adecuado para flujos centrados en la depuración y la integración
  • Completo: adecuado para permitir que el Agent use directamente más capacidades del control central

El botón de instalación y las plantillas de configuración mostradas debajo cambiarán según el modo seleccionado aquí.

Dirección del control central de destino y plantillas​

  • De forma predeterminada, la instalación de MCP apunta a la dirección /mcp de esta instancia de XXTLanControl.
  • Para que un Agent local se conecte a otro control central, introduce su dirección de destino en el panel; se generará automáticamente la dirección correspondiente /mcp?toolProfile=....
  • Los Agent que admiten MCP HTTP remoto ofrecen instalación con un clic; los que no la admiten muestran “La instalación con un clic aún no es compatible” y no vuelven a escribir la configuración antigua xxtlancontrol-mcpserver.
  • Para un Agent que no aparezca en la lista de destinos, copia directamente la plantilla HTTP JSON / TOML que se muestra debajo del panel.
  • Claude Desktop y Claude Desktop 3p se conectan mediante el puente local npx -y mcp-remote@latest a la dirección /mcp actual, por lo que Node.js / npx deben estar disponibles localmente. Después de escribir la configuración, debes reiniciar por completo Claude Desktop para que vuelva a cargar MCP.
  • La configuración de Claude Desktop suele encontrarse en ~/Library/Application Support/Claude/claude_desktop_config.json o %APPDATA%\Claude\claude_desktop_config.json; Claude Desktop 3p usa un directorio independiente: en macOS, ~/Library/Application Support/Claude-3p/claude_desktop_config.json, y en Windows, actualmente %LOCALAPPDATA%\Claude-3p\claude_desktop_config.json.
  • Para investigar la conexión MCP de Claude Desktop, los registros del modo estándar se encuentran en macOS en ~/Library/Logs/Claude y en Windows en %APPDATA%\Claude\logs; los registros de Claude Desktop 3p están en macOS en ~/Library/Logs/Claude-3p y en Windows, actualmente en el directorio de registros bajo %LOCALAPPDATA%\Claude-3p.

Requisitos previos​

  • El backend /mcp no requiere una clave de acceso de forma predeterminada; cualquier Agent que pueda acceder al puerto del control central puede conectarse.
  • Si más adelante ya no necesitas la integración con Agent, se recomienda volver al mismo panel y desinstalarla primero.