Guía de Instalación

1. Requisitos del sistema

1.1. PC Servidor (obligatorio)

1.2. Tablet (recomendada)

2. Descarga del programa

2.1. Descargar la versión de prueba

El procedimiento habitual para empezar a usar VisitControl es descargar la versión de prueba gratuita desde la web de TrazIA:

1. Accede a trazia.net desde el navegador de tu PC.
2. Ve a la sección Productos y selecciona VisitControl.
3. Pulsa el botón de descarga.
4. Se descargará el fichero Setup_VisitControl_v2.0.2.exe.

2.2. Descargas para clientes con licencia

Si ya has comprado la licencia y necesitas descargar nuevamente el instalador (por ejemplo, para reinstalar o actualizar), puedes hacerlo desde el área de clientes en trazia.net/client, donde también encontrarás la documentación actualizada.

2.3. Idiomas disponibles

VisitControl está disponible en tres idiomas: catalán, castellano e inglés. Cada versión se descarga por separado desde trazia.net.

3. Instalación paso a paso

3.1. Ejecutar el instalador

1. Localiza el fichero descargado en tu carpeta de Descargas: Setup_VisitControl_v2.0.2.exe.
2. Haz doble clic para ejecutarlo. Windows puede mostrar una pantalla azul de protección ("Windows protegió su equipo"). Pulsa "Más información" y luego "Ejecutar de todas formas".
3. A continuación puede aparecer un aviso de Control de Cuentas de Usuario (UAC). Pulsa "Sí" para permitir la instalación.
4. Se abrirá el asistente de instalación.
5. Acepta la ruta de instalación propuesta (C:\Program Files\TrazIA) o elige otra.
6. Pulsa "Instalar" y espera a que se copien los archivos (unos segundos).
7. Al finalizar, marca "Iniciar VisitControl ahora" y pulsa "Finalizar".

3.2. Qué se instala

3.3. Carpetas de datos (creadas automáticamente)

Al ejecutar VisitControl por primera vez, el programa crea automáticamente las siguientes carpetas fuera del directorio de instalación:

4. Primer inicio y configuración

4.1. Iniciar VisitControl

1. Ejecuta VisitControl desde el acceso directo del escritorio o del Menú Inicio.
2. El programa se inicia en segundo plano. Para confirmar que está en ejecución, mira junto al reloj de Windows (bandeja del sistema): deberás ver el icono de VisitControl. Si no lo ves, pulsa la flecha ▲ de la bandeja para mostrar los iconos ocultos.
3. Automáticamente se abrirá el navegador con la página de login.
4. Introduce las credenciales por defecto: usuario admin y contraseña admin123.

4.2. Configuración inicial recomendada

Una vez dentro, ve a Configuración y completa al menos estos campos:

1. Datos de empresa: nombre y logo de tu empresa.
2. Contraseña: cambiar "admin123" por una contraseña segura.
3. RGPD: responsable del tratamiento, emails de contacto, finalidad y periodo de conservación.
4. Motivos de visita: adaptar la lista a los motivos reales de tu empresa.
5. Instrucciones del visitante: subir o redactar el documento con las normas de seguridad, higiene y EPIs obligatorios para los visitantes de tu empresa.

5. Activación de la licencia

5.1. Licencia de prueba (Trial)

5.2. Activar la licencia (durante el periodo de prueba)

1. Abre VisitControl y ve a Configuración.
2. Selecciona la pestaña Licencia.
3. Pega el token de licencia (64 caracteres) que recibiste por email.
4. Pulsa "Activar licencia".
5. El sistema verificará la licencia con el servidor de trazia.net (necesita internet en este momento).
6. Si la activación es correcta, verás un mensaje de confirmación. La licencia queda vinculada a tu equipo.

5.3. Activar la licencia (tras expirar el periodo de prueba)

Cuando el periodo de prueba expira, VisitControl ya no permite acceder al panel de control. En su lugar, se muestra directamente la pantalla "Período de Prueba Finalizado". Desde esta pantalla puedes:

