Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.
PopNx MCPServidores MCP para quienes usan IA · explicados con palabras sencillas

Kaseya VSA

de wyre-technologyversión 1.1.4i★ 0iSe ejecuta en tu computadora
Nombre en el registroio.github.wyre-technology/kaseya-vsa-mcp

Cómo instalar

Resumen

Descripción del creador (original en inglés)

MCP server for Kaseya VSA RMM — agents, patches, procedures, alarms, tickets.

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

  • Conexión: Se ejecuta en tu computadora
  • Transporte: stdio
  • Categoría: Otros
  • Debes completar: KASEYA_VSA_TENANT_URL, KASEYA_VSA_PASSWORD, KASEYA_VSA_K1_TOKEN

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 2/2 revisiones · Funciona en tu computadora

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de Kaseya VSA (regístrate en el sitio del autor; puede tener costo) · Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

  1. Instala Docker

    Una sola vez; sirve para todos los servidores que necesitan Docker

    Abrir la página de descarga de Docker ↗

  2. Regístrate y crea una clave de Kaseya VSA

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Puede tener costo.

    Abrir el sitio de Kaseya VSA ↗

  3. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  4. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "kaseya-vsa": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "KASEYA_VSA_TENANT_URL",
            "-e",
            "KASEYA_VSA_USERNAME",
            "-e",
            "KASEYA_VSA_PASSWORD",
            "-e",
            "KASEYA_VSA_K1_TOKEN",
            "-e",
            "MCP_TRANSPORT",
            "-e",
            "AUTH_MODE",
            "-e",
            "LOG_LEVEL",
            "ghcr.io/wyre-technology/kaseya-vsa-mcp:v1.1.4"
          ],
          "env": {
            "KASEYA_VSA_TENANT_URL": "your-value",
            "KASEYA_VSA_USERNAME": "your-value",
            "KASEYA_VSA_PASSWORD": "your-value",
            "KASEYA_VSA_K1_TOKEN": "your-value",
            "MCP_TRANSPORT": "your-value",
            "AUTH_MODE": "your-value",
            "LOG_LEVEL": "your-value"
          }
        }
      }
    }

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Cierra Claude y vuelve a abrirlo

  6. Pruébalo

    Usa Kaseya VSA y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Kaseya VSA o muestra una herramienta de Kaseya VSA en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Kaseya VSA

Kaseya VSA se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Kaseya VSA

  • Necesitas una clave de Kaseya VSA (regístrate en el sitio del autor; puede tener costo) · Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Necesitas una clave de Kaseya VSA (regístrate en el sitio del autor; puede tener costo) · Instala Docker en tu computadora primero (una sola vez)
  • Necesitas una clave de Kaseya VSA (regístrate en el sitio del autor; puede tener costo) · Instala Docker en tu computadora primero (una sola vez)
  • Necesitas una clave de Kaseya VSA (regístrate en el sitio del autor; puede tener costo) · Instala Docker en tu computadora primero (una sola vez)

