ITEN

Connettore MCP Bonsai per ChatGPT

Il connettore MCP Bonsai permette a ChatGPT di usare le informazioni analitiche e operative già disponibili nel tuo Bonsai workspace autorizzato. Chiedi riepiloghi KPI, tabelle prodotto e SKU, insight advertising, informazioni di inventario e altre analisi supportate — senza dare a ChatGPT accesso diretto al database.

Il connettore usa un unico endpoint MCP sicuro per tutti i clienti. Azienda, organizzazione di agenzia, permessi tenant e moduli Bonsai attivi determinano cosa puoi consultare.

In breve
  • Endpoint MCP ufficiale: https://mcp.bonsaisolutions.it/mcp
  • Autenticazione: OAuth
  • Percorsi di accesso: Azienda o Agenzia
  • Tool business-data: read-only
  • Cambio tenant Agenzia: cambia solo il contesto di sessione
  • Formato date: YYYY-MM-DD

1. Prima di collegare

Ti serve:

  • un account Bonsai attivo;
  • accesso all'azienda o all'organizzazione agenzia rilevante;
  • i moduli Bonsai e i permessi richiesti dai tool che vuoi usare;
  • un piano ChatGPT e una configurazione workspace che supportino le capacità MCP richieste;
  • autorizzazione della tua organizzazione a collegare Bonsai a ChatGPT.

La disponibilità dipende dal tuo piano ChatGPT, paese, ruolo workspace, impostazioni admin e superficie supportata. Le funzionalità MCP complete sono attualmente pensate per ChatGPT web.

2. Collegare Bonsai a ChatGPT

Developer Mode (attuale)

  1. Apri ChatGPT sul web.
  2. Apri le impostazioni.
  3. Attiva Developer mode (può apparire sotto Security & login oppure Apps → Advanced settings).
  4. Apri ChatGPT Plugins o Workspace settings → Apps → Create.
  5. Crea una nuova MCP app o connessione.
  6. Inserisci un nome utente come "Bonsai".
  7. Usa l'endpoint esatto: https://mcp.bonsaisolutions.it/mcp
  8. Seleziona autenticazione OAuth. Non usare API key.
  9. Avvia la connessione e completa l'autorizzazione Bonsai.
  10. Rivedi i tool scoperti e crea la connessione.

chatgpt.com/plugins

Developer Mode è per test privati e non rende il connettore pubblicamente disponibile nella Plugins Directory.

3. Scegli il percorso di login corretto

Azienda

Scegli Azienda quando devi collegarti direttamente a un singolo ambiente Bonsai. Seleziona o inserisci le informazioni richieste, continua col login Bonsai autorizzato e completa OAuth. ChatGPT potrà usare solo i tool e i dati disponibili a quell'utente e tenant autenticato.

Agenzia

Scegli Agenzia quando usi Bonsai Agency e lavori con tenant clienti autorizzati. Accedi con le credenziali Bonsai Agency. ChatGPT può elencare solo i tenant assegnati alla tua organizzazione. Prima di chiedere business data, seleziona il tenant attivo da quell'elenco.

Esempio: "Elenca i miei tenant disponibili e imposta CODICE_CLIENTE come tenant attivo." Sostituisci CODICE_CLIENTE con un codice tenant assegnato alla tua agenzia.

4. Verifica l'account prima di autorizzare

La pagina di autorizzazione Bonsai mostra l'email autenticata. Verificala prima di selezionare Authorize. Se non è l'account che vuoi usare, seleziona "Sign out and change user", scegli Azienda o Agenzia e completa il login con l'account corretto.

Disconnettere Bonsai dentro ChatGPT non termina sempre una sessione browser Bonsai esistente. Verifica sempre l'email mostrata nella pagina di autorizzazione.

5. Usare Bonsai in ChatGPT

Avvia una nuova conversazione e seleziona la Bonsai app dal menu tools o apps per il messaggio che richiede dati Bonsai correnti. A seconda dell'interfaccia ChatGPT, potresti anche menzionare l'app direttamente. La selezione dell'app può applicarsi a un messaggio specifico invece che all'intera conversazione.

6. Come formulare le richieste

  • Usa date nel formato YYYY-MM-DD.
  • Chiedi prima un riepilogo KPI quando serve una panoramica.
  • Chiedi prodotti, ASIN o SKU quando servono dettagli di riga.
  • Specifica se la richiesta riguarda Vendor, Seller, Advertising, FBA, inventario o un'altra area Bonsai supportata.
  • Per accesso Agenzia, verifica o seleziona il tenant attivo prima di chiedere business data.
  • Non includere password, token, codici OTP o informazioni personali non necessarie.
  • Verifica i dati importanti in Bonsai prima di prendere decisioni.

7. Prompt di esempio

Date, codici tenant, ASIN e SKU sono esempi da sostituire con valori reali dal tuo account.

