https://mcp.squarecloud.app/mcp. Wie er sich anmeldet, hängt vom Client ab:
Dein Konto braucht in beiden Fällen einen aktiven Plan.
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.
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, 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.ChatGPT ändert die Namen dieser Menüs von Zeit zu Zeit. Weichen sie ab, folge der Anleitung von OpenAI zum Verbinden eines MCP-Servers.
Claude Code
Füge den Server hinzu:/mcp aus, wähle squarecloud und dann Authenticate. Dein Browser öffnet die Zustimmungsseite von Square Cloud: Prüfe die Berechtigungen und klicke zum Autorisieren. Das funktioniert im Terminal und in der VS-Code-Erweiterung gleich.
Mit einem API-Schlüssel
Auf einem Rechner ohne Browser oder um Claude Code auf mehr als einem Rechner zu verbinden (siehe Wie lange eine Verbindung gilt), sende stattdessen einen API-Schlüssel in einem Header. Speichere den Schlüssel in der UmgebungsvariableSQUARECLOUD_API_KEY und führe aus:
.mcp.json des Projekts hinzu; Claude Code liest die Variable bei jedem Start:
.mcp.json
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:
.vscode/mcp.json
Cursor
Füge den Server zu.cursor/mcp.json in deinem Projekt hinzu oder für alle Projekte zu ~/.cursor/mcp.json:
.cursor/mcp.json
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 Adressehttps://mcp.squarecloud.app/mcp und sende den API-Schlüssel im Header Authorization. Das Präfix Bearer ist optional.
Einen API-Schlüssel erstellen
Erstelle den Schlüssel in deinen Sicherheitseinstellungen des Kontos:- Gib ihm den Scope
mcpsowie die Scopes der Tools, die der Client nutzen soll. Ein Schlüssel mit Vollzugriff funktioniert auch. Siehe Scopes. - Für reinen Lesezugriff wähle
mcp,apps:read,files:read,envs:read,snapshots:readunddatabases:read. - Um den Client auf bestimmte Anwendungen und Datenbanken zu begrenzen, beschränke den Schlüssel auf sie. Siehe Beschränkte Schlüssel.
Wie lange eine Verbindung gilt
Claude, ChatGPT und Claude Code (OAuth). Die Autorisierung erstellt einen API-Schlüssel für diesen Client, benannt nach ihm (Claude, ChatGPT oder Claude Code):
- 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 Verbindung pro Client, daher trennt das Verbinden eines zweiten Claude-Kontos oder von Claude Code auf einem zweiten Rechner die erste Verbindung.
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.
Trennen
Widerrufe den Schlüssel in deinen Sicherheitseinstellungen des Kontos: den SchlüsselClaude, ChatGPT oder Claude Code 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.
