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.

Was kann man mit SnapDeploy MCP machen?

  • Deploy a GitHub repository — Bitten Sie Ihren Assistenten, ein Repository auf SnapDeploy bereitzustellen, und erhalten Sie eine Live-URL über das deploy-Tool.
  • Manage environment variables — Weisen Sie Ihren Assistenten an, Umgebungsvariablen für einen Container festzulegen oder zu überprüfen, wobei Werte als (set) maskiert werden.
  • Monitor deployment status — Fordern Sie Echtzeit-Status, Logs oder den Bereitstellungsverlauf für jeden SnapDeploy-Container an.
  • Control container lifecycle — Starten, stoppen oder wecken Sie einen Container bei Bedarf, ohne Ihre Chat-Oberfläche zu verlassen.
  • Provision resources — Erstellen Sie verwaltete Datenbanken oder weisen Sie Ihren Bereitstellungen direkt aus dem Gespräch benutzerdefinierte Domains zu.

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 Repo 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

  1. Melden Sie sich bei snapdeploy.dev an, öffnen Sie API-Schlüssel und erstellen Sie ein Token mit dem deploy-Bereich (die Seite generiert die folgenden Snippets mit Ihrem bereits ausgefüllten Token).
  2. 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 sein und GitHub muss einmal mit SnapDeploy verbunden sein (der Connector gibt den Link zurück, falls dies nicht der Fall ist).

Tools

BereichTools
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

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

Sicherheitsmodell

  • Nichts Destruktives, niemals. Selbst ein Agent, der mit demselben Token auf einen rohen API-Aufruf eskaliert, erhält 403 INTERACTIVE_SESSION_REQUIRED.
  • Geheimnisse erreichen das Modell nie. Werte von Umgebungsvariablen werden als (set) zurückgegeben und Anmeldeinformationen 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 von diesem Moment an 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 wiederholt. 402/429-Antworten enthalten SnapDeploys eigene Nachricht und Upgrade-Link, und der Assistent wird angewiesen, nicht zu wiederholen.

Umgebungsvariablen

VariableErforderlichBedeutung
SNAPDEPLOY_API_KEYjaBereichsbezogenes Token (sd_pat_…) oder Legacy-API-Schlüssel
SNAPDEPLOY_READ_ONLYnein1 legt nur die Lese-Tools offen
SNAPDEPLOY_BASE_URLneinStandardmäßig https://snapdeploy.dev

Links

MIT © AAR Labs