Einen KI-Client mit dem MCP-Server von Square Cloud verbinden

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.ai und die Claude-Apps)	OAuth: Adresse einfügen und auf Square Cloud autorisieren
ChatGPT	OAuth: Adresse einfügen und auf Square Cloud autorisieren
Claude Code	API-Schlüssel im Header `Authorization`
VS Code	API-Schlüssel im Header `Authorization`
Cursor	API-Schlüssel im Header `Authorization`
Andere Clients	API-Schlüssel im Header `Authorization`

Dein Konto braucht in beiden Fällen einen aktiven Plan.

Claude

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.

Die Adresse eingeben

Nenne ihn Square Cloud, gib https://mcp.squarecloud.app/mcp ein und klicke auf Continue.

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.

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.

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

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.

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.

Erstellen

Lies die Warnung, wähle I understand and want to continue und dann Create as a plugin.

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.

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

Claude Code verbindet sich mit einem API-Schlüssel in einem Header, nicht per OAuth. Speichere den Schlüssel in der Umgebungsvariable SQUARECLOUD_API_KEY und führe aus:

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:

.mcp.json

{
  "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:

.vscode/mcp.json

{
  "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, wenn der Server startet, sodass er nie in der Datei steht. Mit MCP: List Servers startest, stoppst oder startest du den Server neu.

Das ist unabhängig von der Square Cloud-Erweiterung für VS Code, 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:

.cursor/mcp.json

{
  "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.

Authorization: Bearer <your API key>

Einen API-Schlüssel erstellen

Erstelle den Schlüssel in deinen Sicherheitseinstellungen des Kontos:

Gib ihm den Scope mcp sowie 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: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.

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.

Trennen

Widerrufe den Schlüssel in deinen Sicherheitseinstellungen des Kontos: 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.

CLI

VS Code

MCP

SDKs

Einen KI-Client mit dem MCP-Server von Square Cloud verbinden

Claude

ChatGPT

Claude Code

VS Code

Cursor

Andere Clients

Einen API-Schlüssel erstellen

Wie lange eine Verbindung gilt

Trennen

​Claude

​ChatGPT

​Claude Code

​VS Code

​Cursor

​Andere Clients

​Einen API-Schlüssel erstellen

​Wie lange eine Verbindung gilt

​Trennen

Claude

ChatGPT

Claude Code

VS Code

Cursor

Andere Clients

Einen API-Schlüssel erstellen

Wie lange eine Verbindung gilt

Trennen