• Activar la licencia: pega tu código de licencia en el campo de activación y pulsa "Activar". El programa se desbloqueará automáticamente.
• Aplicar código promocional: si tienes un código de colaborador, puedes introducirlo para extender el periodo de prueba a 30 días.
• Comprar la licencia: pulsa "Comprar Licencia" para ir a trazia.net. Una vez comprada, recibirás el código por email.

5.4. Verificación periódica

VisitControl realiza verificaciones periódicas de la licencia cuando hay conexión a internet disponible. Si el PC no tiene internet, el programa sigue funcionando con normalidad; la verificación se realizará cuando se restablezca la conexión.

6. Conectar la tablet

6.1. Requisitos de red

• WiFi: la tablet y el PC deben estar conectados a la misma red WiFi.
• Router: el router debe permitir comunicación entre dispositivos (sin aislamiento de clientes activado).
• Firewall: el puerto del PC debe estar accesible (ver sección 7.2).

6.2. Conexión mediante código QR (método recomendado)

1. En el PC, abre el Dashboard de VisitControl (http://localhost:5004).
2. Localiza el código QR que aparece en el Dashboard.
3. Desde la tablet, abre la cámara o un lector de QR.
4. Escanea el código QR. Se abrirá automáticamente el formulario de registro en el navegador.
5. Guarda esta página como acceso directo en el escritorio de la tablet (ver sección 6.5).

6.3. Obtener los enlaces de conexión

VisitControl incluye un botón "Compartir" en el panel de control que muestra directamente los enlaces de acceso para la tablet y para otros PCs. Es la forma más fácil de obtener la URL correcta sin tener que buscar la IP manualmente.

6.4. Conexión manual (alternativa)

Si prefieres configurar la conexión manualmente:

1. En el PC, averigua la IP local (aparece en el Dashboard, en el botón "Compartir", o ejecuta ipconfig en CMD).
2. En la tablet, abre Chrome y escribe: http://[IP-del-PC]:5004/tablet
   (ejemplo: http://192.168.1.50:5004/tablet).
3. Debería aparecer el formulario de registro de visitantes.

6.5. Crear acceso directo en la tablet

Una vez conectada la tablet, guarda la página como acceso directo para no tener que escanear el QR cada día:

• Android (Chrome): Menú (⋮) > "Añadir a pantalla de inicio". Se creará un icono en el escritorio.
• iPad (Safari): Botón compartir > "Añadir a la pantalla de inicio".

7. Solución de problemas

7.1. La tablet no conecta con el PC

7.2. Configurar el Firewall de Windows

Si la tablet no puede conectar con el PC, es probable que el Firewall de Windows esté bloqueando el puerto. Para solucionarlo:

1. Abre "Firewall de Windows con seguridad avanzada" (busca "firewall" en el menú Inicio).
2. En el panel izquierdo, haz clic en "Reglas de entrada".
3. En el panel derecho, haz clic en "Nueva regla...".
4. Selecciona "Puerto" y pulsa Siguiente.
5. Selecciona "TCP" y escribe "5004" en "Puertos locales específicos". Siguiente.
6. Selecciona "Permitir la conexión". Siguiente.
7. Marca las tres opciones (Dominio, Privado, Público). Siguiente.
8. Ponle nombre: "VisitControl - Puerto 5004". Finalizar.

7.3. Otros problemas comunes

8. Actualizaciones

8.1. Cómo actualizar

1. Cierra VisitControl desde la bandeja del sistema.
2. Descarga la nueva versión desde trazia.net (sección Productos o área de clientes).
3. Ejecuta el nuevo instalador. Se instalará encima de la versión anterior.
4. Inicia VisitControl. Todos los datos, la configuración y los logos se conservan.

8.2. Desinstalar

Si necesitas desinstalar VisitControl, ve a Panel de Control > Programas > Desinstalar > VisitControl. Los datos y backups en C:\BackupVisit se conservan por seguridad y pueden eliminarse manualmente si ya no se necesitan.

9. Resumen rápido de instalación

Checklist para tener VisitControl operativo en menos de 15 minutos:

10. Claude Desktop — Integración con IA

VisitControl incluye un servidor MCP (Model Context Protocol) que arranca automáticamente al iniciar el programa. Este servidor permite que Claude Desktop (el asistente de IA de Anthropic) consulte el registro de visitantes en lenguaje natural, sin necesidad de configuración técnica adicional por parte del usuario.

10.1. Conectar Claude Desktop en el mismo PC (usuario local)

1. Asegúrate de que VisitControl está en ejecución (icono en la bandeja del sistema).
2. Abre el panel de administración: http://localhost:5004
3. Ve a Configuración > Licencia.
4. Pulsa el botón "Conectar con Claude Desktop".
5. VisitControl escribe automáticamente la configuración MCP en Claude Desktop.
6. Cierra y vuelve a abrir Claude Desktop.
7. Claude Desktop ya puede consultar el registro de visitantes de VisitControl.

10.2. Conectar Claude Desktop en otro PC de la red (usuario remoto)

1. En el PC servidor, ve a Configuración > Licencia y pulsa "Descargar instalador para usuario remoto".
2. Se descargará el fichero instalar_trazia_mcp.bat.
3. Envía ese fichero al usuario remoto (correo, carpeta compartida, Teams, etc.).
4. El usuario remoto hace doble clic en el fichero .bat. El script se encarga de todo automáticamente: instala el conector necesario y configura Claude Desktop.
5. El usuario remoto cierra y vuelve a abrir Claude Desktop.
6. Listo: desde ese PC ya se pueden hacer consultas sobre VisitControl a Claude.

10.3. Verificar que Claude Desktop está conectado

Después de reiniciar Claude Desktop, puedes verificar la conexión preguntando directamente:

• "¿Quién está dentro de la empresa ahora mismo?"
• "¿Cuántas visitas ha habido hoy en VisitControl?"

Si la conexión es correcta, Claude responderá con datos reales del registro. Si indica que no puede acceder a VisitControl, comprueba que el programa está en ejecución y repite el paso de conexión.

10.4. Firewall y puertos MCP

Para usuarios remotos en la misma red, el puerto MCP (5104) debe ser accesible desde el equipo remoto. Si la conexión falla, crea una regla de entrada en el Firewall de Windows similar a la del puerto 5004 (ver sección 7.2), pero especificando el puerto 5104.

10.5. Antivirus corporativo y firewall de empresa

En entornos con antivirus corporativo (Sophos, Symantec, McAfee, Bitdefender, Windows Defender gestionado por directiva de empresa, etc.) o con un firewall de empresa administrado por el departamento de IT, puede ser necesario añadir excepciones manuales para que la conexión MCP funcione.

Síntoma típico: el instalador .bat se ejecuta sin errores y muestra protocolVersion en pantalla (el servidor responde correctamente), pero Claude Desktop no muestra VisitControl en Configuración › Desarrollador, o aparece un error de conexión al intentar usarlo.

Según el entorno:

• Antivirus en el PC del usuario remoto: añade una excepción para el proceso python.exe o para la conexión TCP saliente al puerto 5104 del PC servidor.
• Firewall de empresa (entre PCs): el departamento de IT debe crear una regla que permita tráfico TCP al puerto 5104 desde los PCs de los usuarios al PC servidor de VisitControl.

11. Importador de Datos

VisitControl incluye una herramienta integrada para combinar y fusionar ficheros Excel sin necesidad de software externo. Accede desde Configuración → 📊 Importador.

11.1. Para qué sirve

• Fusionar exportaciones de diferentes períodos en un solo fichero.
• Migrar registros de visitantes o configuración desde otro sistema.
• Combinar datos de varias fuentes resolviendo duplicados de forma controlada.

11.2. Cómo usarlo

1. Ve a Configuración → 📊 Importador (se abre en una pestaña nueva).
2. Paso 1 — Cargar ficheros: carga el fichero maestro (base de datos principal) y el fichero fuente (datos a incorporar).
3. Paso 2 — Configurar: selecciona la columna clave para detectar duplicados y el modo de resolución de conflictos.
4. Paso 3 — Mapear columnas: asigna qué columna del fichero fuente corresponde a cada columna del fichero maestro. El sistema propone el mapeo automáticamente por similitud de nombres.
5. Paso 4 — Previsualizar y descargar: revisa el resumen (filas idénticas, nuevas, conflictivas) y descarga el Excel resultante.

11.3. Modos de resolución de conflictos