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.

GitHubPrueba este MCPPatrocinado

¿Qué puedes hacer con SnapDeploy MCP?

  • Desplegar un repositorio de GitHub — Pídele a tu asistente que despliegue un repositorio en SnapDeploy y recibe una URL en vivo mediante la herramienta deploy.
  • Gestionar variables de entorno — Indica a tu asistente que establezca o verifique variables de entorno para un contenedor, con valores enmascarados como (set).
  • Monitorear el estado del despliegue — Solicita estado en tiempo real, registros o historial de despliegues para cualquier contenedor de SnapDeploy.
  • Controlar el ciclo de vida del contenedor — Inicia, detén o activa un contenedor bajo demanda sin salir de tu interfaz de chat.
  • Aprovisionar recursos — Crea bases de datos gestionadas o asigna dominios personalizados a tus despliegues directamente desde la conversación.

Documentación

@snapdeploy/mcp

Despliega 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 Protocolo de Contexto de Modelo a través de stdio.

Di "despliega este repositorio en SnapDeploy" y obtén una URL en vivo. Builds, registros, 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; aparecen 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 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.

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 las variables de entorno se devuelven como (set) y las credenciales están enmascaradas — en el servidor, no solo en este conector.
  • Tokens con alcance, caducidad y revocables con su propio límite de velocidad. 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