Zum Hauptinhalt springen
Mit dem MCP-Server von Square Cloud arbeitet ein KI-Client über das Model Context Protocol in deinem Konto. Formuliere deine Bitte in einfachen Worten, und der Client ruft die Tools für dich auf: Status, Logs, Metriken und Edge-Traffic prüfen, Dateien lesen und bearbeiten, Umgebungsvariablen verwalten, Anwendungen starten und neu starten, Anwendungen, Datenbanken und Snapshots erstellen und mehr.
  • Remote, nichts zu installieren: Eine HTTPS-Adresse für jeden Client.
  • Zwei Wege zur Verbindung: Claude und ChatGPT melden sich per OAuth auf einer Zustimmungsseite von Square Cloud an. Claude Code, VS Code, Cursor und andere Clients senden einen API-Schlüssel.
  • Deine Berechtigungen entscheiden: Eine Verbindung sieht nur die Tools, die ihre Scopes abdecken, und ein auf bestimmte Anwendungen und Datenbanken beschränkter Schlüssel erreicht nur diese.
  • Dein Client fragt, deine Daten bleiben sicher: Die Berechtigungsabfrage deines Clients entscheidet, welche Änderungen laufen, und das Löschen einer Anwendung oder Datenbank sowie das Wiederherstellen eines Snapshots erstellen vorher einen Sicherheits-Snapshot.

Endpoint

Das ist die einzige Adresse des MCP-Servers. Auf api.squarecloud.app oder jeder anderen Square Cloud-Adresse antworten MCP-Anfragen mit 421 WRONG_HOST und der richtigen Adresse. Umgekehrt liefert mcp.squarecloud.app nur den MCP-Server aus, nie die REST-API.

Voraussetzungen

  • Ein aktiver Plan. Der MCP-Server ist in jedem Plan von Square Cloud enthalten, ab Hobby. Ohne aktiven Plan antwortet jede Anfrage mit 403 UPGRADE_REQUIRED. Läuft dein Plan ab, bleiben deine Verbindungen erhalten und funktionieren wieder, sobald der Plan verlängert ist.
  • Ein MCP-Client mit Unterstützung für Remote-Server über Streamable HTTP, etwa Claude, ChatGPT, Claude Code, VS Code oder Cursor. Siehe Einen Client verbinden.

Protokoll

Was außerhalb des MCP-Servers bleibt

  • Einen Ordner von deinem Computer deployen. Der MCP-Server arbeitet mit dem, was bereits auf Square Cloud liegt. Lade ein Projekt mit der CLI, der VS Code-Erweiterung oder über GitHub-Deploys hoch.
  • Downloads von Snapshots und Datenbankzertifikaten. Der signierte Download-Link würde in der Unterhaltung und beim Anbieter des KI-Modells landen. Lade sie im Dashboard herunter.
  • Kontoaktivität. Sie zeigt die IP-Adressen und Geräte deines Kontos und bleibt deshalb im Dashboard.
  • Geheime Werte. Werte von Umgebungsvariablen, .env-Dateien und private Schlüssel erreichen den KI-Client nie. Siehe Geheimnisse.
  • Kontoeinstellungen, Abrechnung, API-Schlüssel und Workspace-Mitglieder. Sie werden im Dashboard verwaltet.

Nächste Schritte

Einen Client verbinden

Claude, ChatGPT, Claude Code, VS Code oder Cursor einrichten.

Berechtigungen und Sicherheit

Scopes, beschränkte Schlüssel und Sicherheits-Snapshots.

Tools

Jedes Tool und der Scope, den es braucht.

Limits und Fehler

Die Anfrage- und Tool-Limits und was jeder Fehler bedeutet.