Was ist Square MCP Server?
Square, ein Teil von Block, hostet seinen MCP-Server unter https://mcp.squareup.com/mcp mit OAuth-Anmeldung; ein älterer /sse-Endpunkt wird weiter bedient. Nur freigegebene Clients können sich verbinden, als Schutz vor bösartiger Client-Registrierung, und die Dokumentation nennt Claude.ai, Claude Desktop, Goose, Cursor und Windsurf. Der gehostete Server erreicht nur Produktionsdaten, und das ganze Projekt trägt noch das Etikett Beta.
Für Tests in der Sandbox startest du den quelloffenen lokalen Server mit npx square-mcp-server start, einem ACCESS_TOKEN und SANDBOX=true. DISALLOW_WRITES=true macht ihn schreibgeschützt, und SQUARE_VERSION legt die API-Version fest. Das npm-Paket hat seit 0.1.2 vom 25. April 2025 kein Release mehr bekommen, auch wenn das README im Oktober 2026 überarbeitet wurde, um die meisten Nutzer zum gehosteten Server zu lenken.
Statt eines Tools pro Endpunkt gibt es drei: get_service_info, um die Methoden eines Service zu entdecken, get_type_info, um Details zu Parametern abzurufen, und make_api_request, um die API aufzurufen. Damit sind 38 Square-Services erreichbar, darunter Zahlungen, Erstattungen, Bestellungen, Katalog, Lagerbestand, Rechnungen, Auszahlungen, Arbeitszeit und Kundenbindung.
Square MCP Server installieren
https://mcp.squareup.com/mcpLohnt sich Square MCP Server?
Square geht denselben Weg wie die generischen Tools von Stripe: drei Tools, mit denen der Agent jeden der 38 Square-Services entdecken und aufrufen kann. Das hält die Tool-Liste klein, was hilft, wenn sich mehrere Server ein Kontextfenster teilen, und bedeutet, dass ein Händler nach Katalog, Bestellungen, Kunden oder Auszahlungen fragen kann, ohne auf ein eigens gebautes Tool zu warten.
Der Preis generischer Tools ist, dass das Modell die richtige Methode selbst finden und den Request-Body selbst zusammenbauen muss, und die offenen Issues zeigen, wo das schiefgeht. Issue #20 (April 2026) berichtet, dass make_api_request für Felder wie location_ids leere Arrays sendet, was die Bestellsuche bricht, und Pfadparameter nicht auflöst. Issue #31 (September 2026) argumentiert, dass die Beschreibung von CreatePayment das Modell anweist, bei jedem Aufruf einen neuen Idempotency Key zu erzeugen, sodass eine wiederholte Anfrage eine Karte doppelt belasten könnte. Issue #27 merkt an, dass die generischen Namen mit Tools anderer Server kollidieren, sodass ein Modell eine Zahlungsfrage manchmal an Stripe leitet.
Der gehostete Server erreicht nur die Produktion, was schlecht zu Squares eigenem Rat passt, Prompts zuerst in der Sandbox zu testen: Dafür musst du das lokale Paket mit einem Token betreiben, und den Schreibschutz DISALLOW_WRITES gibt es nur dort. Die Dokumentation nennt keine OAuth-Scopes für den gehosteten Server und veröffentlicht für den MCP-Endpunkt weder Rate Limits noch Bedingungen zur Datenaufbewahrung.
Für reine Lesefragen zum Geschäft eines Händlers, etwa die meistverkauften Artikel des letzten Monats oder überfällige Rechnungen, funktioniert das Design und kostet nichts über die normalen Square-Gebühren hinaus. Schreibvorgänge, die Zahlungen, Erstattungen oder Lagerbestand berühren, verdienen bei jedem Aufruf eine menschliche Freigabe, bis die Issues #20 und #31 geschlossen sind.
Wo es sich lohnt
Die Inhaberin eines Cafés mit zwei Standorten, das Square nutzt
Herausfinden, welche Gerichte und Getränke sich letzten Monat am besten verkauft haben und welche kaum
In Claude fragt der Agent Bestellungen und Katalog über make_api_request auf dem gehosteten Server ab. Keine zusätzliche Gebühr; jeden Aufruf freigeben, da dasselbe Tool auch schreiben kann. Scheitert eine Bestellsuche an location_ids, liegt das am offenen Bug #20, nicht am Prompt.
Ein Entwickler, der eine Square-Integration für einen Einzelhandelskunden baut
Unbekannte Square-Endpunkte mit Testdaten erkunden
npx square-mcp-server start mit SANDBOX=true und DISALLOW_WRITES=true starten; get_service_info und get_type_info dienen als interaktive API-Referenz. Kostenlos, und echtes Geld wird nicht berührt.
Bevor du dich festlegst
- Einrichtung
- https://mcp.squareup.com/mcp in einem freigegebenen Client (Claude.ai, Claude Desktop, Goose, Cursor oder Windsurf) hinzufügen und mit Square anmelden; die Konfiguration für Claude Desktop nutzt npx mcp-remote. Für die Sandbox npx square-mcp-server start mit ACCESS_TOKEN und SANDBOX=true starten.
- Integrationen
- Drei Tools: get_service_info und get_type_info zum schreibgeschützten Erkunden und make_api_request für Lese- und Schreibzugriffe auf 38 Services, darunter Zahlungen, Erstattungen, Bestellungen, Katalog, Lagerbestand, Rechnungen und Auszahlungen.
- Daten und Datenschutz
- Der gehostete Server arbeitet per OAuth mit echten Produktionsdaten; die Dokumentation nennt weder Scopes noch Aufbewahrungsbedingungen. Der lokale Server hält ein Access Token auf deinem Rechner und lässt sich mit DISALLOW_WRITES=true schreibschützen.
- Kosten im großen Maßstab
- Der Server ist unter Apache-2.0 kostenlos; für jede Zahlung, die er anlegt, gelten die üblichen Square-Bearbeitungsgebühren. Jede Operation braucht meist zwei oder drei Aufrufe (entdecken, Typ prüfen, dann anfragen), der Token-Verbrauch pro Aufgabe liegt also höher als bei eigens gebauten Tools; Rate Limits sind in der MCP-Dokumentation nicht veröffentlicht.
- Grenzen
- Beta; der gehostete Server ist nur für Produktion; offene Issues melden verlorene Array-Parameter (#20), das Risiko doppelter Belastung bei wiederholten Zahlungen (#31) und Kollisionen von Tool-Namen mit anderen Servern (#27).
Was gut ist
- Erreicht 38 Square-Services über drei Tools
- Gehosteter OAuth-Server mit Liste freigegebener Clients
- Schreibschutz und Sandbox-Unterstützung im lokalen Server
- Kleine Tool-Liste lässt im Kontext Platz für andere Server
Was nicht
- Beta, mit einem npm-Paket, das seit April 2025 unverändert ist
- Gehosteter Server nur für Produktion, ohne Schreibschutz-Schalter
- Offene Bugs: verlorene Array-Parameter, Formulierung zur Idempotenz mit Risiko doppelter Belastungen
- Generische Tool-Namen kollidieren mit anderen Servern
Am besten für
Square-Händler und -Entwickler, die einen Assistenten Verkaufs-, Bestell- und Katalogdaten abfragen lassen wollen.
Alternativen zu Square MCP Server
Square MCP Server: häufige Fragen
- Lohnt sich Square MCP Server?
- Die gesamte API von Square hinter drei Tools: clever zum Lesen von Verkaufsdaten, riskant für alles, was Geld bewegt, solange die Beta-Bugs offen sind. Wir bewerten es mit 3.6 von 5.
- Was kostet Square MCP Server?
- Kostenlos und Open Source (Apache-2.0); die normalen Square-Gebühren fallen an.
- Welche Nachteile hat Square MCP Server?
- Beta, mit einem npm-Paket, das seit April 2025 unverändert ist; Gehosteter Server nur für Produktion, ohne Schreibschutz-Schalter; Offene Bugs: verlorene Array-Parameter, Formulierung zur Idempotenz mit Risiko doppelter Belastungen; Generische Tool-Namen kollidieren mit anderen Servern.
- Für wen eignet sich Square MCP Server?
- Square-Händler und -Entwickler, die einen Assistenten Verkaufs-, Bestell- und Katalogdaten abfragen lassen wollen.
- Was kostet Square MCP Server für ein Team oder im Produktivbetrieb?
- Der Server ist unter Apache-2.0 kostenlos; für jede Zahlung, die er anlegt, gelten die üblichen Square-Bearbeitungsgebühren. Jede Operation braucht meist zwei oder drei Aufrufe (entdecken, Typ prüfen, dann anfragen), der Token-Verbrauch pro Aufgabe liegt also höher als bei eigens gebauten Tools; Rate Limits sind in der MCP-Dokumentation nicht veröffentlicht.
- Ist Square MCP Server sicher für Firmendaten?
- Der gehostete Server arbeitet per OAuth mit echten Produktionsdaten; die Dokumentation nennt weder Scopes noch Aufbewahrungsbedingungen. Der lokale Server hält ein Access Token auf deinem Rechner und lässt sich mit DISALLOW_WRITES=true schreibschützen.
- Was sind die besten Alternativen zu Square MCP Server?
- Die nächsten Alternativen, die wir getestet haben, sind Stripe MCP, PayPal MCP Server und Shopify Dev MCP.
Antworten geprüft am 23. Okt. 2026.