> ## 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. # Einen KI-Client mit dem MCP-Server von Square Cloud verbinden > Verbinde Claude und ChatGPT per OAuth oder Claude Code, VS Code und Cursor per API-Schlüssel mit dem MCP-Server von Square Cloud und erfahre, wie lange eine Verbindung gilt. Jeder Client nutzt dieselbe Adresse, `https://mcp.squarecloud.app/mcp`. Wie er sich anmeldet, hängt vom Client ab: | Client | Wie er sich verbindet | | - | - | | [Claude](#claude) (claude.ai und die Claude-Apps) | OAuth: Adresse einfügen und auf Square Cloud autorisieren | | [ChatGPT](#chatgpt) | OAuth: Adresse einfügen und auf Square Cloud autorisieren | | [Claude Code](#claude-code) | [API-Schlüssel](#einen-api-schlüssel-erstellen) im Header `Authorization` | | [VS Code](#vs-code) | [API-Schlüssel](#einen-api-schlüssel-erstellen) im Header `Authorization` | | [Cursor](#cursor) | [API-Schlüssel](#einen-api-schlüssel-erstellen) im Header `Authorization` | | [Andere Clients](#andere-clients) | [API-Schlüssel](#einen-api-schlüssel-erstellen) im Header `Authorization` | Dein Konto braucht in beiden Fällen einen aktiven [Plan](https://docs.squarecloud.app/de/platform/plans.md). ## Claude **1. Einen benutzerdefinierten Connector hinzufügen** Öffne in Claude **Customize > Connectors**, klicke auf **+ Add** und dann auf **Add custom connector**. In Team- und Enterprise-Plänen fügt eine Person mit der Rolle Owner ihn zuerst unter **Organization settings > Connectors** hinzu (**Add > Custom > Web**), und jedes Mitglied verbindet ihn dann über **Customize > Connectors**. **2. Die Adresse eingeben** Nenne ihn `Square Cloud`, gib `https://mcp.squarecloud.app/mcp` ein und klicke auf **Continue**. **3. Claudes eigene Identität behalten** Behalte eine Anmeldeoption (**Sign in now** oder **Sign in when needed**) und als OAuth-Client **Use Claude's published identity (Recommended)**. Lass **Request headers** leer und klicke auf **Add**. **4. Auf Square Cloud autorisieren** Claude öffnet eine Seite von Square Cloud. Melde dich bei Bedarf an, prüfe die Berechtigungen, die Claude anfordert, und klicke zum Autorisieren. Du kannst Berechtigungen abwählen, um Claude weniger Zugriff zu geben; `mcp` bleibt immer, denn darüber läuft die Verbindung. **5. Im Chat nutzen** Zurück in Claude klickst du im Chatfeld auf **+**, öffnest **Connectors** und schaltest **Square Cloud** ein. > [!NOTE] > > Square Cloud akzeptiert nur Claudes veröffentlichte Identität. **Register automatically** und **Use your own OAuth client** funktionieren damit nicht. ## ChatGPT **1. Einen benutzerdefinierten MCP-Server hinzufügen** Öffne die [Plugins von ChatGPT](https://chatgpt.com/plugins), wähle **+** und dann **Add custom MCP server**. Je nach ChatGPT-Plan muss ein Workspace-Administrator benutzerdefinierte MCP-Server zuerst erlauben. **2. Die Adresse eingeben** Nenne ihn `Square Cloud`, wähle den öffentlichen Endpoint als Verbindung und gib `https://mcp.squarecloud.app/mcp` ein. Wähle OAuth für die Authentifizierung. **3. Erstellen** Lies die Warnung, wähle **I understand and want to continue** und dann **Create as a plugin**. **4. Auf Square Cloud autorisieren** Wenn ChatGPT dich zur Anmeldung auffordert, öffnet es eine Seite von Square Cloud. Melde dich bei Bedarf an, prüfe die Berechtigungen und klicke zum Autorisieren. Du kannst Berechtigungen abwählen; `mcp` bleibt immer. **5. Im Chat nutzen** Starte eine neue Unterhaltung, tippe `@` und wähle **Square Cloud**. > [!NOTE] > > ChatGPT ändert die Namen dieser Menüs von Zeit zu Zeit. Weichen sie ab, folge der [Anleitung von OpenAI zum Verbinden eines MCP-Servers](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt). ## Claude Code Claude Code verbindet sich mit einem [API-Schlüssel](#einen-api-schlüssel-erstellen) in einem Header, nicht per OAuth. Speichere den Schlüssel in der Umgebungsvariable `SQUARECLOUD_API_KEY` und führe aus: ```bash theme={"system"} claude mcp add --transport http squarecloud https://mcp.squarecloud.app/mcp \ --header "Authorization: Bearer $SQUARECLOUD_API_KEY" ``` Deine Shell setzt den Schlüssel ein, wenn du den Befehl ausführst, und Claude Code speichert ihn in seiner eigenen Konfiguration. Um den Server mit einem Projekt zu teilen, ohne den Schlüssel zu teilen, füge ihn stattdessen zur `.mcp.json` des Projekts hinzu; Claude Code liest die Variable bei jedem Start: ```json .mcp.json theme={"system"} { "mcpServers": { "squarecloud": { "type": "http", "url": "https://mcp.squarecloud.app/mcp", "headers": { "Authorization": "Bearer ${SQUARECLOUD_API_KEY}" } } } } ``` Prüfe die Verbindung mit `claude mcp list` oder mit `/mcp` in Claude Code. ## VS Code Füge den Server zu `.vscode/mcp.json` in deinem Projekt hinzu oder mit **MCP: Open User Configuration** aus der Befehlspalette zu deiner Benutzerkonfiguration: ```json .vscode/mcp.json theme={"system"} { "inputs": [ { "type": "promptString", "id": "squarecloud-api-key", "description": "Square Cloud API key", "password": true } ], "servers": { "squarecloud": { "type": "http", "url": "https://mcp.squarecloud.app/mcp", "headers": { "Authorization": "Bearer ${input:squarecloud-api-key}" } } } } ``` VS Code fragt nach dem [API-Schlüssel](#einen-api-schlüssel-erstellen), wenn der Server startet, sodass er nie in der Datei steht. Mit **MCP: List Servers** startest, stoppst oder startest du den Server neu. > [!TIP] > > Das ist unabhängig von der [Square Cloud-Erweiterung für VS Code](https://docs.squarecloud.app/de/vscode-extension/installation.md), die deine Anwendungen über die Seitenleiste verwaltet. Du kannst beides nutzen. ## Cursor Füge den Server zu `.cursor/mcp.json` in deinem Projekt hinzu oder für alle Projekte zu `~/.cursor/mcp.json`: ```json .cursor/mcp.json theme={"system"} { "mcpServers": { "squarecloud": { "url": "https://mcp.squarecloud.app/mcp", "headers": { "Authorization": "Bearer ${env:SQUARECLOUD_API_KEY}" } } } } ``` Setze `SQUARECLOUD_API_KEY` in deiner Umgebung, bevor du Cursor öffnest. Schalte den Server im Menü **Customize** von Cursor ein; verbindet er sich nicht, zeigt der Kanal **MCP Logs** im Ausgabebereich den Grund. ## Andere Clients Jeder Client, der Remote-MCP-Server über Streamable HTTP mit einem benutzerdefinierten Header unterstützt, funktioniert genauso: Nutze die Adresse `https://mcp.squarecloud.app/mcp` und sende den API-Schlüssel im Header `Authorization`. Das Präfix `Bearer ` ist optional. ```http theme={"system"} Authorization: Bearer ``` ## Einen API-Schlüssel erstellen Erstelle den Schlüssel in deinen [Sicherheitseinstellungen des Kontos](https://squarecloud.app/de/account/security): * **Gib ihm den Scope `mcp`** sowie die Scopes der Tools, die der Client nutzen soll. Ein Schlüssel mit Vollzugriff funktioniert auch. Siehe [Scopes](https://docs.squarecloud.app/de/mcp/permissions-and-safety.md#scopes). * **Für reinen Lesezugriff** wähle `mcp`, `apps:read`, `files:read`, `envs:read`, `snapshots:read` und `databases:read`. * **Um den Client auf bestimmte Anwendungen und Datenbanken zu begrenzen**, beschränke den Schlüssel auf sie. Siehe [Beschränkte Schlüssel](https://docs.squarecloud.app/de/mcp/permissions-and-safety.md#auf-anwendungen-und-datenbanken-beschränkte-schlüssel). Das Geheimnis wird nur einmal angezeigt. Bewahre es in einer Umgebungsvariable oder im Geheimnisspeicher deines Clients auf, nie in einem Chat oder in einer Datei, die du committest. Selbst erstellte Schlüssel laufen nicht ab: Widerrufe den Schlüssel, wenn du ihn nicht mehr nutzt. Ein Konto hat bis zu 10 Schlüssel. ## Wie lange eine Verbindung gilt **Claude und ChatGPT (OAuth).** Die Autorisierung erstellt einen API-Schlüssel für diesen Client, benannt nach ihm (`Claude` oder `ChatGPT`): * Er gilt **90 Tage** und hat kein Refresh-Token. Läuft er ab, fordert dich der Client auf, dich erneut anzumelden und zu autorisieren. * Er funktioniert nur auf dem MCP-Server. Auf der REST-API antwortet er mit `403 MISSING_SCOPE`. * **Verbindest du denselben Client erneut, wird sein vorheriger Schlüssel widerrufen.** Jedes Konto behält eine Claude-Verbindung und eine ChatGPT-Verbindung, daher trennt das Verbinden eines zweiten Claude-Kontos das erste. Um mehrere Verbindungen gleichzeitig zu nutzen, gib jeder weiteren einen eigenen API-Schlüssel. In Claude kann auch ein benutzerdefinierter Connector einen API-Schlüssel senden: Wähle unter **Authentication** die Option **No sign in** und füge den Header `Authorization` unter **Request headers** hinzu. In Team- und Enterprise-Plänen teilen sich alle, die diesen Connector nutzen, den Zugriff des Schlüssels. **Selbst erstellte API-Schlüssel** laufen nicht ab. Egal auf welchem Weg: Alle MCP-Verbindungen eines Kontos teilen sich dieselben [Limits](https://docs.squarecloud.app/de/mcp/limits-and-errors.md). ## Trennen Widerrufe den Schlüssel in deinen [Sicherheitseinstellungen des Kontos](https://squarecloud.app/de/account/security): den Schlüssel `Claude` oder `ChatGPT` bei einer OAuth-Verbindung oder den Schlüssel, den du erstellt hast. Der Zugriff endet bei der nächsten Anfrage des Clients. Wenn du den Connector oder Server im Client entfernst, ruft er nicht mehr auf, aber nur der Widerruf des Schlüssels auf Square Cloud macht ihn ungültig. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.