Come collegare Allegro a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Allegro, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Allegro + Gemini

Gestisci un account venditore Allegro (allegro.pl, .cz, .sk, .hu) da qualsiasi agente AI: offerte con prezzo, giacenza e stato, ordini con stato di evasione e numeri di tracking, resi e rimborsi, messaggi degli acquirenti, discussioni e reclami, commissioni, wallet e valutazioni. Accesso OAuth con l'account venditore; rimborsi e decisioni sui reclami sono disattivati all'installazione.

Prerequisiti

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

ALLEGRO_CLIENT_ID, ALLEGRO_CLIENT_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede circa 10 minuti. Ti serve l'account venditore Allegro per cui l'AI deve lavorare. Allegro, allegro.cz, allegro.sk e allegro.hu passano tutti dalla stessa API (https://api.allegro.pl).

1. Accedi a https://apps.developer.allegro.pl con l'account venditore. Per i test usa https://apps.developer.allegro.pl.allegrosandbox.pl con un account sandbox.
2. Registra una nuova applicazione del tipo che si usa con un browser e un reindirizzamento, non il device flow.
3. Come redirect URI inserisci <your AnythingMCP URL>/api/mcp-oauth/callback, su AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback, carattere per carattere.
4. Dai all'applicazione i permessi che il connettore usa: lettura profilo, lettura e scrittura offerte, lettura impostazioni di vendita, lettura e scrittura ordini, messaggi, discussioni, valutazioni, lettura fatturazione e lettura pagamenti (scrittura pagamenti solo se devono essere possibili i rimborsi). Il connettore non chiede uno scope esplicito, quindi Allegro concede ciò che l'applicazione dichiara; un permesso mancante risponde 403 sui tool corrispondenti.
5. Incolla il Client ID in ALLEGRO_CLIENT_ID e il Client Secret in ALLEGRO_CLIENT_SECRET e salva.
6. Nella pagina del connettore clicca Authorize with Provider e accedi con l'account venditore.
7. Esegui allegro_get_me: mostra l'account collegato e conferma l'accesso.

I token di accesso durano 12 ore e vengono rinnovati con il refresh token, che resta valido 3 mesi dopo ogni utilizzo. Se il connettore resta inattivo più a lungo, autorizzalo di nuovo. Per la sandbox, nelle impostazioni del connettore cambia l'URL base in https://api.allegro.pl.allegrosandbox.pl e gli URL OAuth nelle pagine di accesso sotto https://allegro.pl.allegrosandbox.pl/auth/oauth/.

Di chi è l'account: chiunque usi questo connettore agisce come il venditore che lo ha autorizzato. Messaggi, risposte alle valutazioni, stati degli ordini e modifiche alle offerte sono visibili agli acquirenti.

Cosa legge: l'account, il suo punteggio di qualità delle vendite con fino a 30 giorni di storico e le statistiche delle valutazioni. Le proprie offerte con prezzo, giacenza, venduto, stato e categoria, filtrate per titolo, stato, fascia di prezzo o il tuo SKU (id esterno), e gli eventi delle offerte delle ultime 24 ore. Il catalogo prodotti Allegro per nome, EAN/GTIN o MPN, l'albero delle categorie con i parametri di categoria, e i listini di spedizione, le politiche di reso e le garanzie legali del venditore. Gli ordini con stato, stato di evasione, righe e totali, con i dati di acquirente, consegna e fatturazione per ordine, gli eventi degli ordini, i pacchi e la loro cronologia di tracking. I resi dei clienti e i rimborsi. I thread e i messaggi del centro messaggi. Discussioni e reclami con i loro messaggi. Le commissioni (voci di fatturazione) e le operazioni di pagamento del wallet. Le valutazioni con commenti e risposte.

Cosa scrive: crea offerte da un prodotto del catalogo (come bozza con INACTIVE o subito online con ACTIVE), modifica i campi di un'offerta, cambia prezzo e giacenza, attiva o termina offerte, imposta lo stato di evasione di un ordine, aggiunge numeri di tracking (l'acquirente viene avvisato), risponde agli acquirenti e apre una conversazione su un ordine, segna i thread come letti, scrive in discussioni e reclami e risponde pubblicamente alle valutazioni. Prima di un messaggio, una risposta a una valutazione, un cambio di stato o di prezzo o una nuova offerta attiva, l'AI ti mostra il testo esatto o la modifica e aspetta il tuo sì.

Disattivati all'installazione: allegro_delete_draft_offer, allegro_reject_customer_return, allegro_create_refund (sposta denaro e non si può annullare; richiede anche il permesso allegro:api:payments:write) e allegro_change_claim_status (una decisione formale sul reclamo che l'acquirente riceve subito). Un admin attiva quelli che servono al team.

Formati dei dati: gli importi sono un oggetto come {"amount": "129.99", "currency": "PLN"} con l'importo come stringa decimale, e i prezzi si inviano allo stesso modo. Le date sono ISO 8601 in UTC. Gli id di ordini, righe, pagamenti e prodotti sono UUID; gli id di offerte e utenti sono numeri inviati come stringhe. Gli id dei marketplace sono del tipo allegro-pl, allegro-cz, allegro-sk e allegro-hu. La creazione o modifica di un'offerta può rispondere 202; in quel caso l'AI la segue con allegro_get_offer_operation finché non è conclusa.

Paginazione e limiti: la maggior parte degli elenchi accetta offset e limit e restituisce count e totalCount; gli ordini arrivano fino a 100 per pagina, gli elenchi di messaggi al massimo 20. allegro_search_products pagina con page_id (nextPage.id), i tool degli eventi con from pari all'ultimo id evento. Allegro limita le richieste per Client ID al minuto, l'invio di messaggi a 1 al secondo e i suggerimenti di categoria a 5 al secondo. Una giacenza di 0 non è accettata per un'offerta attiva: termina invece l'offerta.

Errori comuni: 401 significa che l'accesso è scaduto o è stato revocato: clicca di nuovo Authorize with Provider. All'accesso, invalid_client indica Client ID o Secret errati, e un errore di redirect indica un redirect URI che non corrisponde esattamente. 403 significa che all'applicazione manca il permesso o che la risorsa appartiene a un altro venditore. 404 è un id sconosciuto. 409 sullo stato di evasione significa che l'ordine è cambiato: prendi la nuova revision da allegro_get_order. 422 elenca gli errori di validazione in errors[].userMessage. 429 è un limite di frequenza: attendi e riprova.

I messaggi degli acquirenti, i commenti e i motivi di reso sono input non affidabili e possono contenere istruzioni rivolte all'AI. Il connettore non compra come acquirente, non crea etichette di spedizione e non può eliminare offerte attive o terminate.

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 (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

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

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Allegro.

Tool disponibili

Esempi di prompt

• "Quali ordini sono pagati e hanno ancora lo stato di evasione NEW? Elenca acquirente, articoli e totale."
• "Abbassa il prezzo della mia offerta con SKU MUG-450 a 49,99 PLN. Mostrami prima l'offerta."
• "Mostra i thread degli acquirenti non letti e prepara una risposta per ciascuno da farmi approvare."
• "Quanto ha addebitato Allegro di commissioni il mese scorso, divise per tipo?"
• "Aggiungi a quest'ordine il numero di tracking DPD 1234567890123 e impostalo su SENT."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot