Square MCP Server

Der Square MCP Server verbindet KI-Assistenten wie Claude, Cursor, Goose oder Windsurf mit der Square-API. Wer ein Geschäft, ein Café oder einen Dienstleistungsbetrieb über Square abwickelt, kann dem Assistenten damit Fragen stellen wie „Welche Bestellungen sind heute eingegangen?“, „Lege einen neuen Kunden an“ oder „Welche Artikel im Katalog haben keinen Preis?“, ohne ins Dashboard zu wechseln oder eigenen Code gegen die API zu schreiben. Betrieben wird der Server von Block, dem Unternehmen hinter Square. Laut Dokumentation befindet er sich derzeit in der Beta-Phase.

Was ist der Square MCP Server?

MCP, das Model Context Protocol, ist ein offenes Protokoll, mit dem KI-Assistenten Werkzeuge externer Dienste aufrufen. Der Square-Server verfolgt dabei einen ungewöhnlich schlanken Ansatz: Statt für jede Funktion ein eigenes Werkzeug anzubieten, stellt er laut README drei Werkzeuge bereit. Mit get_service_info erfährt der Assistent, welche Methoden ein Square-Dienst bietet, mit get_type_info sieht er die Parameter und Datenstrukturen einer Methode, und mit make_api_request führt er den eigentlichen Aufruf aus. Dadurch deckt der Server nach Angaben des Repositorys über vierzig Dienste ab, darunter Zahlungen, Kunden, Bestellungen, Inventar, Terminbuchungen und Treueprogramme. Das Repository ist aus der OpenAPI-Spezifikation von Square generiert, Änderungen am Funktionsumfang kommen also über den Generator.

Wofür ist er besonders nützlich?

Der größte Nutzen liegt in der alltäglichen Verwaltung und in Auswertungen, die im Dashboard mehrere Klicks kosten. Der Assistent kann Kundendatensätze suchen und ergänzen, Bestellungen eines Zeitraums zusammenfassen, Katalogartikel prüfen oder Buchungen nachsehen. Entwicklerinnen und Entwickler profitieren zusätzlich, weil der Assistent die API-Struktur selbst erkundet: Er kann damit Integrationen skizzieren oder Testaufrufe formulieren, ohne dass man erst die Referenz durcharbeitet. Gegenüber einem allgemeinen HTTP-Werkzeug kennt der Server die Square-Typen und führt Anfragen mit korrekter Authentifizierung aus.

Remote-Server oder lokale Installation

Square empfiehlt den gehosteten Remote-Server unter https://mcp.squareup.com/mcp. Er meldet Sie per OAuth mit Ihrem Square-Konto an, Sie verwalten also keine Token von Hand, und Sie genehmigen nur die Berechtigungen, die benötigt werden. Der Remote-Server arbeitet laut Dokumentation ausschließlich mit Produktivdaten. Wer zuerst gefahrlos testen möchte, startet den lokalen Server mit npx square-mcp-server start. Er benötigt Node.js und ein Zugriffstoken, bietet dafür aber den Sandbox-Modus (SANDBOX=true), in dem keine echten Kunden- oder Zahlungsdaten betroffen sind. Mit DISALLOW_WRITES=true lässt sich der lokale Server außerdem auf reinen Lesezugriff beschränken.

Einrichtung

Für Claude Desktop trägt man laut Dokumentation den Server über mcp-remote ein: Als Befehl npx mit den Argumenten mcp-remote und der Server-URL. Cursor, Windsurf, Goose und claude.ai werden ebenfalls als unterstützte Clients genannt. Square führt eine Zulassungsliste für MCP-Clients, um bösartige Client-Registrierungen zu verhindern; ein nicht gelisteter Client muss von Square freigegeben werden, bevor die Anmeldung funktioniert.

Sicherheit und Grenzen

Der Assistent handelt mit den Rechten, die Sie bei der Anmeldung erteilen, und kann über make_api_request auch schreibende Aufrufe auslösen, etwa Kunden ändern oder Bestellungen anlegen. Square rät ausdrücklich, sich zuerst mit dem Server vertraut zu machen und Anfragen gegen die Sandbox zu testen, bevor man ihn produktiv nutzt. Bestätigen Sie schreibende Aktionen bewusst und vergeben Sie nur die Berechtigungen, die der Anwendungsfall braucht. Kundendaten, die der Assistent abruft, gelangen in den Kontext des KI-Clients und damit zum Modellanbieter; das ist datenschutzrechtlich für Ihre Kundschaft zu bewerten.

Kosten

Für den Server selbst nennt die Dokumentation keine eigene Gebühr. Voraussetzung ist ein Square-Konto; für Zahlungen und Zusatzdienste gelten die regulären Square-Konditionen, die Sie auf der offiziellen Preisseite von Square finden.

Für wen lohnt sich der Square MCP Server?

Er lohnt sich für Händler und Dienstleister, die ohnehin mit Square arbeiten und Routineaufgaben oder Auswertungen per Sprache erledigen möchten, sowie für Entwickler, die Square-Integrationen bauen. Wer Square nicht nutzt, hat keinen Nutzen davon. Beachten Sie den Beta-Status: Funktionsumfang und Verhalten können sich noch ändern.

Ein Square-Konto und ein MCP-Client mit Unterstützung für Remote-Server (etwa Claude Desktop, Cursor oder Windsurf). Für die lokale Variante zusätzlich Node.js und ein Zugriffstoken.

Mit dem Square MCP Server greift ein KI-Assistent auf Kunden, Bestellungen, Katalog und weitere Square-Daten zu. Dieser Ratgeber führt von der Wahl der Variante bis zu den ersten Abfragen.

Variante wählen

Square bietet einen gehosteten Remote-Server und eine lokale Installation. Der Remote-Server unter https://mcp.squareup.com/mcp arbeitet laut Dokumentation nur mit Produktivdaten und meldet Sie per OAuth an. Die lokale Variante läuft mit Node.js, benötigt ein Zugriffstoken und bietet einen Sandbox-Modus. Für erste Versuche ist die Sandbox die sicherere Wahl.

Schritt 1: Lokal in der Sandbox testen

Legen Sie im Square-Entwicklerkonto ein Sandbox-Zugriffstoken an. Starten Sie den Server mit npx square-mcp-server start und setzen Sie ACCESS_TOKEN sowie SANDBOX=true. Mit DISALLOW_WRITES=true erlauben Sie nur Lesezugriff, was für das Kennenlernen ausreicht.

Schritt 2: Remote-Server verbinden

Tragen Sie in der Konfiguration von Claude Desktop einen Server mit dem Befehl npx und den Argumenten mcp-remote sowie der URL https://mcp.squareup.com/mcp ein. Beim ersten Verbinden öffnet sich die Anmeldung bei Square; genehmigen Sie nur die Berechtigungen, die Sie wirklich brauchen.

Zulassungsliste beachten

Square führt eine Zulassungsliste für MCP-Clients. Gelistet sind laut Dokumentation unter anderem Claude, Cursor, Goose und Windsurf. Ein anderer Client muss bei Square angefordert werden, bevor die Anmeldung gelingt.

Schritt 3: Erste Abfragen

Beginnen Sie lesend: „Liste meine zehn letzten Bestellungen.“ oder „Welche Katalogartikel haben keinen Preis?“ Der Assistent ruft dafür get_service_info und get_type_info auf, um die passende Methode zu finden, und führt dann make_api_request aus.

Schreibende Aktionen bewusst bestätigen

Über make_api_request sind auch Änderungen möglich, etwa neue Kunden oder Bestellungen. Square empfiehlt, Anfragen zuerst in der Sandbox zu testen. Prüfen Sie jede schreibende Aktion, bevor Sie sie bestätigen, und denken Sie daran, dass abgerufene Kundendaten in den Kontext des KI-Clients gelangen.

npx mcp-remote https://mcp.squareup.com/mcp

Remote: OAuth-Anmeldung mit dem Square-Konto (empfohlen), nur für zugelassene MCP-Clients. Lokal: Zugriffstoken in der Umgebungsvariable ACCESS_TOKEN.

Lese- und Schreibzugriff auf Square-Dienste im Rahmen der bei der Anmeldung erteilten Berechtigungen, etwa Kunden, Bestellungen, Katalog, Inventar, Buchungen und Zahlungen. Lokal lässt sich mit DISALLOW_WRITES=true auf Lesezugriff beschränken.

Der Remote-Server wird laut Dokumentation von Block gehostet. Abgerufene Kunden-, Bestell- und Zahlungsdaten gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Unbeabsichtigte schreibende Aufrufe auf Produktivdaten, Weitergabe personenbezogener Kundendaten an den Modellanbieter und Missbrauch von Zugriffstoken beim lokalen Betrieb.