SnapDeploy MCP

offiziell

Stelle SnapDeploy-Apps (Docker-Container auf AWS) von Claude Code, Cursor, Codex oder Gemini CLI bereit und verwalte sie: Builds, Logs, Umgebungsvariablen, Add-ons, Domains.

GitHub

Was kann man mit SnapDeploy MCP machen?

Von GitHub bereitstellen — Bitten Sie darum, ein verbundenes GitHub-Repository bereitzustellen, und erhalten Sie eine Live-URL über deploy.
Umgebungsvariablen verwalten — Legen Sie Umgebungsvariablen für eine App fest oder aktualisieren Sie sie, ohne geheime Werte offenzulegen, mit with und set_env.
Bereitstellungen überwachen — Prüfen Sie den Bereitstellungsstatus, sehen Sie sich Protokolle an und listen Sie aktuelle Bereitstellungen mit get_status, get_logs und get_deployments auf.
Container steuern — Starten, stoppen oder wecken Sie einen Container bei Bedarf mit start_container, stop_container und wake_container.
Ressourcen bereitstellen — Erstellen Sie eine verwaltete Datenbank oder weisen Sie einer App eine benutzerdefinierte Domain zu mit create_database und add_domain.

Dokumentation

@snapdeploy/mcp

Stellen Sie SnapDeploy-Container direkt aus Ihrem KI-Assistenten bereit und verwalten Sie sie — Claude Code, Claude Desktop, Cursor, Windsurf, Codex CLI, Gemini CLI oder jeder Client, der das Model Context Protocol über stdio spricht.

Sagen Sie „Stelle dieses Repository auf SnapDeploy bereit" und erhalten Sie eine Live-URL zurück. Builds, Logs, Umgebungsvariablen, verwaltete Datenbanken und benutzerdefinierte Domains — ohne den Chat zu verlassen.

Einrichtung

Melden Sie sich bei snapdeploy.dev an, öffnen Sie API-Schlüssel und erstellen Sie einen Token mit dem deploy-Bereich (die Seite generiert die folgenden Snippets mit Ihrem bereits ausgefüllten Token).
Fügen Sie den Server zu Ihrem Client hinzu:

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 und andere JSON-konfigurierte Clients:

{
  "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" }

Claude Code-Plugin (Token wird im sicheren Speicher statt in einer Konfigurationsdatei abgelegt):

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

Starten Sie die Sitzung neu; die snapdeploy-Tools erscheinen. Ihr Repository muss auf GitHub liegen und GitHub muss einmal mit SnapDeploy verbunden sein (der Connector gibt den Link zurück, falls dies nicht der Fall ist).

Tools

Bereich	Tools
`read`	`list_apps` `get_status` `get_logs` `get_deployments` `check_quota` `list_repos` `detect_env_vars`
`deploy`	`deploy` `deploy_image` `set_env` `start_container` `stop_container` `wake_container`
`manage`	`create_database` `add_domain` `assign_always_on`

Bereiche sind verschachtelt (read ⊂ deploy ⊂ manage); der Server erzwingt sie, bevor ein Tool ausgeführt wird. Es gibt kein Lösch-Tool, und der Server verweigert Löschungen, Abo-Kündigungen und Passwortänderungen für jeden Token — dafür muss eine Person im Dashboard oder in der mobilen App angemeldet sein.

Vorgefertigte Images. deploy baut aus einem verbundenen GitHub-Repository; es gibt kein Image-Tool. Um ein öffentliches Docker-Image auszuführen, verwenden Sie das Dashboard (Anwendung bereitstellen → Docker-Image) oder POST /api/mobile/containers mit name, image, imageTag, port, dann POST /api/mobile/containers/{containerId}/start. Images müssen von Docker Hub, ghcr.io, quay.io oder public.ecr.aws stammen, linux/amd64 oder linux/arm64 veröffentlichen und die Richtlinienprüfung beim Erstellen durch SnapDeploy bestehen; ein 400 Security policy violation ist endgültig und darf nicht erneut versucht werden. Vollständige Regeln: https://snapdeploy.dev/llms-full.md

Sicherheitsmodell

Niemals etwas Destruktives. Selbst ein Agent, der mit demselben Token zu einem rohen API-Aufruf eskaliert, erhält 403 INTERACTIVE_SESSION_REQUIRED.
Geheimnisse erreichen niemals das Modell. Werte von Umgebungsvariablen werden als (set) zurückgegeben und Anmeldedaten werden maskiert — auf dem Server, nicht nur in diesem Connector.
Bereichsbezogene, ablaufende, widerrufbare Token mit eigenem Ratengrenzwert. Widerrufen Sie sie auf der API-Schlüssel-Seite und jede Anfrage gibt ab diesem Moment 401 zurück.
Wiederholungssichere Bereitstellungen. Identische Anfragen innerhalb von zehn Minuten geben die ursprüngliche Bereitstellung zurück, anstatt einen weiteren Build zu starten.
Tarifgrenzen werden weitergeleitet, nicht erneut versucht. 402/429-Antworten enthalten SnapDeploys eigene Nachricht und Upgrade-Link, und der Assistent wird angewiesen, es nicht erneut zu versuchen.

Umgebungsvariablen

Variable	Erforderlich	Bedeutung
`SNAPDEPLOY_API_KEY`	ja	Bereichsbezogener Token (`sd_pat_…`) oder Legacy-API-Schlüssel
`SNAPDEPLOY_READ_ONLY`	nein	`1` legt nur die Lese-Tools offen
`SNAPDEPLOY_BASE_URL`	nein	Standard ist `https://snapdeploy.dev`