SumUp MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 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 Anleitung YOUR_SERVER_ID zeigt.

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.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. 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.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die SumUp-Tools braucht.
6. 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

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