Allegro über MCP mit Gemini 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 + Gemini

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

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

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