Collegare Back Market MCP a Claude

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Back Market, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Back Market + Claude

API per venditori di Back Market per rigeneratori: ordini con accettazione e spedizione con tracciamento, elenchi con prezzo e disponibilità, prezzi di Backbox e concorrenti, categorie, cartelle e messaggi di assistenza clienti, consegne di BackShip e ordini di BuyBack. Token API, per piattaforma (Europa, Stati Uniti, Asia-Pacifico).

Prerequisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

BACK_MARKET_HOST, BACK_MARKET_TOKEN, BACK_MARKET_MARKET

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti.

1. Accedi al back office di Back Market della tua piattaforma: https://www.backmarket.fr/bo-seller (Europa), https://www.backmarket.com/bo-seller (Stati Uniti) o https://www.backmarket.co.jp/bo-seller (Giappone e Australia). L'accesso API è fornito con un account venditore validato da Back Market.
2. Apri la pagina Integrazioni sotto Opzioni e crea un token API.
3. Incolla il token come mostrato in BACK_MARKET_TOKEN, senza la parola Basic davanti: il connettore lo invia come Authorization: Basic seguito dal token.
4. Scegli la tua piattaforma in BACK_MARKET_HOST e il tuo mercato principale in BACK_MARKET_MARKET (ad esempio fr-fr per l'Europa, en-us per gli Stati Uniti, ja-jp per l'Asia-Pacifico). Il mercato deve appartenere alla piattaforma.

Ogni chiamata porta il mercato in Accept-Language e l'User-Agent BM-AnythingMCP-Connector, che Back Market richiede. Gli strumenti con un argomento market possono guardare un altro mercato della stessa piattaforma per una chiamata.

Dove iniziare: back_market_list_orders con stato 1 mostra ordini pagati le cui righe devi accettare, stato 3 gli ordini da spedire. back_market_list_listings mostra le tue offerte; back_market_list_backbox indica quali di esse detengono il Backbox.

Flusso di lavoro degli ordini: un ordine arriva nello stato 1 una volta che il pagamento è stato convalidato (non spedire mai negli stati 0, 8 o 10). Accetta ogni riga con back_market_accept_order_line (da stato 1 a 2); l'ordine poi passa allo stato 3. Spedisci con back_market_ship_order e un numero di tracciamento (tutte le righe vanno in un pacco, stato ordine 9). back_market_get_order mostra gli stati delle righe. back_market_set_order_line_identifiers memorizza l'IMEI o il numero di serie del dispositivo; non può essere corretto in seguito. back_market_cancel_order_line e back_market_refund_order_line sono installati disattivati: entrambi rimborsano il cliente e non possono essere annullati, e le cancellazioni pesano sul Backbox.

Elenchi: un elenco copre tutti i mercati della piattaforma. La quantità è condivisa; prezzo, commento e garanzia sono per mercato. back_market_get_listing trova un elenco per SKU; back_market_update_listing cambia prezzo o disponibilità in tempo reale (quantità 0 lo rende offline). back_market_import_listings (disattivato) invia un CSV per molti elenchi contemporaneamente e risponde con un id di attività per back_market_get_task. back_market_get_competitors mostra il prezzo necessario per vincere il Backbox per mercato. back_market_get_category_tree e back_market_get_category_branch forniscono le categorie e gli attributi di cui ha bisogno un nuovo prodotto.

Assistenza clienti: back_market_list_care_folders e back_market_get_care_folder leggono i casi post-vendita con i loro messaggi; back_market_send_care_message risponde al cliente. back_market_create_care_refund è installato disattivato.

BackShip e BuyBack: back_market_list_deliveries e back_market_list_returns restituiscono solo dati per i venditori che utilizzano le etichette di BackShip di Back Market. back_market_list_buyback_orders e back_market_get_buyback_order leggono gli ordini di scambio; convalidare o controbattere uno decide quanto viene pagato il cliente e non è incluso.

Formati: i prezzi sono stringhe decimali con tasse, nella valuta del mercato (160.99). Gli id degli ordini e degli ordini di riga sono interi; gli id degli elenchi sono UUID (l'id numerico listing_id è deprecato). Le date sono RFC 3339; i filtri delle cartelle di assistenza utilizzano YYYY-MM-DD-hh-mm. Le liste rispondono con count, next, previous e results; next è nullo nell'ultima pagina.

Limiti: più di 200 chiamate in 10 secondi sono bloccate per 10 secondi (chiamate di catalogo: 20 in 10 secondi), con un 429. Gli aggiornamenti degli elenchi sono limitati a circa 2.000 righe SKU all'ora. Le chiamate di assistenza hanno limiti giornalieri (lista cartelle 4.000 al giorno, rimborsi 500 al giorno).

Risposte 403: Back Market si trova dietro Cloudflare. Un 403 con una pagina HTML o il codice bot-need-challenge significa che il firewall ha bloccato il chiamante, non che il token è errato: invia il valore cf-ray della risposta al tuo contatto di Back Market. Un token errato o mancante risponde anch'esso con 403 o 401, con un errore JSON.

Passo 2 — Installa l'adattatore

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

Passo 3 — Aggiungi il connettore in Claude

L'URL del tuo server: in AnythingMCP, apri Server MCP → 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.

Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.

1. In Claude, apri Personalizza → Connettori.
2. Clicca su +, poi Aggiungi connettore personalizzato.
3. Inserisci un nome, ad esempio Back Market, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca su Aggiungi.
4. Clicca su Connetti e accedi a AnythingMCP (OAuth) per consentire l'accesso.

Tutti gli strumenti qui sotto appariranno nella tua chat: inizia a digitare i prompt.

Strumenti disponibili

Esempi di prompt

• "Quali ordini di Back Market hanno righe in attesa della mia accettazione?"
• "Quali dei miei elenchi hanno perso il Backbox e quale prezzo lo riporterà indietro?"
• "Imposta la disponibilità del mio elenco di iPhone 13 rigenerato da 128 GB a 12."
• "Spedisci l'ordine 41234567 con tracciamento Colissimo 6A12345678901 e l'IMEI di ogni riga."
• "Quali cartelle di assistenza clienti sono aperte e cosa chiedono i clienti?"

FAQ

Funziona sia con Claude Code che con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Dove posso ottenere il token API? Nel back office di Back Market della tua piattaforma, Opzioni, Integrazioni. Incolla il token come mostrato, senza la parola Basic, e scegli la tua piattaforma (Europa, Stati Uniti o Asia-Pacifico) e mercato principale. L'accesso API è fornito con un account venditore validato da Back Market.

Quali mercati copre? Ogni mercato della piattaforma su cui si trova il tuo account: i mercati europei su backmarket.fr, gli Stati Uniti su backmarket.com, e Giappone e Australia su backmarket.co.jp. Gli strumenti con un argomento di mercato possono guardare un altro mercato della stessa piattaforma.

Quali strumenti sono installati disattivati? back_market_cancel_order_line, back_market_refund_order_line, back_market_create_care_refund e back_market_import_listings, perché rimborsano i clienti o sostituiscono gli elenchi in blocco. Attivali nella pagina del connettore solo se l'IA deve usarli.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a ChatGPT
• Collegati a Cursor
• Collegati a Gemini
• Collegati a Meta Muse
• Collegati a Microsoft Copilot