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.
Geführte Einrichtung
Square in 2 Minuten mit Microsoft Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Square in der geführten Einrichtung und trag deine MCP-URL in Microsoft Copilot ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
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 + Microsoft Copilot
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.
Voraussetzungen
Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:
SQUARE_ACCESS_TOKEN, SQUARE_API_URL
Schritt 1 — Zugangsdaten holen
- 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.
Schritt 2 — Adapter 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
Schritt 3 — Connector in Microsoft Copilot hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
Square-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.
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.“
FAQ
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
- Connector-Startseite
- Mit Claude verbinden
- Mit ChatGPT verbinden
- Mit Cursor verbinden
- Mit Gemini verbinden
- Mit Meta Muse verbinden
War dieser Guide hilfreich?