Come collegare Braze a ChatGPT via MCP

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

Braze + ChatGPT

Fai lavorare la tua AI con Braze: rivedi campagne, Canvas e i loro risultati, controlla segmenti, utenti attivi giornalieri e ricavi, consulta profili utente e iscrizioni, registra attributi ed eventi e, dopo la tua conferma, avvia campagne API.

Prerequisiti

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

BRAZE_REST_ENDPOINT, BRAZE_REST_API_KEY

Step 1 — Ottieni le credenziali

1. In Braze apri Settings → APIs and Identifiers → API Keys e fai clic su Create API Key. Una chiave appartiene a un solo workspace.
2. Dalle un nome e spunta i permessi che servono ai tool. Per leggere: campaigns.list, campaigns.details, campaigns.data_series, sends.data_series, canvas.list, canvas.details, canvas.data_summary, segments.list, segments.details, segments.data_series, kpi.dau.data_series, kpi.mau.data_series, kpi.new_users.data_series, kpi.uninstalls.data_series, events.list, events.data_series, purchases.product_list, purchases.quantity_series, purchases.revenue_series, subscription.status.get, subscription.groups.get, users.export.ids. Per scrivere aggiungi users.track, campaigns.trigger.send, canvas.trigger.send, e users.delete solo se attiverai il tool di cancellazione. I permessi di una chiave non si possono cambiare in seguito: crea invece una nuova chiave.
3. Copia la chiave in BRAZE_REST_API_KEY, senza il prefisso Bearer.
4. Copia il REST endpoint mostrato nella stessa pagina in BRAZE_REST_ENDPOINT. Dipende dalla tua istanza Braze e corrisponde all'indirizzo della dashboard: dashboard-01.braze.com usa https://rest.iad-01.braze.com, dashboard-01.braze.eu usa https://rest.fra-01.braze.eu, e così via. Le istanze statunitensi girano su rest.iad-01 fino a rest.iad-08 e su rest.us-10 (.braze.com), quelle UE su rest.fra-01 e rest.fra-02 (.braze.eu), le altre su rest.au-01, rest.id-01, rest.jp-01 e rest.kr-01 (.braze.com). Una chiave funziona solo sulla propria istanza.
5. Installa il connettore. Il controllo della connessione elenca le tue campagne, quindi la chiave ha bisogno di campaigns.list.

Chi vede cosa: la chiave agisce per l'intero workspace, non per una persona. Chi usa il connettore vede tutto ciò che la chiave può leggere, compresi i profili utente. Condividi il server MCP solo con chi è autorizzato a vederlo.

Cosa legge: campagne e Canvas con configurazione, messaggi e risultati giornalieri (invii, consegne, aperture, clic, conversioni, ricavi), i risultati di un singolo invio attivato via API (conservati 14 giorni), i segmenti con la loro dimensione stimata (per i segmenti con analytics tracking), utenti attivi giornalieri e mensili, nuovi utenti e disinstallazioni, eventi personalizzati, acquisti e ricavi, profili utente per external id, alias, braze_id, email o telefono e lo stato dei subscription group. Le serie coprono da 1 a 100 giorni, i riepiloghi dei Canvas da 1 a 14.

Prima conferma: braze_track_users registra attributi, eventi personalizzati e acquisti, fino a 75 per chiamata, e può far entrare utenti nei segmenti e avviare Canvas, quindi l'AI ti mostra le modifiche e aspetta la tua conferma. braze_send_campaign e braze_send_canvas avviano campagne e Canvas API che inviano messaggi veri a persone vere: l'AI ti mostra la campagna o il Canvas, il canale e chi esattamente li riceverà, e per un broadcast o più di un destinatario aspetta un esplicito "sì, invia". braze_delete_users è disattivato all'installazione.

Limiti: la maggior parte degli endpoint consente 250.000 richieste all'ora. La lettura dei profili utente consente 250 chiamate al minuto per i workspace attivati da agosto 2024 (2.500 prima), gli elenchi di eventi personalizzati e prodotti condividono 1.000 all'ora, e gli endpoint di invio consentono 250 chiamate broadcast al minuto e 10 al minuto per pubblico. Quando un limite è raggiunto Braze risponde 429.

Errori comuni: 401 "Invalid API key": la chiave è sbagliata o appartiene a un'altra istanza; verifica che il REST endpoint corrisponda alla tua dashboard. 403 "Access Denied": alla chiave manca il permesso per questo endpoint, quindi crea una chiave che lo abbia. 400: un parametro manca o non è valido, per esempio una durata fuori intervallo o un id di campagna sconosciuto. 429: è stato raggiunto un rate limit; aspetta e riprova una volta.

Il connettore non copre content block e template, cataloghi, liste email e hard bounce, messaggi programmati, preference center, SCIM, gli endpoint di user alias e identify, le esportazioni dei segmenti verso cloud storage né Currents.

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 ChatGPT

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.

ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

1. Vai su chatgpt.com/plugins, clicca + e poi Add custom MCP server.
2. Inserisci un nome, ad esempio Name: Braze.
3. In Connection inserisci come Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Tool disponibili

Esempi di prompt

• "Quali campagne abbiamo inviato negli ultimi 30 giorni, e quale ha avuto i tassi di apertura e di clic migliori?"
• "Quanti utenti sono entrati nel nostro Canvas di onboarding la settimana scorsa, e quanti hanno convertito a ogni passaggio?"
• "Mostrami gli utenti attivi giornalieri e i nuovi utenti degli ultimi 60 giorni."
• "Registra l'evento personalizzato webinar_attended per l'utente con external_id 4821 e mostrami prima cosa scriverai."

FAQ

Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse