ManoMano su MCP: gestisci il tuo account venditore ManoMano da qualsiasi agente AI

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

ManoMano

Vendi su ManoMano, il marketplace europeo del fai da te e del giardinaggio, da un agente AI: ordini con accettazione, spedizione e rimborsi, prezzi e stock delle offerte, competitività rispetto agli altri venditori, ricerca nel catalogo per EAN, stock ManoFulfillment e fatture ai clienti. Un'installazione per ogni contratto venditore.

Setup

1. Accedi alla ManoMano Toolbox su https://toolbox.manomano.com con un utente che ha il ruolo Admin.
2. Apri Settings > API keys, clicca su Create API key, dagli un nome come AnythingMCP e clicca su Generate API key. Copia subito la chiave: ManoMano la mostra una sola volta. Incollala in MANOMANO_API_KEY.
3. Inserisci l'id del tuo contratto venditore in MANOMANO_SELLER_CONTRACT_ID. È un numero che trovi nella Toolbox, per esempio 110841.
4. Installa il connettore e inizia con manomano_list_orders.

Un'installazione per contratto: ManoMano crea un contratto venditore per ogni piattaforma (manomano.fr, .es, .it, .de e .co.uk) e modalità di consegna, quindi chi vende su più piattaforme ha più contratti. Installa il connettore una volta per contratto e dai a ogni installazione il nome del contratto, per esempio ManoMano IT. L'id del contratto viene aggiunto a ogni chiamata e la chiave viene inviata solo a ManoMano.

Flusso degli ordini: un nuovo ordine è PENDING. Se lo accetti passa a PREPARATION; se lo rifiuti il cliente viene rimborsato (REFUNDING, poi REFUSED). La spedizione registra corriere, numero e URL di tracciamento e i prodotti del pacco, una volta per pacco, e l'ordine diventa SHIPPED. Un rimborso riguarda alcuni o tutti i prodotti (REFUNDING, poi REFUNDED). Per la lista delle cose da fare ogni giorno, l'AI elenca gli ordini in PENDING e in PREPARATION, e legge l'ordine prima di spedirlo o rimborsarlo, perché entrambe le operazioni richiedono il seller_sku e la quantità di ogni prodotto.

Conferma prima: accettare, rifiutare, spedire e rimborsare ordini, modificare, sbloccare e sostituire offerte e caricare fatture agiscono sul marketplace reale. Prima di ognuna di queste azioni l'AI ti mostra cosa cambierà (l'ordine, i prodotti e le quantità, il numero di tracciamento, gli SKU con prezzo o stock vecchio e nuovo, il documento) e aspetta il tuo sì. Rifiuti e rimborsi non si possono annullare.

Prezzi e stock: manomano_update_offers cambia il prezzo, lo stock o entrambi degli SKU esistenti. Per impostazione predefinita i nuovi valori vengono bloccati, così le importazioni successive del feed prodotti non li sovrascrivono più, finché manomano_unfreeze_offers non li restituisce al feed. ManoMano applica la modifica in background: l'AI la verifica con manomano_list_offers e il request_id restituito (IN PROGRESS, ERROR con gli errori, oppure COMPLETED). manomano_upsert_offers, che crea offerte o le sostituisce completamente, è disattivato all'installazione.

Concorrenza, catalogo e fulfillment: confronta gli SKU che scegli con la migliore offerta sul prodotto, oppure elenca tutte le offerte la cui situazione competitiva è cambiata in un intervallo di date. Controlla fino a 200 EAN alla volta per sapere se un prodotto è già nel catalogo ManoMano e se puoi pubblicarci un'offerta. Lo stock nel magazzino ManoFulfillment è disponibile solo con un contratto ManoFulfillment.

Fatture ai clienti: l'AI elenca le fatture che i clienti stanno aspettando, a partire dalla richiesta più vecchia. Hai 3 giorni lavorativi dalla spedizione per fornirla. L'AI carica il PDF da un URL; ogni documento si aggiunge ai precedenti e il cliente riceve una notifica.

Limiti: circa 250 richieste all'ora sulle API degli ordini e 200 su quelle delle offerte, per chiave API; oltre questa soglia ManoMano risponde 429. Gli ordini arrivano in pagine di massimo 50. Il connettore lavora sull'API reale, non sulla sandbox di ManoMano.

Errori comuni: 401 significa che ManoMano ha rifiutato la chiave: controllala o creane una nuova nella Toolbox (una chiave eliminata smette subito di funzionare). 403: la chiave funziona ma non può agire su questo contratto; verifica che l'id del contratto appartenga all'account venditore che ha creato la chiave. 400: verifica che l'id del contratto sia il tuo id numerico di contratto venditore. 429: troppe richieste; aspetta prima di riprovare.

Prerequisiti: MANOMANO_API_KEY, MANOMANO_SELLER_CONTRACT_ID

Installazione locale del connettore

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

Apri http://localhost:3000/connectors/store, scegli ManoMano e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quali ordini ManoMano sono ancora in attesa, e quali ordini in preparazione hanno più di due giorni?"
• "Spedisci l'ordine M240915123 con BRT, numero di tracciamento 123456789012, tutti i prodotti in un solo pacco."
• "Porta il prezzo dello SKU DRILL-18V a 89,90 euro e lo stock a 25, poi controlla che l'aggiornamento sia andato a buon fine."
• "Per questi cinque SKU sono io la migliore offerta su ManoMano? Mostrami chi mi batte e a che prezzo."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT