Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Square mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
Lass deine KI mit deinem Square-Geschäft arbeiten: Zahlungen, Erstattungen und Aufträge nachschlagen, Kunden verwalten, den Artikelkatalog durchsuchen und bearbeiten, Lagerbestände prüfen, Rechnungen erstellen und versenden und Standorte und Teammitglieder sehen. Sandbox oder Produktion, mit deinem eigenen Access-Token.
Frag einfach
Beispiel-Prompts für Square
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Square klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Square
Lass deine KI mit deinem Square-Geschäft arbeiten: Zahlungen, Erstattungen und Aufträge nachschlagen, Kunden verwalten, den Artikelkatalog durchsuchen und bearbeiten, Lagerbestände prüfen, Rechnungen erstellen und versenden und Standorte und Teammitglieder sehen. Sandbox oder Produktion, mit deinem eigenen Access-Token.
Einrichtung
- Melde dich unter developer.squareup.com/apps mit deinem Square-Konto an und klicke auf Create an application (der Name ist egal).
- Öffne die Anwendung und gehe zu Credentials. Mit dem Schalter oben wechselst du zwischen Sandbox und Production.
- Klicke beim Access token der gewünschten Umgebung auf Show, kopiere den Token und trage ihn ohne das Wort Bearer und ohne Leerzeichen in
SQUARE_ACCESS_TOKENein. - Setze
SQUARE_API_URLaufhttps://connect.squareupsandbox.comfür einen Sandbox-Token oder aufhttps://connect.squareup.comfür einen Production-Token, ohne Schrägstrich am Ende. Ein Token funktioniert nur in seiner eigenen Umgebung. - Installiere den Connector und starte
square_get_merchant: Das Tool zeigt Namen, Land und Währung des Unternehmens, das der Token erreicht.
Access-Token: Der Token auf der Seite Credentials ist ein persönlicher Access-Token mit vollem Zugriff auf dein eigenes Square-Konto, und genau den braucht der Connector. Er läuft nicht ab, aber wer ihn hat, kann im Namen deines Unternehmens handeln: Halte ihn geheim, und falls er in falsche Hände gerät, ersetze ihn auf derselben Seite und trage den neuen in SQUARE_ACCESS_TOKEN ein.
Sandbox und Production: Der Sandbox-Token gehört zu einem Standard-Testverkäufer, es geht dort also weder um echtes Geld noch um echte Kunden. Um die Ergebnisse aus Verkäufersicht zu sehen, öffne in der Developer Console Sandbox test accounts → das Konto → Square Dashboard. Die Sandbox verschickt nie Rechnungen per E-Mail; öffne stattdessen den öffentlichen Link der Rechnung.
Berechtigungen und Nur lesen: Der Token von der Seite Credentials hat immer vollen Zugriff, ein reiner Lesezugriff wird deshalb im Connector eingerichtet: Deaktiviere square_refund_payment, square_create_order, square_create_customer, square_update_customer, square_upsert_catalog_object, square_create_invoice, square_publish_invoice und square_cancel_invoice.
Bei der Installation ausgeschaltet: square_delete_customer, square_delete_catalog_object und square_delete_invoice. Schalte sie nur ein, wenn die KI Kundenprofile, Katalogobjekte (ein Artikel samt seinen Varianten) oder Rechnungsentwürfe (deren Auftrag dabei ebenfalls storniert wird) löschen soll.
Geld und Kunden-E-Mails: square_refund_payment zahlt Geld an den Kunden zurück und lässt sich nicht rückgängig machen, square_publish_invoice schickt die Rechnung per E-Mail an den Kunden und macht sie zahlbar, und square_cancel_invoice sperrt eine veröffentlichte Rechnung für Zahlungen und benachrichtigt den Kunden. Bevor die KI diese Tools aufruft, nennt sie Betrag, Kunde und IDs und wartet auf dein Ja. Genauso hält sie es, bevor sie einen bestehenden Katalogartikel mit square_upsert_catalog_object ändert.
Rechnungen: Eine Rechnung baut auf einem offenen Auftrag (Order) auf. Die KI legt den Auftrag mit square_create_order an (dabei wird nichts abgebucht) und dann mit square_create_invoice einen Entwurf; beim Kunden kommt erst mit square_publish_invoice etwas an. Für den Versand per E-Mail braucht das Kundenprofil eine E-Mail-Adresse.
Katalogänderungen ersetzen den ganzen Artikel: square_upsert_catalog_object ersetzt ein bestehendes Objekt komplett. Die KI liest den Artikel deshalb zuerst mit square_get_catalog_object und schickt die vollständige Kopie zurück; weggelassene Felder, auch Varianten, würden sonst gelöscht. Lagerbestände werden pro Artikelvariante und Standort geführt, nicht pro Artikel.
Standorte: Die meisten Daten gehören zu einem Standort, square_list_locations zeigt alle. Ohne Standortangabe liefert square_list_payments nur den Hauptstandort, und Rechnungen werden immer pro Standort aufgelistet. Offline erfasste Aufträge können bis zu 72 Stunden brauchen, bis sie erscheinen.
Häufige Fehler: 401 UNAUTHORIZED heißt, dass der Token falsch ist oder nicht zu SQUARE_API_URL passt (Sandbox-Token mit der Production-URL oder umgekehrt): Prüfe beides. 403 heißt, dass dem Token eine Berechtigung für den Aufruf fehlt; ein Token von der Seite Credentials hat vollen Zugriff, prüfe also, ob du genau diesen eingetragen hast. 400 VERSION_MISMATCH heißt, dass sich das Objekt inzwischen geändert hat und neu gelesen werden muss; andere 400-Antworten mit INVALID_REQUEST_ERROR nennen das fehlerhafte Feld. 404 NOT_FOUND heißt, dass die ID falsch ist oder das Objekt zu einem anderen Standort oder einer anderen Umgebung gehört. 429 RATE_LIMITED heißt, dass Square das Konto drosselt: Warte kurz und versuche es erneut.
Der Connector nimmt keine Kartenzahlungen entgegen und unterstützt keine Geschenkkarten, Treueprogramme, Terminbuchungen, Abonnements, Auszahlungen oder Webhooks.
Voraussetzungen: SQUARE_ACCESS_TOKEN, SQUARE_API_URL
Connector lokal installieren
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Öffne http://localhost:3000/connectors/store, wähle Square und trage die unter Voraussetzungen aufgelisteten Variablen ein.
Verfügbare Tools
| Tool | What it does |
|---|---|
square_get_merchant | Read the seller account behind the token: business name, country, currency, language, status and main_location_id |
square_list_locations | List the business locations: id, name, address, timezone, currency, status and capabilities |
square_get_location | Read one location by id, or the main location with "main": address, hours, currency, capabilities |
square_list_payments | List payments (newest first by default) with amount, status, card details, order and customer ids, refunds and receipt URL |
square_get_payment | Read one payment: amounts (total, tip, app fee, refunded), status (APPROVED, PENDING, COMPLETED, CANCELED, FAILED), source and card… |
square_list_refunds | List refunds (newest first by default) across all locations unless one is given: amount, status, reason, payment id |
square_get_refund | Read one refund: amount, status, reason, payment and order ids |
square_refund_payment | Refund a payment in full or in part |
square_search_orders | Search orders of 1 to 10 locations by state, dates, customers or source, with line items, totals, tenders and fulfillments |
square_get_order | Read one order: state, line items with modifiers, taxes and discounts, totals, tenders (payments), refunds and fulfillments |
square_create_order | Create an OPEN order, for example as the basis of an invoice |
square_list_customers | List customer profiles: id, names, company, email, phone, address, reference id, version |
square_search_customers | Search customer profiles by email, phone, reference id, creation or update time, or group |
square_get_customer | Read one customer profile with its current version, groups and preferences |
square_create_customer | Create a customer profile |
square_update_customer | Update a customer profile |
square_delete_customer | Delete a customer profile for good |
square_list_catalog | List catalog objects of the given types (100 per page): items with variations and prices, categories, taxes, discounts, modifier lists |
square_search_catalog_items | Search items by text (name, description, SKU, UPC), category, location, stock level or product type |
square_search_catalog_objects | Search any catalog objects (items, variations, categories, taxes, discounts...) by keywords, exact or prefix attribute values, or change… |
square_get_catalog_object | Read one catalog object by id with its version (needed to update it), optionally with the objects it references |
square_upsert_catalog_object | Create a catalog object, or REPLACE an existing one as a whole: fields left out (variations included) are removed, so for an update send… |
square_delete_catalog_object | Delete a catalog object for good; deleting an item also deletes its variations |
square_get_inventory_counts | Read inventory counts for many item variations and locations at once: quantity (a string) per state such as IN_STOCK, newest first |
square_get_inventory_count | Read the inventory count of one item variation, per location and state |
square_list_invoices | List the invoices of one location: id, number, status (DRAFT, UNPAID, SCHEDULED, PARTIALLY_PAID, PAID, CANCELED, ...), recipient, payment… |
square_search_invoices | Search the invoices of one location, optionally of one customer, sorted by invoice date |
square_get_invoice | Read one invoice: status, version (needed to publish or cancel), order, recipient, payment requests with computed amounts, public_url and… |
square_create_invoice | Create a DRAFT invoice for an OPEN order (make one with square_create_order) |
square_publish_invoice | Publish a draft invoice: Square sends it to the customer (EMAIL delivery) or makes it payable at public_url, and it can no longer be edited… |
square_cancel_invoice | Cancel a published invoice so it can no longer be paid; the customer is notified |
square_delete_invoice | Delete a DRAFT invoice; its order is canceled too |
square_search_team_members | Search team members by location, status or owner flag: id, names, email, phone, status, is_owner and assigned locations |
square_get_team_member | Read one team member: names, email, phone, status, owner flag and location assignments |
Beispiel-Prompts
- „Welche Zahlungen hatten wir gestern am Hauptstandort, und wurde davon etwas erstattet?“
- „Finde die Kundin [email protected] und zeig mir ihre Aufträge der letzten drei Monate.“
- „Wie viele Einheiten Espresso Blend 1 kg haben wir an jedem Standort auf Lager?“
- „Erstelle eine Rechnung an Acme GmbH über 3 Stunden Beratung zu je 90 EUR, fällig am 1. November, und zeig sie mir, bevor du sie verschickst.“
Nächste Schritte
War dieser Guide hilfreich?