B · Otros en Otros que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de Kaseya VSA (regístrate en el sitio del autor; puede tener costo) · Instala Docker en tu computadora primero (una sola vez)

  1. Instala Docker

    Una sola vez; sirve para todos los servidores que necesitan Docker

    Abrir la página de descarga de Docker ↗

  2. Regístrate y crea una clave de Kaseya VSA

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Puede tener costo.

    Abrir el sitio de Kaseya VSA ↗

  3. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  4. Pega este comando y pulsa Enter

    claude mcp add kaseya-vsa --env KASEYA_VSA_TENANT_URL=your-value --env KASEYA_VSA_USERNAME=your-value --env KASEYA_VSA_PASSWORD=your-value --env KASEYA_VSA_K1_TOKEN=your-value --env MCP_TRANSPORT=your-value --env AUTH_MODE=your-value --env LOG_LEVEL=your-value -- docker run -i --rm -e KASEYA_VSA_TENANT_URL -e KASEYA_VSA_USERNAME -e KASEYA_VSA_PASSWORD -e KASEYA_VSA_K1_TOKEN -e MCP_TRANSPORT -e AUTH_MODE -e LOG_LEVEL ghcr.io/wyre-technology/kaseya-vsa-mcp:v1.1.4

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Escribe /mcp en Claude Code

    Deberías ver Kaseya VSA en la lista como conectado

  6. Pruébalo

    Usa Kaseya VSA y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Kaseya VSA o muestra una herramienta de Kaseya VSA en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de Kaseya VSA (regístrate en el sitio del autor; puede tener costo) · Instala Docker en tu computadora primero (una sola vez)

  1. Instala Docker

    Una sola vez; sirve para todos los servidores que necesitan Docker

    Abrir la página de descarga de Docker ↗

  2. Regístrate y crea una clave de Kaseya VSA

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Puede tener costo.

    Abrir el sitio de Kaseya VSA ↗

  3. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de Kaseya VSA, KASEYA_VSA_TENANT_URL, KASEYA_VSA_USERNAME, KASEYA_VSA_PASSWORD, KASEYA_VSA_K1_TOKEN, MCP_TRANSPORT, AUTH_MODE, LOG_LEVEL está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Abre el chat de IA de Cursor en modo Agent

  6. Pruébalo

    Usa Kaseya VSA y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Kaseya VSA o muestra una herramienta de Kaseya VSA en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de Kaseya VSA (regístrate en el sitio del autor; puede tener costo) · Instala Docker en tu computadora primero (una sola vez)

  1. Instala Docker

    Una sola vez; sirve para todos los servidores que necesitan Docker

    Abrir la página de descarga de Docker ↗

  2. Regístrate y crea una clave de Kaseya VSA

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Puede tener costo.

    Abrir el sitio de Kaseya VSA ↗

  3. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de Kaseya VSA, KASEYA_VSA_TENANT_URL, KASEYA_VSA_USERNAME, KASEYA_VSA_PASSWORD, KASEYA_VSA_K1_TOKEN, MCP_TRANSPORT, AUTH_MODE, LOG_LEVEL está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Abre el chat de IA de VS Code en modo Agent

  6. Pruébalo

    Usa Kaseya VSA y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Kaseya VSA o muestra una herramienta de Kaseya VSA en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Kaseya VSA💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add kaseya-vsa --env KASEYA_VSA_TENANT_URL=your-value --env KASEYA_VSA_USERNAME=your-value --env KASEYA_VSA_PASSWORD=your-value --env KASEYA_VSA_K1_TOKEN=your-value --env MCP_TRANSPORT=your-value --env AUTH_MODE=your-value --env LOG_LEVEL=your-value -- docker run -i --rm -e KASEYA_VSA_TENANT_URL -e KASEYA_VSA_USERNAME -e KASEYA_VSA_PASSWORD -e KASEYA_VSA_K1_TOKEN -e MCP_TRANSPORT -e AUTH_MODE -e LOG_LEVEL ghcr.io/wyre-technology/kaseya-vsa-mcp:v1.1.4

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "kaseya-vsa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KASEYA_VSA_TENANT_URL",
        "-e",
        "KASEYA_VSA_USERNAME",
        "-e",
        "KASEYA_VSA_PASSWORD",
        "-e",
        "KASEYA_VSA_K1_TOKEN",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "AUTH_MODE",
        "-e",
        "LOG_LEVEL",
        "ghcr.io/wyre-technology/kaseya-vsa-mcp:v1.1.4"
      ],
      "env": {
        "KASEYA_VSA_TENANT_URL": "your-value",
        "KASEYA_VSA_USERNAME": "your-value",
        "KASEYA_VSA_PASSWORD": "your-value",
        "KASEYA_VSA_K1_TOKEN": "your-value",
        "MCP_TRANSPORT": "your-value",
        "AUTH_MODE": "your-value",
        "LOG_LEVEL": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "kaseya-vsa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KASEYA_VSA_TENANT_URL",
        "-e",
        "KASEYA_VSA_USERNAME",
        "-e",
        "KASEYA_VSA_PASSWORD",
        "-e",
        "KASEYA_VSA_K1_TOKEN",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "AUTH_MODE",
        "-e",
        "LOG_LEVEL",
        "ghcr.io/wyre-technology/kaseya-vsa-mcp:v1.1.4"
      ],
      "env": {
        "KASEYA_VSA_TENANT_URL": "your-value",
        "KASEYA_VSA_USERNAME": "your-value",
        "KASEYA_VSA_PASSWORD": "your-value",
        "KASEYA_VSA_K1_TOKEN": "your-value",
        "MCP_TRANSPORT": "your-value",
        "AUTH_MODE": "your-value",
        "LOG_LEVEL": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "kaseya-vsa": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KASEYA_VSA_TENANT_URL",
        "-e",
        "KASEYA_VSA_USERNAME",
        "-e",
        "KASEYA_VSA_PASSWORD",
        "-e",
        "KASEYA_VSA_K1_TOKEN",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "AUTH_MODE",
        "-e",
        "LOG_LEVEL",
        "ghcr.io/wyre-technology/kaseya-vsa-mcp:v1.1.4"
      ],
      "env": {
        "KASEYA_VSA_TENANT_URL": "your-value",
        "KASEYA_VSA_USERNAME": "your-value",
        "KASEYA_VSA_PASSWORD": "your-value",
        "KASEYA_VSA_K1_TOKEN": "your-value",
        "MCP_TRANSPORT": "your-value",
        "AUTH_MODE": "your-value",
        "LOG_LEVEL": "your-value"
      }
    }
  }
}

