Servidor MCP de Datto RMM

Servidor MCP para Datto RMM, que permite a Claude interactuar con tu cuenta de Datto RMM.

Implementación con un clic

[!IMPORTANT] Antes de hacer clic: este servidor depende de @wyre-technology/node-datto-rmm, que está alojado en el registro npm de GitHub Packages. GitHub Packages no permite acceso anónimo — aunque el paquete sea público, cada npm install necesita un token. El compilador en la nube ejecuta npm install por ti, así que debes proporcionarle uno, o la compilación fallará con npm error 401 Unauthorized ... npm.pkg.github.com.

1. Crea un Personal Access Token de GitHub con el ámbito read:packages (token clásico). Cualquier cuenta de GitHub sirve — no necesitas ser miembro de la organización wyre-technology para leer sus paquetes públicos.

2. Añádelo como variable de compilación cuando el flujo de implementación te lo pida:

   • Cloudflare Workers → establece una variable de compilación llamada NODE_AUTH_TOKEN con tu PAT (Workers → Settings → Build → Variables and Secrets).

   • DigitalOcean App Platform → establece una variable de entorno cifrada llamada GITHUB_TOKEN con ámbito Build Time con tu PAT (el .do/deploy.template.yaml ya la declara).

[!NOTE] El objetivo de DigitalOcean compila la imagen Docker completa y ejecuta el MCP completo sobre HTTP — esta es la ruta recomendada para operadores. Este repositorio no tiene punto de entrada para Cloudflare Workers (src/worker.ts), por lo que el botón de Workers no es un objetivo compatible todavía; prefiere DigitalOcean o la imagen de contenedor precompilada (ghcr.io/wyre-technology/datto-rmm-mcp).

Related MCP server: HaloPSA API Gateway MCP Server

Características

• Gestión de dispositivos: Listar, buscar y obtener detalles de dispositivos

• Gestión de alertas: Ver y resolver alertas

• Tarjeta de alerta interactiva (MCP Apps): datto_get_alert se renderiza como una tarjeta interactiva en los hosts de MCP Apps (Claude Desktop/web) con un flujo de ida y vuelta de "Resolver alerta" dentro de la tarjeta; neutral por defecto, personalizable mediante la inyección de window.__BRAND__ o las variables de entorno MCP_BRAND_*; el comportamiento JSON plano no cambia en otros hosts

• Gestión de sitios: Listar y obtener detalles de sitios

• Trabajos rápidos: Ejecutar trabajos rápidos en dispositivos

• Datos de auditoría: Recuperar la auditoría completa del dispositivo o el inventario de software

Instalación

Mediante MCP Gateway (Recomendado)

Este servidor está diseñado para funcionar con el MCP Gateway, que gestiona la autenticación y la gestión de credenciales.

Desarrollo local

Las dependencias @wyre-technology/* de este servidor están en el registro npm de GitHub Packages, que requiere un token incluso para paquetes públicos. Autentícate una vez y luego instala:

# Authenticate npm to GitHub Packages (token needs the read:packages scope)
export NODE_AUTH_TOKEN=$(gh auth token)   # or a PAT with read:packages

npm install
npm run build
npm start

El .npmrc del repositorio ya apunta el ámbito @wyre-technology a GitHub Packages y lee el token de NODE_AUTH_TOKEN, por lo que no se necesita configuración adicional.

Configuración

El servidor acepta credenciales mediante variables de entorno:

Cuando se usa con el MCP Gateway, las credenciales se inyectan mediante las variables de entorno X_API_KEY y X_API_SECRET.

Selección de plataforma

Datto RMM utiliza endpoints de API regionales. Selecciona la plataforma que coincida con tu cuenta:

Herramientas disponibles

Docker

Usar la imagen precompilada (sin compilar, sin token)

docker pull ghcr.io/wyre-technology/datto-rmm-mcp:latest

docker run -p 8080:8080 \
  -e DATTO_API_KEY=xxx \
  -e DATTO_API_SECRET=xxx \
  -e DATTO_PLATFORM=concord \
  ghcr.io/wyre-technology/datto-rmm-mcp:latest

La imagen es pública y se descarga de forma anónima, por lo que esta ruta no necesita ningún token de GitHub.

Compilar desde el código fuente

La compilación instala @wyre-technology/node-datto-rmm desde GitHub Packages, lo cual requiere un token aunque el paquete sea público (consulta Implementación con un clic). El Dockerfile lo toma como argumento de compilación GITHUB_TOKEN — omítelo y la compilación fallará en npm ci con npm error 401 Unauthorized ... npm.pkg.github.com:

docker build --build-arg GITHUB_TOKEN=$(gh auth token) -t datto-rmm-mcp .

docker run -p 8080:8080 \
  -e DATTO_API_KEY=xxx \
  -e DATTO_API_SECRET=xxx \
  -e DATTO_PLATFORM=concord \
  datto-rmm-mcp

El token se escribe en un .npmrc temporal que se elimina en la misma capa, por lo que nunca queda grabado en la imagen.

[!NOTE] La imagen usa por defecto MCP_TRANSPORT=http en el puerto 8080, por lo que -p 8080:8080 es necesario para acceder a ella. Comprobación de estado: curl http://localhost:8080/health.

Licencia

Apache-2.0