ITEN

Connettore Bonsai per Claude

Chiedi a Claude i dati del tuo Bonsai. Il connettore MCP Bonsai fa leggere a Claude gli stessi KPI e le stesse tabelle Amazon che vedi nel gestionale — dopo un login OAuth, senza password del database e senza far scegliere a Claude il cliente.

Cos'è

Bonsai è lo spazio di analytics per brand e agenzie che lavorano su Amazon. Questo connettore collega Claude al tuo account Bonsai. Claude legge dashboard e tabelle già presenti nel gestionale: Vendor, Advertising, Rank & Price, Seller, FBA, Feedback e salute catalogo. Non è un'integrazione Amazon SP-API di terze parti: Claude non chiama Amazon al posto tuo.

Il collegamento è lo stesso per tutti (https://<HOST_MCP>/mcp). Cambia solo chi sei dopo il login.

Cosa puoi chiedere

Aree disponibili (se i moduli corrispondenti sono attivi sul tuo account e i dati sono già nel gestionale):

  1. Piattaforma — stato del connettore, chi sei in sessione, elenco clienti ammessi, tenant attivo (agenzie).
  2. Amazon Vendor Analisi Standard — vendite, traffico, inventario, forecast, geo, sourcing esclusi.
  3. Amazon Vendor Analisi Advanced — strategic sales, Net PPM, catalog health, TCA, resi, vendor coverage.
  4. Amazon Ads — campagne, ad group, product ads, prodotti, keyword, search term, category benchmarks, conversion path, Brand Store.
  5. Rank & Price — Buy Box, prezzi, rank.
  6. Seller — report vendite, performance account.
  7. Brand Analytics — search terms.
  8. Listing Catalog Health.
  9. Feedback.
  10. FBA — rifornimenti, tariffe e stime.

Prima di collegare

Ti serve:

  • un account Bonsai attivo;
  • almeno un'azienda (tenant) con i moduli Amazon/analytics che vuoi interrogare già abilitati;
  • dati già presenti nel gestionale sul periodo che chiederai (il connettore non scarica Amazon al volo);
  • se lavori in agenzia: accesso Bonsai Agency e clienti in elenco consentito.

Permessi: vedi in Claude solo ciò che il tuo utente Bonsai può già vedere nel gestionale.

Come collegarlo

Dalla Directory Claude

  1. In Claude apri Customize → Connectors (o la Connectors Directory).
  2. Cerca Bonsai e connetti.
  3. Autorizza OAuth.
  4. Scegli Sono un'azienda oppure Sono un'agenzia.
  5. Completa il login Bonsai.

Come connettore personalizzato

  1. Claude → Customize → Connectors → Add custom connector.
  2. Incolla: https://<HOST_MCP>/mcp
  3. Collega e completa OAuth come sopra.

Stesso URL per tutti. Non esiste un indirizzo diverso per ogni cliente.

Login: azienda o agenzia

Sono un'azienda

Lavori su un solo gestionale. Inserisci il codice azienda se richiesto, poi accedi con email e password del gestionale Bonsai. Claude interrogherà solo quella azienda.

Sono un'agenzia

Accedi a Bonsai Agency. Vedi solo i clienti della tua organizzazione. Prima di chiedere i KPI, imposta il cliente attivo (es. "Elenca i miei tenant e imposta CODICE_CLIENTE"). I tool di analytics usano quel cliente; Claude non può puntare a un'azienda fuori elenco.

Come fare le domande

  • Date in YYYY-MM-DD (es. 2026-07-01).
  • Prima un riepilogo KPI, poi "mostra i prodotti/SKU" se ti servono le righe.
  • Per Net PPM, Catalog Health (Vendor Advanced) e TCA chiedi il dettaglio giornaliero, non il mese aggregato.
  • Se un modulo non è attivo o mancano i dati, Claude riceve un errore esplicito, non un dump del database.

Prompt di esempio

Sostituire le date con un periodo in cui il tuo account ha dati veri.

1. Verifica lo stato del connettore Bonsai.
2. Chi sono in questa sessione?
3. Dammi il riepilogo vendite Amazon Vendor Standard dal 2026-07-01 al 2026-07-31.
4. Mostra i primi prodotti/SKU di vendite Vendor Standard nello stesso periodo.
5. Qual è lo snapshot Vendor Coverage di oggi?
6. Riepilogo campagne Amazon Ads dal 2026-07-01 al 2026-07-31.
7. Situazione Buy Box Rank & Price sul periodo 2026-07-01 / 2026-07-31.
8. Riepilogo rifornimenti FBA nello stesso periodo.
9. (Solo agenzia) Elenca i tenant che posso usare e imposta CODICE_CLIENTE.

Cosa non fa

  • Non entra nel database e non chiede la password del database.
  • Non lascia scegliere a Claude l'URL del gestionale o un cliente libero.
  • Non scrive dati Vendor, Ads o Seller; non fa export di massa.
  • Non include Amazon Realtime.
  • Non è un plugin Claude né un'app MCP con interfaccia propria: è un server MCP remoto.
  • Non sostituisce il gestionale Bonsai: è un modo per interrogare in chat ciò che già c'è.

Privacy e sicurezza

Il connettore parte solo dopo il tuo consenso OAuth. Registriamo le invocazioni dei tool (quale tool, su quale azienda, quali filtri, esito) per audit e sicurezza, senza password né token nei log. Non raccogliamo la chat Claude.

Informativa completa: Privacy policy del connettore MCP.
Disconnessione: Claude → Connectors → disconnetti Bonsai. Per revoca accessi Bonsai: info@bonsaigrowth.it.

Supporto

Email: info@bonsaigrowth.it
Sito: https://www.bonsaigrowth.it

Se il connettore non si collega: verifica HTTPS, di aver completato OAuth e di usare l'URLhttps://<HOST_MCP>/mcp. Se i tool rispondono vuoto o con errore di modulo, controlla in Bonsai che i moduli siano attivi e che ci siano dati sul periodo chiesto.

Bonsai Srls · Via Francesco Ferrucci 100, 59100 Prato (PO), Italia · P.IVA IT02533060972 · info@bonsaigrowth.it