Tabby über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Tabby klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Tabby + Gemini

Tabby, Buy now, pay later (VAE, Saudi-Arabien, Kuwait): Zahlungen mit ihren Captures und Erstattungen nachschlagen, Checkout-Sessions, Kundenbeschwerden (Disputes) und Webhooks. Capture, Erstattung und Schließen sind enthalten, aber bei der Installation deaktiviert.

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:

TABBY_API_URL, TABBY_SECRET_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Tabby-Händlerkonto und dessen geheimen API-Key.

1. Melde dich im Tabby Merchant Dashboard an (merchant.tabby.ai für die VAE, merchant.tabby.sa für Saudi-Arabien), oder frag deinen Tabby-Partnermanager nach den API-Keys.
2. Kopiere den Secret Key in TABBY_SECRET_KEY: sk_test_... für Testzahlungen, sk_... für echte. Der Public Key (pk_...) funktioniert hier nicht.
3. Setz TABBY_API_URL auf die API deiner Händlerregion: https://api.tabby.ai für die VAE (und Kuwait), https://api.tabby.sa für Saudi-Arabien. Tabby erwartet jeden Aufruf in der Region des Händlers. Test und Live nutzen dieselbe Adresse; der Key entscheidet.
4. Installiere den Connector und rufe tabby_search_payments auf: Es listet deine neuesten Zahlungen und bestätigt den Key.

Zahlungs-ID und Bestellnummer: Eine Zahlungs-ID ist eine UUID, die Tabby vergibt; deine eigene Bestellnummer ist order.reference_id der Zahlung. Um eine Zahlung zu einer Bestellnummer zu finden, listet die KI mit tabby_search_payments die Zahlungen des Bestelldatums (created_from / created_to) und gleicht order.reference_id ab.

Was er liest: deine Zahlungen, neueste zuerst, mit Status, Betrag und Währung, Käufer (Name, E-Mail, Telefon), Bestellreferenz und Positionen, Captures und Erstattungen; eine Zahlung vollständig, mit Lieferadresse, Steuer, Versand, Rabatt und jedem Capture und jeder Erstattung mit Beträgen und Daten; Checkout-Sessions, wenn der Checkout eines Kunden nicht abgeschlossen wurde; Disputes von Kunden mit Grund, Kommentar, Anhängen, beanstandeten Positionen und den Tagen, bis sie automatisch genehmigt werden; und die Webhooks, die für einen Merchant-Code registriert sind (der Wert ihres Headers wird nicht zurückgegeben).

Zahlungsstatus: AUTHORIZED heißt, der Kunde hat zugestimmt und es ist noch nichts gecaptured; CLOSED heißt vollständig gecaptured oder geschlossen; REJECTED und EXPIRED heißen, dass kein Geld geflossen ist. Ohne Statusfilter liefert die Suche nur AUTHORIZED- und CLOSED-Zahlungen.

Bei der Installation deaktiviert: tabby_create_capture (captured eine AUTHORIZED-Zahlung ganz oder teilweise, wenn die Bestellung versendet wird), tabby_create_refund (erstattet eine CLOSED-Zahlung; das Geld geht sofort an den Kunden zurück und lässt sich nicht zurückholen) und tabby_close_payment (gibt frei, was nicht gecaptured ist, bei einer stornierten Bestellung oder nach einem Teil-Capture). Sie bewegen Geld, deshalb schaltet ein Administrator sie bewusst ein. Auch dann zeigt dir die KI Zahlung, Betrag und Währung und wartet auf dein Ja, und sie übergibt eine reference_id, damit eine Wiederholung nicht doppelt ausgeführt wird.

Beträge und Zeiten: Beträge sind Strings mit bis zu 2 Dezimalstellen (AED, SAR) oder 3 (KWD). Datum und Uhrzeit sind UTC, ISO 8601.

Limits: Die Zahlungssuche liefert höchstens 20 Zahlungen pro Aufruf, und die KI blättert mit offset weiter. Die Dispute-Liste liefert die 100 neuesten Disputes und blättert mit einem Token.

Häufige Fehler: 401 bedeutet einen falschen Secret Key oder einen Public Key; 400 mit leerem Body kann auch ein fehlender Key sein. 403 oder 404 bei einer Zahlung, die existiert, heißt meist, dass die Region in TABBY_API_URL falsch ist. 409 bei einer Erstattung bedeutet, dass die Zahlung noch nicht erstattbar ist (nicht CLOSED) oder der Betrag zu hoch ist.

Der Connector legt keine Checkout-Sessions an, ändert keine Zahlungen, registriert keine Webhooks und beantwortet keine Disputes; das erledigst du im Tabby Merchant Dashboard.

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 Gemini 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.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Tabby-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Tabby-Zahlungen wurden gestern angelegt, und welche davon sind noch AUTHORIZED und nicht gecaptured?“
• „Finde die Tabby-Zahlung zu unserer Bestellnummer 100245 und zeig ihre Captures und Erstattungen.“
• „Liste die offenen Disputes auf und wie viele Tage bei jedem bleiben, bis er automatisch genehmigt wird.“
• „Ein Kunde sagt, der Tabby-Checkout wurde nicht abgeschlossen: Prüf diese Checkout-Session und sag mir, was passiert ist.“
• „Erstatte 120 AED auf die Tabby-Zahlung der Bestellung 100245. Zeig mir vorher Zahlung und Betrag.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

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