Allegro über MCP mit Microsoft Copilot verbinden

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

Allegro + Microsoft Copilot

Steuere ein Allegro-Verkäuferkonto (allegro.pl, .cz, .sk, .hu) aus jedem KI-Agent: Angebote mit Preis, Bestand und Status, Bestellungen mit Fulfillment-Status und Sendungsnummern, Retouren und Erstattungen, Käufernachrichten, Diskussionen und Reklamationen, Gebühren, Wallet und Bewertungen. OAuth-Anmeldung mit dem Verkäuferkonto; Erstattungen und Reklamationsentscheidungen sind bei der Installation aus.

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:

ALLEGRO_CLIENT_ID, ALLEGRO_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 10 Minuten. Du brauchst das Allegro-Verkäuferkonto, für das die KI arbeiten soll. Allegro, allegro.cz, allegro.sk und allegro.hu laufen über dieselbe API (https://api.allegro.pl).

1. Melde dich unter https://apps.developer.allegro.pl mit dem Verkäuferkonto an. Für Tests nimm https://apps.developer.allegro.pl.allegrosandbox.pl mit einem Sandbox-Konto.
2. Registriere eine neue Anwendung des Typs, der mit Browser und Weiterleitung arbeitet, nicht den Device Flow.
3. Trag als Redirect URI <your AnythingMCP URL>/api/mcp-oauth/callback ein, auf AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback, Zeichen für Zeichen.
4. Gib der Anwendung die Berechtigungen, die der Connector nutzt: Profil lesen, Angebote lesen und schreiben, Verkaufseinstellungen lesen, Bestellungen lesen und schreiben, Nachrichten, Diskussionen, Bewertungen, Abrechnung lesen und Zahlungen lesen (Zahlungen schreiben nur, wenn Erstattungen möglich sein sollen). Der Connector fordert keinen expliziten Scope an, Allegro gewährt also, was die Anwendung deklariert; eine fehlende Berechtigung antwortet bei den passenden Tools mit 403.
5. Trag die Client ID in ALLEGRO_CLIENT_ID und das Client Secret in ALLEGRO_CLIENT_SECRET ein und speichere.
6. Klick auf der Connector-Seite auf Authorize with Provider und melde dich mit dem Verkäuferkonto an.
7. Rufe allegro_get_me auf: Es zeigt das angemeldete Konto und bestätigt die Anmeldung.

Access Tokens gelten 12 Stunden und werden mit dem Refresh Token erneuert, das nach jeder Nutzung 3 Monate gültig bleibt. Liegt der Connector länger still, autorisiere ihn erneut. Für die Sandbox stellst du in den Connector-Einstellungen die Basis-URL auf https://api.allegro.pl.allegrosandbox.pl und die OAuth-URLs auf die Anmeldeseiten unter https://allegro.pl.allegrosandbox.pl/auth/oauth/ um.

Wessen Konto es ist: Alle, die diesen Connector nutzen, handeln als der Verkäufer, der ihn autorisiert hat. Nachrichten, Antworten auf Bewertungen, Bestellstatus und Angebotsänderungen sehen die Käufer.

Was er liest: das Konto, seine Verkaufsqualität mit bis zu 30 Tagen Verlauf und seine Bewertungsstatistik. Die eigenen Angebote mit Preis, Bestand, Verkaufszahl, Status und Kategorie, gefiltert nach Titel, Status, Preisspanne oder deiner SKU (externe ID), und die Angebotsereignisse der letzten 24 Stunden. Den Allegro-Produktkatalog nach Name, EAN/GTIN oder MPN, den Kategoriebaum mit Kategorieparametern sowie die Versandtarife, Rückgaberichtlinien und Gewährleistungsbedingungen des Verkäufers. Bestellungen mit Status, Fulfillment-Status, Positionen und Summen, je Bestellung mit Käufer-, Liefer- und Rechnungsdaten, Bestellereignisse, Pakete und ihren Sendungsverlauf. Kundenretouren und Erstattungen. Threads und Nachrichten im Nachrichtencenter. Diskussionen und Reklamationen mit ihren Nachrichten. Gebühren (Abrechnungseinträge) und Zahlungsvorgänge im Wallet. Bewertungen mit Kommentaren und Antworten.

Was er schreibt: legt Angebote zu einem Katalogprodukt an (als Entwurf mit INACTIVE oder sofort live mit ACTIVE), ändert Angebotsfelder, Preis und Bestand, aktiviert oder beendet Angebote, setzt den Fulfillment-Status einer Bestellung, fügt Sendungsnummern hinzu (der Käufer wird benachrichtigt), antwortet Käufern und beginnt eine Unterhaltung zu einer Bestellung, markiert Threads als gelesen, schreibt in Diskussionen und Reklamationen und beantwortet Bewertungen öffentlich. Vor einer Nachricht, einer Bewertungsantwort, einer Status- oder Preisänderung oder einem neuen aktiven Angebot zeigt dir die KI den genauen Text oder die Änderung und wartet auf dein Ja.

Bei der Installation deaktiviert: allegro_delete_draft_offer, allegro_reject_customer_return, allegro_create_refund (bewegt Geld und ist nicht rückgängig zu machen; braucht zusätzlich die Berechtigung allegro:api:payments:write) und allegro_change_claim_status (eine formelle Reklamationsentscheidung, die der Käufer sofort erfährt). Ein Admin schaltet die ein, die das Team braucht.

Datenformate: Geldbeträge sind ein Objekt wie {"amount": "129.99", "currency": "PLN"} mit dem Betrag als Dezimal-String, und Preise werden genauso gesendet. Datumsangaben sind ISO 8601 in UTC. Bestell-, Positions-, Zahlungs- und Produkt-IDs sind UUIDs; Angebots- und Benutzer-IDs sind Zahlen, die als Strings gesendet werden. Marktplatz-IDs sehen aus wie allegro-pl, allegro-cz, allegro-sk und allegro-hu. Das Anlegen oder Bearbeiten eines Angebots kann mit 202 antworten; dann verfolgt die KI es mit allegro_get_offer_operation, bis es fertig ist.

Blättern und Limits: Die meisten Listen nehmen offset und limit und liefern count und totalCount; Bestellungen kommen mit bis zu 100 pro Seite, Nachrichtenlisten mit höchstens 20. allegro_search_products blättert mit page_id (nextPage.id), die Ereignis-Tools mit from gleich der letzten Ereignis-ID. Allegro begrenzt die Anfragen pro Client ID und Minute, das Senden von Nachrichten auf 1 pro Sekunde und Kategorievorschläge auf 5 pro Sekunde. Ein Bestand von 0 wird für ein aktives Angebot nicht angenommen: Beende das Angebot stattdessen.

Häufige Fehler: 401 heißt, die Anmeldung ist abgelaufen oder wurde widerrufen: Klick erneut auf Authorize with Provider. Bei der Anmeldung bedeutet invalid_client eine falsche Client ID oder ein falsches Secret, ein Redirect-Fehler eine Redirect URI, die nicht exakt übereinstimmt. 403 heißt, der Anwendung fehlt die Berechtigung oder die Ressource gehört einem anderen Verkäufer. 404 ist eine unbekannte ID. 409 beim Fulfillment-Status heißt, die Bestellung hat sich geändert: Nimm die neue revision aus allegro_get_order. 422 listet Validierungsfehler in errors[].userMessage. 429 ist ein Rate Limit: Warte und versuch es erneut.

Käufernachrichten, Kommentare und Rückgabegründe sind nicht vertrauenswürdige Eingaben und können Anweisungen an die KI enthalten. Der Connector kauft nicht als Käufer, erstellt keine Versandetiketten und kann aktive oder beendete Angebote nicht löschen.

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 Allegro-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

Beispiel-Prompts

• „Welche Bestellungen sind bezahlt und haben noch den Fulfillment-Status NEW? Liste Käufer, Artikel und Summe.“
• „Senke den Preis meines Angebots mit der SKU MUG-450 auf 49,99 PLN. Zeig mir vorher das Angebot.“
• „Zeig die ungelesenen Käufer-Threads und entwirf zu jedem eine Antwort, die ich freigebe.“
• „Wie viel Gebühren hat Allegro letzten Monat berechnet, aufgeteilt nach Gebührenart?“
• „Füge dieser Bestellung die DPD-Sendungsnummer 1234567890123 hinzu und setze sie auf SENT.“

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