Kaufland MCP con Gemini CLI: ordini e stock

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Kaufland Marketplace, inserisci le credenziali, genera una MCP API key — fatto. Niente Docker, niente git clone, niente server locale.

Kaufland Marketplace + Gemini

Kaufland Marketplace (ex real.de) seller API: ordini e le loro unità, storefront, unità, ticket e magazzini. Richieste firmate con HMAC: la firma copre il metodo, l'URL, il body e un timestamp.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

KAUFLAND_CLIENT_KEY, KAUFLAND_SECRET_KEY

Step 1 — Ottieni le credenziali

Getting credentials

1. You must already be a Kaufland Marketplace seller. In the Seller Portal open Settings → API keys and create a key pair.
2. You receive a Client Key (public, identifies you) and a Secret Key (never sent — it signs the request). Set KAUFLAND_CLIENT_KEY and KAUFLAND_SECRET_KEY.

The secret never travels. Kaufland does not accept a bearer token: every request carries Shop-Client-Key, Shop-Timestamp and Shop-Signature, where the signature is an HMAC-SHA256 over the canonical string

<METHOD>\n<FULL URL INCLUDING QUERY>\n<BODY>\n<UNIX TIMESTAMP>

…(continued in the in-app connector instructions)

Ticket, resi e tracking: oltre all'elenco dei ticket, il connettore legge un singolo ticket con la sua conversazione e i messaggi più recenti di tutti i ticket, ed elenca i resi e gli articoli resi uno per uno con stato e motivo, per esempio quelli arrivati che aspettano una tua decisione. Due strumenti scrivono, ed entrambi sono attivi all'installazione: kaufland_add_ticket_message invia la tua risposta all'acquirente nel ticket, e kaufland_add_tracking_to_order_unit aggiunge il codice del corriere e il numero di tracking a un'unità d'ordine già segnata come spedita, così l'acquirente può seguire il pacco. L'AI ti mostra esattamente cosa verrà inviato e aspetta il tuo sì prima di ciascuna chiamata. Se vuoi che il connettore legga soltanto, disattiva entrambi dalla pagina del connettore.

Già installato? I nuovi strumenti arrivano a un connettore installato in precedenza tramite il suo aggiornamento di catalogo: apri il connettore in AnythingMCP e, sotto Catalog update available, controlla l'elenco dei nuovi strumenti e clicca Apply update. Le tue credenziali e gli strumenti che hai aggiunto tu restano come sono.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (o %APPDATA%\gemini\settings.json su Windows). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Ottieni la tua MCP API key da AnythingMCP → MCP Servers → il tuo server → API keys.
2. Salva il file e riavvia gemini.
3. Esegui /mcp nella Gemini CLI — Kaufland Marketplace dovrebbe essere elencato come disponibile.
4. Vertex AI Studio: passa https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID nell'array tools della richiesta con lo stesso header X-API-Key.

Tool disponibili

FAQ

Gemini 1.5 Pro o 2.x supportano MCP? Sì — Gemini CLI ≥ 0.4 e la Vertex AI tools API accettano connettori MCP httpUrl con header personalizzati.

Prossimi passi

• Pagina del connettore
• Collega a Claude
• Collega a ChatGPT
• Collega a Cursor
• Collega a Meta Muse
• Collega a Microsoft Copilot