SnapDeploy MCP

oficial

Implementa y gestiona aplicaciones SnapDeploy (contenedores Docker en AWS) desde Claude Code, Cursor, Codex o Gemini CLI: builds, logs, variables de entorno, add-ons, dominios.

GitHub

¿Qué puedes hacer con SnapDeploy MCP?

  • Desplegar desde GitHub — Solicita desplegar un repositorio de GitHub conectado y obtén una URL en vivo de vuelta mediante deploy.
  • Gestionar variables de entorno — Establece o actualiza variables de entorno para una aplicación sin exponer valores secretos, usando with y set_env.
  • Monitorear despliegues — Verifica el estado del despliegue, consulta registros y lista despliegues recientes con get_status, get_logs y get_deployments.
  • Controlar contenedores — Inicia, detén o activa un contenedor bajo demanda usando start_container, stop_container y wake_container.
  • Aprovisionar recursos — Crea una base de datos gestionada o adjunta un dominio personalizado a una aplicación con create_database y add_domain.

Documentación

@snapdeploy/mcp

Implementa y gestiona contenedores de SnapDeploy desde tu asistente de IA: Claude Code, Claude Desktop, Cursor, Windsurf, Codex CLI, Gemini CLI, o cualquier cliente que hable el Model Context Protocol a través de stdio.

Di "despliega este repositorio en SnapDeploy" y obtén una URL en vivo. Builds, logs, variables de entorno, bases de datos gestionadas y dominios personalizados — sin salir del chat.

Configuración

  1. Inicia sesión en snapdeploy.dev, abre API Keys y crea un token con el alcance deploy (la página genera los fragmentos a continuación con tu token ya completado).
  2. Añade el servidor a tu cliente:

Claude Code

claude mcp add --scope user snapdeploy -e SNAPDEPLOY_API_KEY=sd_pat_your_token -- npx -y @snapdeploy/mcp

Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Gemini CLI (~/.gemini/settings.json), Claude Desktop y otros clientes configurados con JSON:

{
  "mcpServers": {
    "snapdeploy": {
      "command": "npx",
      "args": ["-y", "@snapdeploy/mcp"],
      "env": { "SNAPDEPLOY_API_KEY": "sd_pat_your_token" }
    }
  }
}

Codex CLI (~/.codex/config.toml):

[mcp_servers.snapdeploy]
command = "npx"
args = ["-y", "@snapdeploy/mcp"]
env = { SNAPDEPLOY_API_KEY = "sd_pat_your_token" }

Plugin de Claude Code (token almacenado en almacenamiento seguro en lugar de un archivo de configuración):

/plugin marketplace add AAR-Labs/snapdeploy-mcp
/plugin install snapdeploy@snapdeploy

Reinicia la sesión; aparecerán las herramientas snapdeploy. Tu repositorio debe estar en GitHub y GitHub debe estar conectado a SnapDeploy una vez (el conector devuelve el enlace si no lo está).

Herramientas

AlcanceHerramientas
readlist_apps get_status get_logs get_deployments check_quota list_repos detect_env_vars
deploydeploy deploy_image set_env start_container stop_container wake_container
managecreate_database add_domain assign_always_on

Los alcances se anidan (read ⊂ deploy ⊂ manage); el servidor los aplica antes de que se ejecute cualquier herramienta. No existe una herramienta de eliminación, y el servidor rechaza eliminaciones, cancelaciones de suscripción y cambios de contraseña para cada token — esas acciones requieren una persona con sesión iniciada en el panel o en la aplicación móvil.

Imágenes precompiladas. deploy compila desde un repositorio de GitHub conectado; no hay herramienta de imágenes. Para ejecutar una imagen pública de Docker, usa el panel (Deploy Your Application → Docker Image) o POST /api/mobile/containers con name, image, imageTag, port, y luego POST /api/mobile/containers/{containerId}/start. Las imágenes deben provenir de Docker Hub, ghcr.io, quay.io o public.ecr.aws, publicar linux/amd64 o linux/arm64, y pasar la verificación de política de creación de SnapDeploy; un 400 Security policy violation es definitivo y no debe reintentarse. Reglas completas: https://snapdeploy.dev/llms-full.md

Modelo de seguridad

  • Nada destructivo, nunca. Incluso un agente que escale a una llamada API directa con el mismo token recibe 403 INTERACTIVE_SESSION_REQUIRED.
  • Los secretos nunca llegan al modelo. Los valores de variables de entorno se devuelven como (set) y las credenciales se enmascaran — en el servidor, no solo en este conector.
  • Tokens con alcance, caducidad y revocables con su propio límite de tasa. Revoca en la página de API Keys y cada solicitud devuelve 401 desde ese momento.
  • Despliegues seguros ante reintentos. Solicitudes idénticas dentro de diez minutos devuelven el despliegue original en lugar de iniciar otro build.
  • Los límites del plan se transmiten, no se reintentan. Las respuestas 402/429 llevan el mensaje propio de SnapDeploy y el enlace de actualización, y se indica al asistente que no reintente.

Variables de entorno

VariableRequeridaSignificado
SNAPDEPLOY_API_KEYsíToken con alcance (sd_pat_…) o clave API heredada
SNAPDEPLOY_READ_ONLYno1 expone solo las herramientas de lectura
SNAPDEPLOY_BASE_URLnoPor defecto es https://snapdeploy.dev

Enlaces

MIT © AAR Labs