> ## 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.

# MCP-Tools von Square Cloud

> Die 49 Tools des MCP-Servers von Square Cloud nach Bereich, mit dem Scope, den jedes braucht.

Der MCP-Server hat 49 Tools. Ein Client sieht nur die, die die [Scopes](https://docs.squarecloud.app/de/mcp/permissions-and-safety.md#scopes) seines Schlüssels abdecken. Tools benennen eine Anwendung über ihre ID, ihren exakten Namen oder ihren Hostnamen und eine Datenbank über ihre ID oder ihren Namen. Jedes Tool antwortet mit JSON mit `ok`, einer `summary` und, wenn etwas fehlgeschlagen ist oder dich braucht, einem `code`.

Jedes Tool [läuft sofort](https://docs.squarecloud.app/de/mcp/permissions-and-safety.md#jede-änderung-läuft-sofort). Das Löschen einer Anwendung oder Datenbank und das Wiederherstellen eines Snapshots erstellen vorher einen [Sicherheits-Snapshot](https://docs.squarecloud.app/de/mcp/permissions-and-safety.md#löschungen-und-wiederherstellungen).

## Anwendungen

| Tool | Was es tut | Scope |
| - | - | - |
| `list_applications` | Listet deine Anwendungen (ID, Name, Sprache, läuft oder nicht, Domain), 100 pro Seite. | `apps:read` |
| `get_application_status` | Live-Status einer Anwendung: CPU, RAM, Betriebszeit, Adresse, Custom Domain, Arbeitsspeicher und automatischer Neustart. | `apps:read` |
| `get_all_applications_status` | Ob jede deiner Anwendungen läuft, in einem Aufruf. | `apps:read` |
| `get_application_logs` | Die neuesten Logs einer Anwendung, etwa die letzten 4.000 Zeichen. | `apps:read` |
| `get_deployments` | Git-Deploy-Verlauf (GitHub App oder Webhook) einer Anwendung: Commit, Branch, Ergebnis, Dauer und der Fehler eines fehlgeschlagenen Deploys. | `apps:read` |
| `get_metrics_history` | CPU- und RAM-Verlauf einer Anwendung oder Datenbank, mit Durchschnitt, Spitze und letztem Wert. 24 Stunden, oder 7 Tage bei Pro und Enterprise (bei einer Anwendung nur ab 512 MB). | `apps:read` oder `databases:read` |
| `start_application` | Startet eine gestoppte Anwendung. | `apps:control` |
| `stop_application` | Stoppt eine laufende Anwendung. | `apps:control` |
| `restart_application` | Startet eine Anwendung neu, wodurch auch Datei- und Konfigurationsänderungen angewendet werden. | `apps:control` |
| `create_application` | Erstellt und deployt eine neue Anwendung aus einer Vorlage (Node.js, Python, statische Website, Go, Rust, Elixir, .NET, PHP oder Ruby), optional mit deinen ersten Dateien. | `apps:write` |
| `upload_application` | Erstellt und deployt eine neue Anwendung aus einem Zip eines Projekts, das du schon hast, als base64 gesendet (bis 1 MB). Die [Konfigurationsdatei](https://docs.squarecloud.app/de/getting-started/config-file.md) `squarecloud.app` muss im Stammverzeichnis des Zips liegen, nicht in einem Ordner. | `apps:write` |
| `commit_application` | Sendet eine neue Version an eine bestehende Anwendung, als Textdateien oder als Zip (bis 1 MB), in einen Ordner deiner Wahl (standardmäßig das Stammverzeichnis). Dateien mit demselben Namen werden ersetzt, sonst wird nichts gelöscht. Startet die Anwendung nicht neu und erstellt mit `snapshot` vorher einen Snapshot. | `files:write` (mit `snapshot` außerdem `snapshots:write`) |
| `delete_application` | Löscht eine Anwendung, vorher mit einem Sicherheits-Snapshot. | `apps:write` |

## Dateien und Konfiguration

| Tool | Was es tut | Scope |
| - | - | - |
| `list_files` | Listet einen Ordner einer Anwendung. | `files:read` |
| `read_file` | Liest eine Textdatei bis 10 MB, Seite für Seite. | `files:read` |
| `search_files` | Durchsucht die Dateien einer Anwendung nach Text oder einem regulären Ausdruck und überspringt `node_modules`, `.git`, Build-Ausgaben, Lock-Dateien und Binärdateien. | `files:read` |
| `create_file` | Schreibt eine Datei mit ihrem vollständigen Inhalt (bis 128 KB) und legt ihre Ordner an. Ersetzt eine bereits vorhandene Datei. | `files:write` |
| `edit_file` | Ersetzt den Inhalt einer vorhandenen Datei (bis 128 KB). | `files:write` |
| `patch_file` | Bearbeitet eine Datei bis 10 MB mit exakten Suchen-und-Ersetzen-Änderungen. Passt eine Änderung nicht, wird nichts geschrieben. | `files:write` |
| `rename_file` | Benennt eine Datei oder einen Ordner um oder verschiebt sie. | `files:write` |
| `delete_file` | Löscht eine Datei oder einen Ordner. Verweigert das Stammverzeichnis der Anwendung, die Konfigurationsdatei und `.env`-Dateien. | `files:write` |
| `edit_config_file` | Ändert die [Konfigurationsdatei](https://docs.squarecloud.app/de/getting-started/config-file.md) Feld für Feld: Anzeigename, Beschreibung, Arbeitsspeicher, automatischer Neustart, Subdomain, `MAIN` und `START`. | `files:write` |

Dateiänderungen wirken beim nächsten Neustart. In der Konfigurationsdatei gelten Arbeitsspeicher und Subdomain sofort, `MAIN` und `START` beim nächsten Neustart.

## Umgebungsvariablen

| Tool | Was es tut | Scope |
| - | - | - |
| `list_env_vars` | Listet die Namen der Umgebungsvariablen einer Anwendung, nie ihre Werte. | `envs:read` |
| `set_env_vars` | Fügt Variablen in einem Aufruf hinzu, ändert oder entfernt sie, optional mit Neustart. | `envs:write` (mit `restart` außerdem `apps:control`) |

## Snapshots

| Tool | Was es tut | Scope |
| - | - | - |
| `list_snapshots` | Snapshots einer Anwendung oder Datenbank, neueste zuerst. Ohne Ziel eine Übersicht des Kontos, einschließlich gelöschter Anwendungen, deren Snapshots noch vorhanden sind. | `snapshots:read` |
| `create_snapshot` | Erstellt einen Snapshot einer Anwendung oder Datenbank. Zählt zum täglichen Snapshot-Kontingent deines Plans. | `snapshots:write` |
| `restore_snapshot` | Setzt eine bestehende Anwendung oder Datenbank auf einen Snapshot zurück, nach einem Snapshot ihres aktuellen Zustands. | `snapshots:write` |

## Datenbanken

| Tool | Was es tut | Scope |
| - | - | - |
| `list_databases` | Listet deine Datenbanken (ID, Name, Engine, RAM, Host, Port, läuft oder nicht). | `databases:read` |
| `create_database` | Erstellt eine Datenbank (ab den Standard-Plänen), was bis zu etwa 90 Sekunden dauert. Mit `connect_to_app` schreibt es außerdem die Verbindungs-URL und die Zertifikatsdatei in eine Anwendung. | `databases:write` (mit `connect_to_app` außerdem `databases:credentials` und `envs:write`) |
| `start_database` | Startet eine gestoppte Datenbank. | `databases:write` |
| `stop_database` | Stoppt eine laufende Datenbank. Die Anwendungen, die sie nutzen, verlieren ihre Verbindung, bis sie wieder startet. | `databases:write` |
| `update_database` | Ändert den RAM einer Datenbank, live angewendet. | `databases:write` |
| `connect_database` | Verbindet eine bestehende Datenbank mit einer Anwendung: rotiert ihr Passwort, schreibt die neue URL und das Zertifikat in die Anwendung und aktualisiert die anderen Anwendungen, die sie nutzen. | `databases:credentials` und `envs:write` |
| `rotate_database_credentials` | Rotiert das Passwort oder das TLS-Zertifikat einer Datenbank und nennt die Anwendungen, die es aktualisiert hat. | `databases:credentials` und `envs:write` |
| `delete_database` | Löscht eine Datenbank und ihre Daten, vorher mit einem Sicherheits-Snapshot. | `databases:write` |

## Domains und Netzwerk

Die Netzwerk-Tools arbeiten mit Websites (Anwendungen mit einer Domain), über Zeitfenster von bis zu 7 Tagen.

| Tool | Was es tut | Scope |
| - | - | - |
| `list_account_domains` | Jede Domain jeder Anwendung: `squareweb.app`-Adressen und Custom Domains, 100 pro Seite. | `apps:read` |
| `list_dns_records` | Die DNS-Einträge, die für die Custom Domain einer Anwendung anzulegen sind, mit ihrem Status. | `apps:read` |
| `set_custom_domain` | Verbindet, ersetzt oder entfernt die Custom Domain einer Anwendung und liefert die anzulegenden DNS-Einträge. | `apps:write` |
| `purge_network_cache` | Leert den Edge-Cache von bis zu 50 Anwendungen in einem Aufruf. | `apps:write` |
| `get_network_analytics` | Edge-Traffic: Anfragen, Besuche und Bytes, aufgeschlüsselt nach Land, Pfad, Referrer, Gerät und mehr. | `apps:read` |
| `get_network_errors` | HTTP-Fehler am Edge nach Statuscode, Pfad und Methode. Standardmäßig 5xx, auf Anfrage 4xx. | `apps:read` |
| `get_network_performance` | Zeit bis zum ersten Byte und Antwortzeit des Ursprungsservers (p50, p95, p99) sowie die langsamsten Pfade. Pro und Enterprise. | `apps:read` |
| `get_network_logs` | Die 40 neuesten Anfragen am Edge, mit maskierten IP-Adressen. Pro und Enterprise. | `apps:read` |

## Workspaces

| Tool | Was es tut | Scope |
| - | - | - |
| `list_workspaces` | Die Workspaces, die dir gehören oder in denen du Mitglied bist, mit Mitgliedern und geteilten Anwendungen. Nur lesend: Die anderen Tools erreichen nur deine eigenen Anwendungen. | `workspaces:manage` |

## Hilfe und Status

Diese Tools brauchen nur den Scope `mcp`.

| Tool | Was es tut | Scope |
| - | - | - |
| `get_platform_knowledge` | Die eigene Referenz von Square Cloud zu Limits, Plänen, Fehlercodes und Einrichtung. | `mcp` |
| `search_help_center` | Durchsucht das [Hilfe-Center](https://help.squarecloud.app) oder liest einen seiner Artikel. | `mcp` |
| `list_help_center` | Listet alle Artikel des Hilfe-Centers nach Kategorie. | `mcp` |
| `get_platform_status` | Der Status der Dienste von Square Cloud und der Anbieter, auf die sie angewiesen sind. | `mcp` |
| `get_discord_status` | Der eigene Status und die API-Latenz von Discord, um einen Discord-Ausfall von einem Bot-Problem zu unterscheiden. | `mcp` |

## Bewusst ausgelassen

| Nicht verfügbar | Warum | Stattdessen |
| - | - | - |
| Snapshots herunterladen | Der signierte Link enthält deinen Code und deine Umgebungsvariablen und würde in der Unterhaltung und beim Anbieter des KI-Modells landen. | Lade den Snapshot im Dashboard herunter. |
| Datenbankzertifikate herunterladen | Derselbe Grund: Das Zertifikat würde Square Cloud über das Modell verlassen. | Lade das Zertifikat im Dashboard herunter. |
| Kontoaktivität | Sie zeigt die IP-Adressen und Geräte deines Kontos. | Sieh dir dein [Aktivitätsprotokoll](https://squarecloud.app/de/dashboard/activity) an. |


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