Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Clover 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
Clover-Kassensystem (Fiserv) für einen Händler: Geschäftsdaten und Einstellungen, Artikel mit Bestand, Kategorien, Steuersätze, Rabatte und Modifikatoren, Bestellungen mit Positionen, Zahlungen, Erstattungen und Zahlungsarten, Kunden, Mitarbeitende und Schichten. Er legt Artikel, Bestand, Kategorien, Bestellungen und Kunden an und ändert sie. Nordamerika, Europa, Lateinamerika oder Sandbox.
Frag einfach
Beispiel-Prompts für Clover
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 → Clover klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Clover + Microsoft Copilot
Clover-Kassensystem (Fiserv) für einen Händler: Geschäftsdaten und Einstellungen, Artikel mit Bestand, Kategorien, Steuersätze, Rabatte und Modifikatoren, Bestellungen mit Positionen, Zahlungen, Erstattungen und Zahlungsarten, Kunden, Mitarbeitende und Schichten. Er legt Artikel, Bestand, Kategorien, Bestellungen und Kunden an und ändert sie. Nordamerika, Europa, Lateinamerika oder Sandbox.
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:
CLOVER_API_TOKEN, CLOVER_MERCHANT_ID, CLOVER_API_URL
Schritt 1 — Zugangsdaten holen
Die Einrichtung dauert etwa 5 Minuten. Du brauchst ein Clover-Händlerkonto (oder einen Testhändler) und einen Admin, der API-Tokens anlegen darf.
- Melde dich als Admin im Clover Merchant Dashboard an und öffne Settings, View all settings, API tokens (unter Account and setup, Business operations). Lege ein Token an und hake die Rechte an, die die Tools brauchen: Merchant read, Inventory read und write, Orders read und write, Payments read, Customers read und write, Employees read. Für einen Testhändler machst du dasselbe im Global Developer Dashboard (Test merchants, Launch dashboard).
- Füge das Token in
CLOVER_API_TOKENein. Es wird alsAuthorization: Bearer <token>gesendet. - Setze
CLOVER_MERCHANT_IDauf die 13-stellige Händler-ID (mId). Sie steht in der Adresse des Dashboards.../merchants/<mId>/...und unter Account and setup, Merchants. - Setze
CLOVER_API_URLauf die Region des Händlers:https://api.clover.com(Nordamerika),https://api.eu.clover.com(Europa),https://api.la.clover.com(Lateinamerika) oderhttps://apisandbox.dev.clover.com(Sandbox). - Installiere den Connector und führe
clover_get_merchantaus: Es zeigt den Geschäftsnamen und bestätigt das Token.
Was er liest: den Händler mit clover_get_merchant, clover_get_merchant_address und clover_get_merchant_properties (Währung, Zeitzone, Locale, Trinkgeld- und Steuereinstellungen), Bestellarten und Rollen der Mitarbeitenden; Artikel mit clover_list_items und clover_get_item (Preis, Preistyp, SKU, Code, Einkaufspreis; per expand Kategorien, Steuersätze, Modifikatorgruppen oder Bestand), den Bestand mit clover_list_item_stocks und clover_get_item_stock, Kategorien mit clover_list_categories, clover_get_category und clover_list_category_items, dazu Steuersätze, vordefinierte Rabatte und Modifikatorgruppen; Bestellungen mit clover_list_orders und clover_get_order (expand lineItems und payments), ihre Positionen und Bestellrabatte; Zahlungen mit clover_list_payments, clover_get_payment, clover_list_order_payments und clover_list_employee_payments (praktisch für Trinkgeld und Umsatz pro Mitarbeiter), Erstattungen mit clover_list_refunds und clover_get_refund, Zahlungsarten (Tenders) mit clover_list_tenders und clover_get_tender; Kunden mit clover_list_customers und clover_get_customer (expand emailAddresses, phoneNumbers und addresses); Mitarbeitende mit clover_list_employees und clover_get_employee und Stempelzeiten mit clover_list_shifts und clover_list_employee_shifts.
Was er schreibt: Artikel mit clover_create_item und clover_update_item; den Bestand mit clover_update_item_stock, das eine absolute Menge setzt, keine Differenz, deshalb liest die KI zuerst den aktuellen Bestand; Kategorien mit clover_create_category und clover_update_category; Kunden mit clover_create_customer und clover_update_customer. Bestellungen in einem Aufruf: clover_calculate_order liefert Summen, Steuern, Rabatte und Servicegebühren, ohne zu speichern, danach legt clover_create_atomic_order denselben Warenkorb an. Schritt für Schritt: clover_create_order, clover_add_line_item, clover_add_order_discount und clover_update_order. Clover ändert einen Datensatz per POST an seine Adresse. Bestellungen und Bestandsänderungen erscheinen sofort auf den Geräten und in den Berichten des Händlers, deshalb zeigt dir die KI, was sie ändert, und wartet auf dein Ja.
Bei der Installation deaktiviert: clover_void_line_item, clover_delete_order und clover_delete_customer. Sie lassen sich nicht rückgängig machen, deshalb schaltet ein Workspace-Admin sie ein, wenn das Team sie braucht.
Filter: filter nimmt eine Liste von Bedingungen der Form feld operator wert, zum Beispiel ["createdTime>=1767225600000", "createdTime<1767830400000"]; sie werden mit UND verknüpft. Zeitfilter auf Bestellungen, Zahlungen und Erstattungen umfassen höchstens 90 Tage pro Anfrage, deshalb teilt die KI längere Zeiträume in 90-Tage-Fenster auf. expand holt verknüpfte Datensätze im selben Aufruf (kommagetrennt).
Datenformate: Listen kommen als {elements: [...], href}. Geldbeträge sind ganze Zahlen in Cent der Händlerwährung (1999 = 19,99); Rabatte sind negative Beträge. Mengen auf Positionen (unitQty) sind mit 1000 multipliziert. Steuersätze sind mit 100000 multipliziert (825000 = 8,25 %). Zeiten sind Unix-Epoch-Millisekunden in UTC; die KI rechnet sie mit der Zeitzone aus clover_get_merchant_properties um. IDs sind 13-stellige Zeichenketten.
Blättern: limit (Standard 100, höchstens 1000) und offset. Enthält eine Seite limit Elemente, fragt die KI mit offset plus limit erneut. Verschachtelte, per expand geladene Listen enden bei 100 Einträgen.
Limits und häufige Fehler: 16 Anfragen pro Sekunde und 5 gleichzeitige Anfragen pro Token; darüber antwortet Clover mit 429 und retry-after. 401 bedeutet ein falsches oder widerrufenes Token oder die falsche Region in CLOVER_API_URL (ein Sandbox-Token funktioniert nur auf apisandbox.dev.clover.com). 403 bedeutet, dass dem Token das Recht für diese Daten fehlt: Bearbeite das Token im Merchant Dashboard und hake es an. 404 bedeutet eine falsche Händler- oder Datensatz-ID. 400 bedeutet meist ein ungültiges Filterfeld.
Der Connector nimmt keine Kartenzahlungen an und erstattet nichts: Das geschieht am Clover-Gerät oder über die Clover Ecommerce API. Steuersätze, Rabatte, Modifikatorgruppen, Mitarbeitende und Schichten liest er nur, und mit den Tools, die bei der Installation aktiv sind, löscht er nichts.
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
Clover-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 |
|---|---|
clover_get_merchant | Get the merchant behind the token: business name, address, phone, website, owner and default currency |
clover_get_merchant_address | Get the business address of the merchant: street lines, city, state, zip and country, as stored in Clover |
clover_get_merchant_properties | Get merchant settings: default currency, time zone, locale, tips and tax settings, receipt and order options |
clover_list_order_types | List order types of the merchant (dine in, take out, delivery and custom ones) with label, taxable flag, fee and hours |
clover_list_roles | List the employee roles of the merchant (admin, manager, employee and custom roles) with their system role and employees |
clover_list_items | List inventory items with name, price, price type, SKU, code, cost, stock tracking and visibility |
clover_get_item | Get one inventory item by id with price, price type, SKU, code, cost and, when expanded, categories, tax rates, modifier groups and stock |
clover_create_item | Create an inventory item. price is in cents (1999 = 19.99) and required; priceType FIXED, VARIABLE (entered at sale) or PER_UNIT |
clover_update_item | Update an inventory item (Clover updates with POST): name, price in cents, SKU, code, cost, visibility or categories |
clover_list_item_stocks | List the stock of all inventory items: item id, quantity on hand (decimal) and the low-stock alert threshold |
clover_get_item_stock | Get the stock of one inventory item: quantity on hand, stock alert threshold and when it last changed |
clover_update_item_stock | Set the stock of an inventory item to a new absolute quantity (not a change) |
clover_list_categories | List item categories with name, sort order and colour; expand items to get the items in each category |
clover_get_category | Get one item category by id with name, sort order and colour; expand items to list its items |
clover_list_category_items | List the items in one category with price, SKU and, when expanded, stock, tax rates and modifier groups |
clover_create_category | Create an item category shown on the register, with a name, sort order and colour |
clover_update_category | Rename a category or change its sort order or colour (Clover updates with POST). name is required by the API |
clover_list_tax_rates | List tax rates with name, rate (in units of 1/100000, so 825000 = 8.25%), flat amount, type and whether it is the default |
clover_list_discounts | List the predefined discounts of the merchant: name, amount in cents (negative) or percentage |
clover_list_modifier_groups | List modifier groups (e.g |
clover_list_orders | List orders with state, total in cents, payment state, employee, order type and times |
clover_get_order | Get one order by id with total, state, payment state and, when expanded, line items, discounts, payments, refunds and customers |
clover_create_atomic_order | Create a complete order in one call from an order cart: line items (inventory items or ad hoc), modifiers, discounts and service charge… |
clover_calculate_order | Calculate an order cart without saving it: totals, taxes, discounts and service charges for the same cart as clover_create_atomic_order |
clover_create_order | Create an empty custom order (title, note, state, order type), then add lines with clover_add_line_item |
clover_update_order | Update an order (Clover updates with POST): title, note, state, order type or tax removal |
clover_list_order_line_items | List the line items of an order with name, price in cents, quantity, discounts, modifications and refund state |
clover_get_order_line_item | Get one line item of an order with name, price in cents, unit quantity, note, discounts and modifications |
clover_add_line_item | Add a line item to an order: an inventory item by id, or an ad hoc line with name and price in cents. unitQty is quantity x 1000 for… |
clover_void_line_item | Remove (void) a line item from an order |
clover_list_order_discounts | List the order-level discounts applied to an order with name, amount in cents or percentage and approver |
clover_add_order_discount | Apply a discount to a whole order: a name plus an amount in cents (negative, e.g. -500) or a percentage, or a predefined discount by id |
clover_delete_order | Delete an order |
clover_list_payments | List payments with amount, tip and tax in cents, result (SUCCESS, FAIL and so on), tender, card type, order and employee |
clover_get_payment | Get one payment by id with amount, tip, tax, cash back in cents, result, tender, card transaction details and refunds |
clover_list_order_payments | List the payments made on one order with amount, tip and tax in cents, result, tender and card details |
clover_list_employee_payments | List the payments taken by one employee, with amount, tip and tax in cents, result and tender |
clover_list_refunds | List refunds with amount and tax in cents, the payment and order they belong to, employee and time |
clover_get_refund | Get one refund by id with amount, tax and tip in cents, the refunded payment, line items and employee |
clover_list_tenders | List tenders (payment methods such as cash, credit card, debit card, check, gift card, external) with label, label key and whether enabled |
clover_get_tender | Get one tender (payment method) by id with label, label key, instructions and whether it opens the cash drawer |
clover_list_customers | List customers with name, customer since and marketing consent; expand emailAddresses, phoneNumbers and addresses for contact data |
clover_get_customer | Get one customer by id with name, customer since, marketing consent and, when expanded, emails, phone numbers, addresses and notes |
clover_create_customer | Create a customer with name, email addresses, phone numbers, addresses and marketing consent |
clover_update_customer | Update a customer (Clover updates with POST): name, marketing consent or metadata such as business name and note |
clover_delete_customer | Delete a customer with their contact data |
clover_list_employees | List employees with name, nickname, email, role, PIN-protected flags and custom id; expand roles or shifts |
clover_get_employee | Get one employee by id with name, nickname, email, role and, when expanded, roles and shifts |
clover_list_shifts | List clock-in and clock-out shifts of all employees with in time, out time and overrides |
clover_list_employee_shifts | List the clock-in and clock-out shifts of one employee with in time, out time and overrides, newest first |
Beispiel-Prompts
- „Wie hoch waren gestern unser Umsatz und das Trinkgeld, aufgeteilt nach Zahlungsart? Nimm unsere Zeitzone.“
- „Welche Artikel mit Bestandsführung haben weniger als 10 Stück übrig? Zeig Name, SKU und Menge.“
- „Setz den Preis des Artikels Cappuccino auf 4,20. Zeig mir alten und neuen Preis, bevor du speicherst.“
- „Berechne eine Bestellung mit 2 Pizza Margherita und 1 Limonade mit unserem Personalrabatt, zeig mir die Summe und leg sie dann an.“
- „Liste die Erstattungen der letzten 30 Tage mit Betrag, ursprünglicher Bestellung und Mitarbeiter auf.“
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?