> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Der MCP-Server von Square Cloud

> Verbinde Claude, ChatGPT, Claude Code, VS Code oder Cursor über den Remote-MCP-Server mit deinem Square Cloud-Konto und verwalte Anwendungen und Datenbanken aus dem Chat.

Mit dem MCP-Server von Square Cloud arbeitet ein KI-Client über das [Model Context Protocol](https://modelcontextprotocol.io) in deinem Konto. Formuliere deine Bitte in einfachen Worten, und der Client ruft die [Tools](https://docs.squarecloud.app/de/mcp/tools.md) 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

```text theme={"system"}
https://mcp.squarecloud.app/mcp
```

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](https://docs.squarecloud.app/de/platform/plans.md).** 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](https://docs.squarecloud.app/de/mcp/connect.md).

## Protokoll

| Thema | Details |
| - | - |
| Transport | Streamable HTTP, nur `POST`. Der Server hält keine Sitzung, und `GET` antwortet mit `405`. |
| Protokollversionen | `2026-07-28`, `2025-11-25`, `2025-06-18` und `2025-03-26`. Clients der Revision `2026-07-28` rufen ohne Handshake auf; ältere Clients beginnen mit `initialize`. Eine Anfrage ohne `MCP-Protocol-Version` wird als `2025-03-26` gelesen, und eine nicht unterstützte Version antwortet mit `400` und der Liste der unterstützten Versionen. |
| Fähigkeiten | Nur Tools, keine Ressourcen oder Prompts. |
| Ergebnisse | Jedes Tool antwortet mit einem JSON-Objekt als Textblock, mit `ok`, einer `summary` und, wenn etwas fehlgeschlagen ist oder dich braucht, einem `code`. |
| Lange Aufrufe | Ein Aufruf, der länger als ein paar Sekunden dauert, wird als Stream (SSE) mit Keepalives beantwortet. Das Schließen der Verbindung bricht den Aufruf ab, und kein Aufruf läuft länger als 3 Minuten. |

## Was außerhalb des MCP-Servers bleibt

* **Projekte über 1 MB.** Der Client kann ein Projekt von deinem Computer als Zip bis 1 MB senden, mit `upload_application` für eine neue Anwendung oder `commit_application` für eine neue Version, und Textdateien mit `create_application` und `commit_application`. Für ein größeres Projekt nutze die [CLI](https://docs.squarecloud.app/de/cli-reference/deploy.md), die [VS Code-Erweiterung](https://docs.squarecloud.app/de/vscode-extension/features.md) oder [GitHub-Deploys](https://docs.squarecloud.app/de/cli-reference/github-deploys.md).
* **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](https://docs.squarecloud.app/de/mcp/permissions-and-safety.md#geheimnisse).
* **Kontoeinstellungen, Abrechnung, API-Schlüssel und Workspace-Mitglieder.** Sie werden im Dashboard verwaltet.

## Nächste Schritte

> [card] [Einen Client verbinden](https://docs.squarecloud.app/de/mcp/connect.md)
>
> Claude, ChatGPT, Claude Code, VS Code oder Cursor einrichten.

> [card] [Berechtigungen und Sicherheit](https://docs.squarecloud.app/de/mcp/permissions-and-safety.md)
>
> Scopes, beschränkte Schlüssel und Sicherheits-Snapshots.

> [card] [Tools](https://docs.squarecloud.app/de/mcp/tools.md)
>
> Jedes Tool und der Scope, den es braucht.

> [card] [Limits und Fehler](https://docs.squarecloud.app/de/mcp/limits-and-errors.md)
>
> Die Anfrage- und Tool-Limits und was jeder Fehler bedeutet.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.