Valores que debes completar

  • KASEYA_VSA_TENANT_URL obligatorio env
    Full base URL including /api/v1.0 (e.g. https://vsa.example.com/api/v1.0)
  • KASEYA_VSA_USERNAME env
    Local-auth username (omit if using Kaseya One token)
  • KASEYA_VSA_PASSWORD secreto env
    Local-auth password (omit if using Kaseya One token)
  • KASEYA_VSA_K1_TOKEN secreto env
    Kaseya One SSO token (alternative to username + password)
  • MCP_TRANSPORT env
    Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.
  • AUTH_MODE env
    Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.
  • LOG_LEVEL env
    Log verbosity: debug, info, warn, error

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Licenciai
Sin licencia indicada
Conexión
Se ejecuta en tu computadora
Última versióni
1.1.4
Categoríai
Otros
Publicado en el registroi
20 ago 2026
Último cambio de códigoi
9 nov 2026
Creador
wyre-technology
Paquetes
oci: ghcr.io/wyre-technology/kaseya-vsa-mcp:v1.1.4
Sitio web
github.com
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 11 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub wyre-technology, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: anteayer

  • … Aún sin revisar

    Tiene licencia

    Todavía no hemos leído este repo en GitHub

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Otrosi

  • Más estrellas que el 0% de los otros 19178 servidores de esta categoría
  • Publicado en el registro más recientemente que el 26% de los otros 19178 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 100% de los otros 19178 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Kaseya VSA?

Superó 2 de 2 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: KASEYA_VSA_TENANT_URL, KASEYA_VSA_PASSWORD, KASEYA_VSA_K1_TOKEN

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez anteayer, y la última versión (1.1.4) llegó al registro hace 3 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, Claude Flow, Tldraw

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 102 tools.

de koala73Muy usado★ 90,5 milActualizado hace 6 días

Se ejecuta en la nube✓ worldmonitor.app

Claude Flow

AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.

de ruvnetMuy usado↓ 13,5 mil/sem★ 81,4 milActualizado hace 14 meses

Se ejecuta en tu computadora

Tldraw

Draw and visually collaborate with your agents on tldraw's canvas.

de tldrawMuy usado★ 51,4 milActualizado hace 8 meses

Se ejecuta en la nube

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Kaseya VSA MCP Server

Model Context Protocol (MCP) server for the Kaseya VSA RMM API. Exposes managed endpoints, software / hardware inventory, patch state, agent procedures, alarms, Service Desk tickets, organizations, and machine groups to AI assistants.

Tools

ToolDescription
kaseya_vsa_list_agentsList managed endpoints (agents). Optional $filter.
kaseya_vsa_get_agentGet an agent's details by ID (renders as an interactive card in MCP Apps hosts).
kaseya_vsa_get_software_inventoryInstalled software for an agent.
kaseya_vsa_get_hardware_inventoryHardware audit for an agent.
kaseya_vsa_get_patch_statusPending and installed patches for an agent.
kaseya_vsa_deploy_patches_nowForce a patch deploy on an agent (destructive — confirmation required).
kaseya_vsa_list_proceduresAgent procedures available to run.
kaseya_vsa_run_procedureExecute a procedure on an agent (destructive — confirmation required).
kaseya_vsa_list_alarmsOpen alarms (optional state filter; date-window elicitation if missing).
kaseya_vsa_list_ticketsService Desk tickets (returns a friendly message if SD module isn't enabled).
kaseya_vsa_list_organizationsTenant organizations.
kaseya_vsa_list_machine_groupsMachine group hierarchy.

When the user omits required filters or runs a destructive action, the server uses MCP elicitation to prompt for choices or confirm.

Interactive device card (MCP Apps)

kaseya_vsa_get_agent renders as a read-only interactive device card in MCP Apps hosts (Claude Desktop/web), showing the endpoint's name, online status, organization, machine group, OS, IP address, and last check-in. The card is neutral by default, brandable via window.__BRAND__ injection or MCP_BRAND_* env vars (MCP_BRAND_NAME, MCP_BRAND_LOGO_URL, MCP_BRAND_PRIMARY_COLOR, MCP_BRAND_ACCENT_COLOR, MCP_BRAND_BG, MCP_BRAND_TEXT) applied at serve time. Plain-JSON behavior is unchanged in other hosts. After editing ui/, regenerate the embedded bundle with npm run build:ui.

Configuration

Copy .env.example and set the variables below.

VariableRequiredDescription
KASEYA_VSA_TENANT_URLFor stdio and AUTH_MODE=envFull base URL incl. /api/v1.0. The Compose gateway service does not load this.
KASEYA_VSA_USERNAMEFor stdio and AUTH_MODE=envLocal-auth username (with password). The Compose gateway service does not load this.
KASEYA_VSA_PASSWORDFor stdio and AUTH_MODE=envLocal-auth password (secret). The Compose gateway service does not load this.
KASEYA_VSA_K1_TOKENFor stdio and AUTH_MODE=envKaseya One SSO token (alternative to username + password). The Compose gateway service does not load this.
MCP_TRANSPORTNostdio (default) or http
AUTH_MODENogateway (Docker image and Compose default) or env (code default when unset). Gateway mode requires the X-Kaseya-VSA-* headers on each /mcp request and never falls back to KASEYA_VSA_*. env uses those variables only after S2S auth succeeds.
CONDUIT_S2S_SECRETYes for HTTPService-to-service secret. Generate with openssl rand -hex 32. The HTTP server logs an error and exits non-zero when this is empty or a known placeholder (changeme, your-s2s-secret, secret, placeholder, an unresolved ${...} value, and similar public examples). Compose will not start without it. Never commit a real value. The value is never logged.
MCP_ALLOW_INSECURE_DEVNoSet to exactly 1 only for local development to start HTTP without CONDUIT_S2S_SECRET. The process logs a warning, does not enforce X-Gateway-S2S, and forces the listener onto 127.0.0.1 even if MCP_HTTP_HOST is a wider address. A known placeholder secret is still refused.
MCP_HTTP_HOSTNoBind address when MCP_TRANSPORT=http. Defaults to 127.0.0.1 when unset. A configured CONDUIT_S2S_SECRET honors this value. The container image sets 0.0.0.0.
MCP_HTTP_PORTNoHTTP port. Defaults to 8080.

Either the username + password pair OR KASEYA_VSA_K1_TOKEN is required for stdio and AUTH_MODE=env.

/health stays unauthenticated and does not read credentials. The stdio transport does not use CONDUIT_S2S_SECRET.

HTTP authentication

With MCP_TRANSPORT=http and CONDUIT_S2S_SECRET set, every /mcp request must include X-Gateway-S2S. The check is verifyS2sHeader in src/s2s-verify.ts: the header value is t= ,v1= , where the hex is HMAC-SHA256 of the literal string t= keyed with CONDUIT_S2S_SECRET (64 lowercase hex characters). The timestamp must be within 300 seconds of the server clock. A missing or invalid header returns HTTP 401 before vendor credentials are read.

In AUTH_MODE=gateway, /mcp also requires X-Kaseya-VSA-Tenant-Url plus either (X-Kaseya-VSA-Username and X-Kaseya-VSA-Password) or X-Kaseya-VSA-K1-Token. Those headers are the only credential source for that request. A request missing them returns 401 and does not fall back to KASEYA_VSA_* in the process environment.

Each accepted request creates a fresh server instance with isolated credentials — no cross-tenant process.env pollution.

Local development

npm install

npm run build KASEYA_VSA_TENANT_URL=https://vsa.example.com/api/v1.0 \ KASEYA_VSA_USERNAME=... \ KASEYA_VSA_PASSWORD=... \ npm start

HTTP refuses to start until CONDUIT_S2S_SECRET is set:

CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" MCP_TRANSPORT=http npm start

curl http://127.0.0.1:8080/health

Local HTTP without a secret is development-only. It binds 127.0.0.1 only and logs a warning. A non-loopback MCP_HTTP_HOST is ignored and the override is logged:

MCP_TRANSPORT=http MCP_ALLOW_INSECURE_DEV=1 npm start

Docker

The image listens on 0.0.0.0 inside the container (MCP_HTTP_HOST) and defaults to AUTH_MODE=gateway. Publish the port on loopback and pass the S2S secret. In gateway mode, Kaseya credentials arrive on each request as headers; they are not read from the environment.

docker build -t kaseya-vsa-mcp .

docker run --rm \ -e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \ -p 127.0.0.1:8080:8080 \ kaseya-vsa-mcp

Compose refuses to start when CONDUIT_S2S_SECRET is unset, sets AUTH_MODE=gateway, does not inject static KASEYA_VSA_* credentials, and publishes 127.0.0.1:8080:8080:

CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" docker compose up

Single-tenant HTTP (AUTH_MODE=env) still requires the S2S secret, then uses KASEYA_VSA_*:

docker run --rm \

-e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \ -e AUTH_MODE=env \ -e KASEYA_VSA_TENANT_URL=https://vsa.example.com/api/v1.0 \ -e KASEYA_VSA_USERNAME=... \ -e KASEYA_VSA_PASSWORD=... \ -p 127.0.0.1:8080:8080 \ kaseya-vsa-mcp

License

Apache-2.0