SnapDeploy MCP
offiziellStelle 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
- 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). - 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
| Bereich | Tools |
|---|---|
read | list_apps get_status get_logs get_deployments check_quota list_repos detect_env_vars |
deploy | deploy set_env start_container stop_container wake_container |
manage | create_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
| Variable | Erforderlich | Bedeutung |
|---|---|---|
SNAPDEPLOY_API_KEY | ja | Bereichsbezogenes Token (sd_pat_…) oder Legacy-API-Schlüssel |
SNAPDEPLOY_READ_ONLY | nein | 1 legt nur die Lese-Tools offen |
SNAPDEPLOY_BASE_URL | nein | Standardmäßig https://snapdeploy.dev |
Links
- Anleitungen: Claude Code · Cursor · Codex / Gemini CLI · Lovable-Exporte
- Referenz: snapdeploy.dev/docs/mcp · API
- Design-Beschreibung: Warum ein Agent, der bereitstellen kann, nicht löschen dürfen darf
MIT © AAR Labs