Clover über MCP mit Cursor verbinden

💡 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 + Cursor

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.

1. 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).
2. Füge das Token in CLOVER_API_TOKEN ein. Es wird als Authorization: Bearer <token> gesendet.
3. Setze CLOVER_MERCHANT_ID auf die 13-stellige Händler-ID (mId). Sie steht in der Adresse des Dashboards .../merchants/<mId>/... und unter Account and setup, Merchants.
4. Setze CLOVER_API_URL auf die Region des Händlers: https://api.clover.com (Nordamerika), https://api.eu.clover.com (Europa), https://api.la.clover.com (Lateinamerika) oder https://apisandbox.dev.clover.com (Sandbox).
5. Installiere den Connector und führe clover_get_merchant aus: 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 Cursor 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 Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Clover-Tools aufrufen.

Verfügbare Tools

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

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden