SumUp MCP mit Gemini CLI verbinden

💡 Keine Installation? Nutze direkt cloud.anythingmcp.com. Melde dich an, klicke auf Connectors → SumUp, füge deine Zugangsdaten ein, erstelle einen MCP-API-Key — fertig. Kein Docker, kein git clone, kein lokaler Server.

SumUp + Gemini

Lies SumUp-Händlerkonten, Transaktionen, Auszahlungen, Checkouts, Belege, Kartenterminals, Teammitglieder und Subaccounts von jedem KI-Agenten aus. Nur lesend, mit Bearer-Token-Authentifizierung.

Voraussetzungen

Die vollständige Einrichtungsanleitung ist direkt im Connector enthalten (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

SUMUP_API_KEY

Schritt 1 — Zugangsdaten besorgen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein SumUp-Händlerkonto und einen API-Key dafür.

1. Melde dich im SumUp Dashboard unter https://me.sumup.com an.
2. Öffne Settings → For Developers (oder das Developer Portal).
3. Erzeuge einen API-Key (Personal Access Token) und füge ihn in SUMUP_API_KEY ein. Er wird bei jedem Aufruf als Bearer-Token gesendet.
4. Installiere den Connector und führe sumup_get_merchant_profile aus: Das Tool liefert den Merchant-Code, den Firmennamen, die Währung und das Land des Kontos hinter dem Key zurück – damit ist bestätigt, dass der Key funktioniert.

Was gelesen wird: das Händlerprofil; der Transaktionsverlauf, standardmäßig die neuesten zuerst, gefiltert nach Status (etwa SUCCESSFUL, CANCELLED oder FAILED) oder auf die Transaktionen, die seit einem ISO-8601-Zeitstempel geändert wurden, mit bis zu 100 pro Seite; eine einzelne Transaktion anhand ihrer ID oder ihres Transaktionscodes (etwa TD6Q7P2); die Auszahlungen auf dein Bankkonto zwischen zwei Daten (YYYY-MM-DD); die Online-Checkouts und Zahlungslinks, gefiltert nach deiner eigenen Checkout-Referenz; und die Operator-Subaccounts unter dem Hauptkonto.

Merchant-Code, Belege, Team und Kartenterminals: Die aktuellen Versionen der SumUp-API sprechen ein Konto über seinen Merchant-Code an, den sumup_get_merchant_profile liefert; erreicht der Key mehrere Konten, listet sumup_list_memberships sie auf, und sumup_get_merchant zeigt eines davon. Mit diesem Code liest die KI außerdem die Transaktionen und Auszahlungen über die aktuellen API-Versionen (Auszahlungen samt Abzügen wie Erstattungen und Rückbuchungen), den Beleg einer Transaktion, einen einzelnen Online-Checkout, die online angebotenen Zahlungsarten, gespeicherte Kunden und ihre tokenisierten Karten (nur die letzten vier Ziffern), die Mitglieder, eigenen Rollen und hinterlegten Personen (Inhaber, gesetzliche Vertreter) sowie die gekoppelten Kartenterminals mit ihrem Live-Status und dem an sie gesendeten Checkout. Die älteren Transaktions- und Auszahlungs-Tools bleiben für bestehende Setups erhalten. Ein 403 bedeutet, dass dem Nutzer des Keys in SumUp die Berechtigung für dieses Konto fehlt.

Nur lesend: Alle 26 Tools lesen ausschließlich. In deinem SumUp-Konto wird nichts verändert; Erstattungen, neue Checkouts, Zahlungen am Terminal und Änderungen an Mitgliedern erledigst du im SumUp Dashboard.

Schon installiert? Ein früher installierter Connector bekommt die neuen Tools über sein Katalog-Update: Öffne den Connector in AnythingMCP, prüfe unter Catalog update available die Liste der neuen Tools und klicke auf Apply update. Deine Zugangsdaten und selbst hinzugefügte Tools bleiben unverändert.

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 SumUp-Tools aufrufen.

Verfügbare Tools

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-Landingpage
• Mit Claude verbinden
• Mit ChatGPT verbinden