Solución de problemas
Los sospechosos habituales y cómo resolverlos.
Ordenadores
- Aparece Desconectado: el ordenador debe estar encendido y con internet, con la app funcionando. En el ordenador ejecuta
opsgate-device status(o el comando de instalación otra vez: mantiene la vinculación y reinicia la app). - "Not allowed on this computer": sube el nivel de permiso en la página del ordenador del panel.
- "Outside the allowed folders": añade la carpeta en la página del ordenador.
- "Protected location": las claves, credenciales de la nube y contraseñas del navegador nunca se comparten, a propósito.
- No se abrió el navegador durante la instalación: copia la dirección que muestra la terminal (
https://mcp.opsgates.com/link?code=…). - Redes de empresa: la app necesita HTTPS de salida hacia
https://mcp.opsgates.com.
Servidores
Empieza con la comprobación integrada del servidor:
sudo opsgate doctor
sudo opsgate status
sudo opsgate logs
El instalador dice que no reconoce la clave
La clave se revocó o está mal escrita. Añade el servidor otra vez en el panel y usa el comando nuevo. Las claves empiezan por og_.
"Cannot reach OpsGates Cloud"
El servidor necesita HTTPS de salida hacia https://mcp.opsgates.com. Compruébalo con:
curl -sI https://mcp.opsgates.com/healthz
La dirección HTTPS no responde
- Dominio propio: su registro A de DNS debe apuntar a la IP pública del servidor (
dig +short mcp.ejemplo.com). - Puertos: 80 y 443 deben ser accesibles desde internet (también en el cortafuegos o grupo de seguridad de tu proveedor).
- Certificado pendiente: Let's Encrypt puede tardar un minuto o dos. Vuelve a ejecutar
sudo opsgate doctor. - EasyPanel: si la ruta no aparece, reinicia Traefik desde EasyPanel (Settings → Traefik → Restart).
Claude dice que no puede conectar o que falló la autenticación
- Usa la URL que termina en
/mcp. - En la página de acceso de un servidor, usa la contraseña de acceso del servidor (del instalador o de
sudo opsgate password), no la de tu cuenta de OpsGates. - Después de
sudo opsgate password, quita y vuelve a añadir el conector, o pulsa Conectar otra vez.
"Monthly tool-call limit reached"
Añade llamadas extra o mejora el plan en Plan y facturación, o espera al día 1 del mes (UTC).
"License key was rejected"
El servidor se quitó en el panel. Crea una clave nueva y ejecuta sudo opsgate license og_….
"No write permission" / "Service not allowed"
Es a propósito: permítelo con sudo opsgate allow-write /ruta o sudo opsgate allow-restart nombre.
"OpsGates could not reach its license server for more than 72 hours"
Recupera el HTTPS de salida del servidor; las llamadas vuelven solas en menos de un minuto.
¿Sigues atascado?
Escribe a support@opsgates.com con la salida de sudo opsgate doctor (no contiene secretos).