1. Check the status of the Bonsai MCP server.
2. Who am I in this Bonsai session?
3. Which tenants can I access?
4. Summarize Amazon Vendor Standard sales from 2026-08-01 to 2026-08-31.
5. Show the products with the highest shipped revenue for the same period.
6. Summarize Amazon Ads campaign performance from 2026-08-01 to 2026-08-31.
7. Which advertised products generated the most sales?
8. Summarize Buy Box performance for the tracked catalog.
9. Which ASINs should be replenished in FBA?
10. (Agency only) List my available tenants and set CLIENT_CODE as active tenant.

8. Aree Bonsai supportate

Piattaforma & accessi
  • Stato connessione
  • Identità autenticata
  • Tenant disponibili
  • Selezione tenant attivo (Agenzia)
Amazon Vendor
  • Standard Sales, Traffic, Inventory, Forecast, Geo Sales
  • Sourcing exclusions, Strategic Sales, Net PPM
  • Catalog Health, TCA, Returns, Vendor Coverage
Amazon Advertising
  • Campaigns, Ad Groups, Product Ads, advertised products
  • Keywords, Search Terms, Category Benchmarks
  • Conversion Paths, Brand Store analytics
Tracking & marketplace
  • Rank, Price, Buy Box
  • Offerte competitor
  • Analisi prezzo e rank
Seller, catalogo & clienti
  • Listing Catalog Health
  • Brand Analytics Search Terms
  • Amazon Seller Sales & account performance
  • Customer feedback
FBA & inventario
  • FBA replenishment
  • FBA fees and estimates
  • Stock magazzino
  • Copertura stock seller

Le funzionalità dipendono dai moduli, permessi, marketplace e dati disponibili nel tenant Bonsai attivo.

9. Tool read-only e conferma tenant

I tool analytics Bonsai recuperano dati e non modificano record Vendor, Seller, Advertising, inventario, prezzo o catalogo.

Il tool Agenzia switch_tenant cambia il contesto tenant attivo per le richieste successive. Non modifica dati nel tenant, ma ChatGPT potrebbe chiedere conferma perché cambia il contesto autorizzativo della sessione.

10. Limitazioni attuali

  • Il connettore accede solo a tenant, moduli e dati autorizzati per l'utente Bonsai autenticato.
  • Non fornisce accesso database o SQL senza restrizioni.
  • Non lascia scegliere a ChatGPT un tenant o server URL arbitrario.
  • Non modifica dati Vendor, Seller, Advertising, inventario, prezzo o catalogo.
  • Le capacità Vendor Realtime non sono attualmente incluse.
  • Disponibilità e freschezza dei dati dipendono dai report sottostanti e dal tenant Bonsai attivo.
  • Risultati vuoti non indicano sempre un errore; il tenant o periodo selezionato potrebbe non avere dati.
  • ChatGPT può riassumere o interpretare i risultati; i dati importanti vanno verificati in Bonsai.
  • La disponibilità su mobile, agent mode, deep research, piani e configurazioni workspace è controllata da OpenAI e può cambiare.

11. Troubleshooting

ChatGPT non trova o non si collega a Bonsai

  • Verifica l'endpoint ufficiale: https://mcp.bonsaisolutions.it/mcp
  • Conferma che Developer Mode o il plugin pubblico sia disponibile per l'account.
  • Chiedi all'admin workspace se le custom apps o plugins sono abilitate.
  • Riprova da ChatGPT web.

Appare l'utente Bonsai sbagliato

  • Verifica l'email nella pagina di autorizzazione Bonsai.
  • Seleziona "Sign out and change user".
  • Scegli di nuovo Azienda o Agenzia.
  • Accedi con l'account corretto.

Risultati vuoti o incompleti

  • Verifica tenant, range date, marketplace e filtri.
  • Prova una richiesta di riepilogo prima delle righe prodotto.
  • Controlla che il report sottostante sia disponibile in Bonsai.

12. Disconnessione o cambio account

Per smettere di usare Bonsai in ChatGPT, disconnetti o disabilita la Bonsai app dalle impostazioni ChatGPT. Per collegare un altro utente Bonsai, riavvia il flusso di autorizzazione e seleziona "Sign out and change user" quando appare l'email attuale.

Disconnettere ChatGPT, uscire dalla sessione browser MCP, uscire dalla piattaforma Bonsai e revocare OAuth sono azioni separate. Contatta il supporto se serve aiuto a revocare gli accessi.

13. Privacy e sicurezza

Il connettore usa HTTPS e autorizzazione OAuth. L'accesso è limitato da account Bonsai autenticato, organizzazione, allowlist tenant, moduli e permessi utente. Bonsai conserva log di audit delle invocazioni tool per sicurezza operativa e supporto (retention: 90 giorni). Password, access token, refresh token, client secret, cookie e header Authorization sono esclusi o oscurati dai log applicativi.

Informativa privacy · Termini di servizio · Supporto

14. Supporto

Per aiuto su connessione, autenticazione, accesso tenant, moduli, disconnessione o risultati inattesi, visita la pagina Supporto del connettore MCP Bonsai o scrivi a info@bonsaigrowth.it.

Non inviare mai password, codici OAuth, token, one-time password o dati riservati dei clienti via email.

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