Sin cuadros asignados
Tu cuenta todavía no tiene acceso a ningún cuadro. Solicita la asignación a un superadministrador.
Requiere atención
Vista general del puerto
Incidencias relacionadas
Los avisos iniciales simultáneos se agrupan por móvil y permisos. Las recuperaciones y escalados se mantienen individuales.Supervisión del sistema
Salud del sistema
Configuración pendiente de sincronizar
Los cambios guardados aún no están confirmados por el equipo. Revisa conexión, agente y posibles errores.
Incidencias activas del puerto
Notificaciones al móvil
Incidencias activas
Programación
Gestionado desde el panel de administración
Alertas y supervisión
Excepciones de calendario
Fallos repetidos
Funcionamiento diario
Verde: encendido · Azul: apagado · Gris: sin señal reciente · Fondo claro: sin previsión o periodo futuro.
Maniobras e incidencias registradas del día
Encendido escalonado
Encola los encendidos de uno en uno, con intervalo mínimo y sin adelantar pasos tras una interrupción. Espera la confirmación o caducidad de la orden anterior. El supervisor y la comunicación pueden alargar los tiempos; no garantiza un intervalo eléctrico exacto entre contactores.
Histórico
Encendidos, apagados, tensión e incidencias · Hora de CanariasAcceso API REST y MCP
Consultas e informes con tu rol y tus cuadros autorizados.Credenciales asignadas
Avisos al titular a los 7, 3 y 1 días y al caducar, en la aplicación y sus móviles activos según preferencias. La sustitución la realiza el superadministrador; no se renuevan claves automáticamente.
El titular recoge la clave una sola vez desde su sesión. Si un administrador la crea para otra persona, esa persona tiene 24 horas para recogerla.
Consultas, incidencias, históricos e informes. Las credenciales autorizadas pueden proponer maniobras, horarios, grupos, mantenimiento y cambios en incidencias; cada cambio requiere tu aprobación personal en esta pantalla antes de ejecutarse.
API REST: Documentación y ejemplos · OpenAPI 3.1. Las credenciales de esta pantalla sirven para ambos accesos.
Crear credencial y asignar titular
Qué puede hacer
- Los mismos cuadros que puedes ver en esta aplicación.
- Lecturas con su fecha y estado de conexión.
- Incidencias, seguimiento y atención; las modificaciones requieren aprobación.
- Operadores: maniobras, secuencias manuales y gestión de incidencias; técnicos y superadministradores: también horarios, grupos automáticos y mantenimiento. Las escrituras requieren credencial autorizada y confirmación web.
- Históricos paginados e informes de hasta un año.
Los cambios de permisos se aplican a cada petición. Cambiar tu contraseña o rol invalida las credenciales existentes. Puedes revocarlas aquí; cerrar sesión en la web no cierra las conexiones MCP.
Compatible con clientes configurados con token Bearer. La conexión OAuth automática de otros clientes aún no está implementada. Hay un puente stdio incluido en el proyecto.Propuestas de cambios pendientes de tu confirmación
Revisa cuadro, acción, duración o los valores anteriores y nuevos. Aprobar no ejecuta: autoriza al cliente a hacerlo una sola vez antes de cinco minutos. Si cambian el cuadro, los permisos o el horario, prepara otra propuesta.
Conectar Claude, ChatGPT o Work
Guía revisada el 17/10/2026. La conexión usa una credencial personal de esta pantalla. Empieza con consultas; para las modificaciones habilita cambios según tu rol y aprueba cada propuesta personalmente en la web.
Preparación común
- Crea una credencial distinta para cada cliente. Guarda el token en un archivo privado de tu ordenador, sin comillas ni texto adicional; en macOS/Linux dale permisos 600. No lo pegues en conversaciones ni en las plantillas compartidas.
- Descarga el puente stdio_bridge.py y guarda su ruta absoluta. Requiere Python 3 sin paquetes adicionales. Localiza el ejecutable con
command -v python3. - Reemplaza las rutas de ejemplo por las de tu ordenador. Mientras la app esté en localhost, el cliente debe ejecutarse en este mismo Mac. En producción usa la URL HTTPS del dominio real y configura los hosts permitidos.
La contraseña del panel y el token del dispositivo Shelly no sirven como credencial MCP.
Claude Desktop · conexión local con el puente
- Abre la configuración local de servidores MCP de Claude Desktop y edita
claude_desktop_config.json, conservando las conexiones que ya existan. - Añade la entrada del ejemplo y sustituye las tres rutas. El archivo privado de credencial debe contener el token del paso anterior.
- Guarda, cierra completamente y vuelve a abrir Claude Desktop. Comprueba que aparece «alumbrado-puerto» y prueba: «Consulta los cuadros y las incidencias activas, sin realizar cambios».
Configuración MCP oficial de Anthropic · Servidores locales en Claude Desktop
ChatGPT / Work de escritorio y Codex local
- Si tu versión ofrece Settings → MCP servers, añade «Alumbrado del puerto» como STDIO: ejecutable Python 3, argumento ruta absoluta al puente y las variables del ejemplo.
- Guarda y pulsa Restart para recargarlo. Comprueba las herramientas disponibles con
/mcpy solicita una consulta sin cambios.
Alternativa para Codex CLI: usa el comando siguiente, reemplazando rutas. No contiene el token.
También admite Streamable HTTP con autenticación Bearer cuando el cliente permita configurar la cabecera o variable del token.
ChatGPT web y Work en la nube · preparación pendiente
Los chats alojados usan plugins y conexiones remotas; no leen el archivo MCP local. Se necesita acceso de red al servidor y una integración compatible con la cuenta y las políticas del espacio de trabajo. Nuestro servidor exige Bearer; todavía no incluye OAuth ni un plugin del puerto empaquetado. Pegar la URL por sí solo no completa esa integración.
- Desplegar primero en HTTPS con el dominio real.
- Elegir la integración o plugin permitido en la cuenta y validar su autenticación. Si exige OAuth, implementarlo antes.
- Instalar y autorizar la integración, y comprobar consultas y permisos antes de habilitar cambios.
Comprobar conexión y resolver errores
401: token caducado, revocado o invalidado por cambio de permisos. 403: rol, cuadro, host u origen no autorizado. En localhost el servidor debe estar arrancado. Revisa las rutas de Python, del puente y del archivo privado; el puente rechaza archivos con permisos demasiado abiertos. Si no aparecen maniobras, comprueba el rol y el permiso de cambios de la credencial. Consulta confirmation_mode: web requiere aprobar con el mismo usuario en la web; ai permite confirmar solo la maniobra manual desde la conversación.
Qué cubren la API REST y el MCP frente al panel
No ofrecen todavía todas las funciones del panel. Esta tabla distingue las funciones disponibles de las que solo existen en la API interna de la web, con sesión y CSRF.
Por defecto se aprueba en la web; las credenciales habilitadas pueden confirmar mandos manuales desde la IA. Cada escritura exige una credencial autorizada y tu aprobación personal; esta tabla no concede permisos por sí sola.Avisos al móvil
Configura las notificaciones de tu usuario y este dispositivo.Este dispositivo
El navegador pedirá permiso al pulsar Activar. Los avisos pueden llegar con la aplicación cerrada. Al cerrar sesión se desactiva el dispositivo para este usuario.
Mis dispositivos
Qué avisos quiero recibir
Estado de los envíos
«Aceptado» significa aceptado por el servicio push; no confirma que se haya mostrado o leído en el móvil.Configuración del puerto
Instala equipos, organiza horarios y administra accesos.Credenciales API / MCP
Cada credencial tiene un usuario titular. Solo el superadministrador puede crearla; sus permisos dependen del titular.
Móviles y navegadores registrados
El registro en el propio dispositivo se vincula a la cuenta autenticada. Aquí puedes revisar, renombrar, reasignar o desactivar sus avisos.
Usuarios y permisos
Los cambios de rol y la desactivación revocan las sesiones anteriores.El rol define las acciones; la asignación limita los cuadros. Consulta la comparación entre web, API y MCP.
Equipos Shelly y conexión
Alta, edición y retirada de cuadros desde la aplicaciónNo hay equipos activos. Añade uno para empezar.
Comunicación saliente por HTTPS desde cada cuadro, sin abrir puertos en la red del puerto.
Edición avanzada y credencial del equipo
Comunicación con el servidor
Credencial del equipo
Cada cuadro utiliza un token individual. Al renovarlo, el anterior deja de funcionar.El agente actualizado v5 puede instalar el horario local y los temporizadores. La app indicará si el equipo ha confirmado su configuración.
Confirmación física · contacto auxiliar
Confirmación física del contactor
Solo recibe una señal real si hay un contacto auxiliar instalado y validado. No se deduce del estado del relé ni del consumo de su bobina.
Un profesional debe instalar y verificar el contacto y el modo de la entrada. La aplicación no modifica la configuración de las entradas ni el botón manual. Esta señal confirma el contactor, no cada luminaria.Guía manual de instalación y diagnóstico
Cómo configurar este dispositivo
Pro 1PM · Agente v5 · Conexión saliente al servidor del puerto- Conecta el equipo a la red del puerto
Usa Ethernet o configura su Wi-Fi. Debe tener salida a internet y DNS. Desde un ordenador conectado a esa misma red, abre en el navegador la IP local del equipo e inicia sesión con su contraseña de administración.
- Prepara la dirección de la aplicación y la credencial
Indica la URL HTTPS de esta aplicación o, solo para pruebas en la misma red, activa el modo local e indica la IP privada del Mac con su puerto. El servidor del Mac debe escuchar en esa red. Genera el token de este cuadro con el botón de arriba. Ese token es diferente de la contraseña de acceso al equipo.
Solo para pruebas: el token viaja sin cifrar por la red local. Usa una credencial de prueba y renuévala al pasar a HTTPS. Los avisos push al móvil requieren HTTPS. - Comprueba firmware, reloj y mando local
Instala el firmware estable disponible desde la interfaz del equipo. Revisa que la fecha y hora estén sincronizadas y usa la zona Atlantic/Canary. Comprueba que el pulsador del cuadro funciona con el tipo de entrada correspondiente; el agente no cambia esta configuración. Para la primera prueba deja la confirmación física en «Sin señal adicional» si no hay contacto auxiliar instalado.
- Crea el script de comunicación
Si ya existe una versión anterior, detén ese script y edítalo; evita dejar dos agentes ejecutándose. En una instalación nueva entra en Scripts → Create / Add script, escribe «Alumbrado del puerto» y pega el código generado aquí. No hace falta configurar Shelly Cloud ni abrir puertos de entrada en el router.
- Guarda y activa el arranque automático
Pulsa Save, activa Run on startup y pulsa Run / Play. El script debe quedar en estado «Running». Con HTTPS, conserva ssl_ca: null: valida el certificado con las autoridades integradas del equipo. No uses "*", que desactiva la validación. El modo HTTP de prueba local no ofrece cifrado y debe retirarse al terminar.
- Comprueba la comunicación
El equipo envía su estado y voltaje aproximadamente cada 15 segundos. Pulsa el botón siguiente y comprueba que aparece «Conectado». Después valida una maniobra autorizada desde el dashboard y comprueba el estado del contactor en el cuadro.
Sin comprobar
Si el equipo no conecta
- Confirma que la URL es la de la aplicación, no la IP del propio Shelly ni
127.0.0.1. En prueba local, comprueba que ambos equipos comparten red, que el Mac está despierto y que el firewall permite el puerto elegido; no abras puertos del router. - Revisa internet, DNS, fecha/hora y el certificado del servidor.
- Comprueba que el script está ejecutándose y que el token corresponde al cuadro seleccionado. Si renovaste el token, actualízalo en el script.
- Un error 401 indica una credencial no válida; un error 404 suele indicar una URL o ruta incorrecta.
- Revisa la consola de Scripts del equipo para ver errores. No compartas capturas que contengan el token.
Avisos escalados a responsables
Avisos escalados a responsables
Si la incidencia sigue activa y nadie la ha marcado como atendida, se envía un segundo aviso a los responsables elegidos. Solo reciben los dispositivos registrados, según sus permisos y preferencias.
Consultar equipos retirados
Equipos retirados
Se conservan sus históricos. Restaurar exige una nueva credencial y revisar los permisos.Encendido escalonado por horario
Cada cuadro conserva su programación base y su apagado. El primero enciende a la hora base; los siguientes, después del intervalo configurado. Los miembros deben compartir encendido, días, modo local/servidor y configuración solar de atardecer. Los horarios locales aplican el desfase incluso sin internet una vez confirmada la revisión.
Intervalos en minutos completos (60–300 s), hasta 20 cuadros y un desfase total máximo de 30 minutos. Los equipos con horario en el servidor dependen de la frecuencia del supervisor. No se espera la confirmación del cuadro anterior: se programan horas diferentes.
