BricoBravo über MCP mit Gemini verbinden

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

BricoBravo + Gemini

Verkaufe auf BricoBravo, dem italienischen Marktplatz für Heimwerken und Wohnen, aus einem KI-Agent: Bestellungen mit Artikeln, Summen, Kunde und Lieferadresse, gefiltert nach Datum. Den Versand mit Versanddienstleister und Tracking bestätigen ist enthalten, bei der Installation aber 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:

BRICOBRAVO_API_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert ein paar Minuten, sobald du den Token hast. Du brauchst ein Verkäuferkonto bei BricoBravo, dem italienischen Marktplatz für Heimwerken, Wohnen und Garten, und den API-Token seines Seller Hub.

1. Hol dir den API-Token deines Shops bei BricoBravo: im Seller Hub unter sellerhub.bricobravo.com oder beim Verkäufer-Support von BricoBravo.
2. Füge ihn in BRICOBRAVO_API_TOKEN ein. Er wird im Header sh-token gesendet, also schreib nicht Bearer davor.
3. Installiere den Connector und rufe bricobravo_search_orders mit per_page 1 auf. Kommt eine Bestellung zurück, oder bei einem ganz neuen Shop eine leere Liste, funktioniert der Token.

Was er liest: deine BricoBravo-Bestellungen mit Seller-Hub-ID und Marktplatz-Bestellnummer, Status, Summe, Erstellungsdatum, Artikeln (EAN, Produktcode, Name, Preis, Listenpreis, Menge), Rechnungsdaten und den Versanddaten von Kunde und Empfänger (Name, E-Mail, Telefon, Straße, Postleitzahl, Ort, Provinz, Land). Die KI filtert Bestellungen nach Erstellungszeit und blättert durch die Seiten, standardmäßig 100 pro Seite.

Zwei Bestellnummern: Jede Bestellung hat eine Seller-Hub-ID (id_order) und eine Marktplatznummer wie 1234460505385-01. Um eine einzelne Bestellung zu lesen, braucht die KI die Seller-Hub-ID; mit der Marktplatznummer antwortet BricoBravo mit einer Fehlerliste statt der Bestellung. Hast du nur die Marktplatznummer, sucht die KI die Bestellung zuerst in der Liste.

Status und Zeiten: 0 bezahlt (zu versenden), 1 abgeschlossen, 2 zu erstatten, 3 erstattet. Zeiten sind italienische Ortszeit.

Schon importierte Bestellungen: Der Connector fragt alle Bestellungen ab, auch die, die ein Warenwirtschaftssystem schon übernommen hat, damit keine in der Liste fehlt.

Bei der Installation deaktiviert: bricobravo_mark_shipped. Es bestätigt den Versand einer echten Kundenbestellung mit Versanddienstleister, Trackingnummer und Tracking-URL; bei einer schon versendeten Bestellung ersetzt ein erneuter Aufruf die Trackingdaten, etwa nach einem zweiten Versand. Zur Auswahl stehen unter anderem BRT, GLS Italy, SDA, Poste Italiane, TNT, DHL, UPS, FedEx und DPD. Bestätigt schon dein Warenwirtschaftssystem die Sendungen, nutz es nur für Korrekturen. Ein Administrator schaltet es bewusst ein, und auch dann zeigt dir die KI Bestellung, Versanddienstleister und Tracking, wartet auf dein Ja und liest die Bestellung danach zur Kontrolle noch einmal.

Häufige Fehler: 401 token NOT valid bedeutet einen falschen oder widerrufenen Token: Bitte BricoBravo um einen neuen. 404 heißt, dass BricoBravo den Pfad oder die Bestellung nicht kennt.

Der Connector erstattet und storniert keine Bestellungen, ändert keine Produkte, Preise oder Bestände und beantwortet keine Kundenanfragen.

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

Verfügbare Tools

Beispiel-Prompts

• „Welche BricoBravo-Bestellungen sind bezahlt, aber noch nicht versendet?“
• „Zeig mir die BricoBravo-Bestellungen der letzten 7 Tage mit Summe und Lieferprovinz.“
• „Such die Bestellung 1234460505385-01 und sag mir, was der Kunde gekauft hat und wohin sie geht.“
• „Welche Bestellungen warten gerade auf eine Erstattung?“
• „Wie viel haben wir im September auf BricoBravo verkauft, und welches Produkt ging am häufigsten weg?“

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