Watchgoose MCP

Watchgoose MCP conecta clientes de IA compatibles con MCP con la API de gestión de Watchgoose. Permite inspeccionar la monitorización de cron y tareas recurrentes, con los cambios en los checks disponibles solo cuando se habilitan explícitamente las escrituras.

Requisitos

• Node.js 20 o posterior

• Una clave de API de Watchgoose con ámbito de proyecto, desde Configuración del proyecto

Usa una clave hcr_ de solo lectura cuando solo necesites el estado de los checks y el historial de estados. Usa una clave hcw_ de lectura y escritura cuando también necesites pings, integraciones o cambios en los checks.

Related MCP server: uptrack-mcp

Claude Desktop

Añade esta entrada a claude_desktop_config.json y reinicia Claude Desktop:

{
  "mcpServers": {
    "watchgoose": {
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

Claude Code

claude mcp add --env WATCHGOOSE_API_KEY=hcr_your_project_key \
  --transport stdio --scope user watchgoose -- npx -y watchgoose-mcp

Ejecuta claude mcp get watchgoose para comprobar la conexión.

Cursor

Crea .cursor/mcp.json en tu proyecto, o añade la misma entrada a tu configuración de MCP de usuario:

{
  "mcpServers": {
    "watchgoose": {
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

VS Code

Crea .vscode/mcp.json:

{
  "servers": {
    "watchgoose": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

Ejecuta MCP: List Servers e inicia watchgoose.

Entorno

El servidor clasifica los prefijos de las claves localmente y nunca consulta la API para inferir el acceso. Establecer WATCHGOOSE_ENABLE_WRITES=true no puede otorgar acceso adicional a una clave de solo lectura.

Herramientas

Los checks se identifican mediante valores unique_key estables de 40 caracteres. Los UUID, las URL de ping y los UUID de integración se usan solo dentro del servidor y no se muestran al cliente de IA.

Las asignaciones de integraciones usan nombres de integración exactos. Los nombres deben ser no vacíos y únicos dentro del proyecto.

Los resultados de las listas están limitados a 100 checks, 100 pings, 200 flips y 100 integraciones. Cada resultado de herramienta serializado también está limitado a 24.000 caracteres. Los resultados incluyen metadatos cuando se omiten entradas.

Seguridad

• Las escrituras están deshabilitadas por defecto, incluso con una clave hcw_.

• La clave de API se envía solo en la cabecera X-Api-Key y nunca se registra ni se devuelve.

• Se rechazan las redirecciones de la API para que las credenciales no puedan reenviarse a otro host.

• Los UUID de checks, las URL de ping y de actualización, los UUID de integración y los campos futuros desconocidos de la API se eliminan de la salida.

• Los pings conservan solo type, date, n, scheme, method y duration. Las direcciones IP de origen, los agentes de usuario, los IDs de ejecución y las URL de los cuerpos se eliminan.

• Los cuerpos de los pings nunca se solicitan.

• El servidor no tiene telemetría.

Protege los archivos de configuración del cliente que contienen claves de API. Prefiere un proyecto dedicado y la clave con menos privilegios que exponga las herramientas que necesitas. Revoca una clave desde la configuración del proyecto de Watchgoose cuando ya no esté en uso.

Desarrollo

npm install
npm run format:check
npm run lint
npm run typecheck
npm test
npm run publish:dry-run

Las pruebas de integración de producción son opcionales y requieren claves dedicadas de proyectos de prueba. Nunca se ejecutan en CI.

Licencia

MIT