Server MCP Brevo
Server MCP Brevo
Brevo fornisce un server MCP ufficiale ospitato su mcp.brevo.com che espone 27 moduli, contatti, campagne, trattative, template, WhatsApp, SMS e altro, come strumenti che qualsiasi agente IA può invocare. Non è richiesta alcuna installazione locale.
Tip
Il Server MCP Brevo usa il Model Context Protocol (MCP), uno standard aperto di Anthropic che connette gli assistenti IA a strumenti e servizi esterni.
Avvio Rapido
1. Ottieni il Token MCP
Brevo MCP usa un token MCP dedicato (non una chiave API standard):
- Accedi a app.brevo.com
- Vai su Account > SMTP & API > Chiavi API
- Fai clic su Genera una nuova chiave API e attiva Crea chiave API server MCP
- Copia e conserva il token in modo sicuro
Caution
Il tuo token MCP concede accesso completo in lettura/scrittura al tuo account Brevo. Non committarlo mai nel controllo di versione né condividerlo pubblicamente.
2. Connetti il Tuo Strumento IA
Aggiungi al file di configurazione di Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "brevo": { "command": "npx", "args": [ "mcp-remote", "https://mcp.brevo.com/v1/brevo/mcp", "--header", "Authorization: Bearer ${BREVO_MCP_TOKEN}" ], "env": { "BREVO_MCP_TOKEN": "incolla-il-tuo-token-mcp-qui" } } }}Riavvia Claude Desktop dopo aver salvato. Richiede Node.js installato.
Aggiungi a ~/.claude/config.json:
{ "mcpServers": { "brevo": { "command": "npx", "args": [ "mcp-remote", "https://mcp.brevo.com/v1/brevo/mcp", "--header", "Authorization: Bearer ${BREVO_MCP_TOKEN}" ], "env": { "BREVO_MCP_TOKEN": "incolla-il-tuo-token-mcp-qui" } } }}Verifica con:
claude mcp listAggiungi a ~/.cursor/mcp.json (globale) o .cursor/mcp.json (per progetto):
{ "mcpServers": { "brevo": { "url": "https://mcp.brevo.com/v1/brevo/mcp", "headers": { "Authorization": "Bearer incolla-il-tuo-token-mcp-qui" } } }}Aggiungi a .vscode/mcp.json (per progetto) o mcp.json a livello utente:
{ "servers": { "brevo": { "type": "http", "url": "https://mcp.brevo.com/v1/brevo/mcp", "headers": { "Authorization": "Bearer incolla-il-tuo-token-mcp-qui" } } }}Aggiungi a ~/.codeium/windsurf/mcp_config.json:
{ "mcpServers": { "brevo": { "serverUrl": "https://mcp.brevo.com/v1/brevo/mcp", "headers": { "Authorization": "Bearer incolla-il-tuo-token-mcp-qui" } } }}3. Verifica la Connessione
Una volta connesso, chiedi al tuo assistente IA:
> Quanti contatti ho?> Crea una campagna email per il lancio del prodotto> Mostrami le trattative nella fase Negoziazione> Aggiungi un contatto alla mia lista newsletterServer Disponibili
Il server principale su /v1/brevo/mcp include tutti i 27 moduli. Per una qualità di risposta migliore con casi d’uso specifici, connettiti ai server individuali che offrono al tuo IA un set di strumenti più piccolo e mirato.
Server Principale
| Endpoint | Descrizione |
|---|---|
https://mcp.brevo.com/v1/brevo/mcp | Tutte le funzionalità combinate (27 moduli) |
Server Individuali
Connetti solo i moduli di cui il tuo agente ha bisogno. Questo migliora la qualità della risposta IA riducendo la superficie degli strumenti.
Contatti e CRM
| Server | Endpoint | Scopo |
|---|---|---|
| contacts | /v1/brevo_contacts/mcp | Gestione contatti e liste |
| lists | /v1/brevo_lists/mcp | Gestione liste contatti |
| segments | /v1/brevo_segments/mcp | Gestione segmenti contatti |
| attributes | /v1/brevo_attributes/mcp | Gestione attributi contatti |
| groups | /v1/brevo_groups/mcp | Gestione gruppi contatti |
| contact_import_export | /v1/brevo_contact_import_export/mcp | Importazione/esportazione contatti in blocco |
Campagne e Messaggistica
| Server | Endpoint | Scopo |
|---|---|---|
| email_campaign_management | /v1/brevo_email_campaign_management/mcp | Creazione e gestione campagne email |
| campaign_analytics | /v1/brevo_campaign_analytics/mcp | Visualizza performance campagne |
| templates | /v1/brevo_templates/mcp | Gestione template email |
| transac_templates | /v1/brevo_transac_templates/mcp | Gestione template email transazionali |
| sms_campaigns | /v1/brevo_sms_campaigns/mcp | Creazione e invio campagne SMS |
| whatsapp_campaigns | /v1/brevo_whatsapp_campaigns/mcp | Creazione e invio campagne WhatsApp |
| whatsapp_management | /v1/brevo_whatsapp_management/mcp | Configurazione impostazioni WhatsApp |
Sales CRM
| Server | Endpoint | Scopo |
|---|---|---|
| deals | /v1/brevo_deals/mcp | Gestione trattative CRM |
| companies | /v1/brevo_companies/mcp | Gestione aziende CRM |
| tasks | /v1/brevo_tasks/mcp | Gestione attività CRM |
| pipelines | /v1/brevo_pipelines/mcp | Configurazione pipeline CRM |
| notes | /v1/brevo_notes/mcp | Aggiunta note a contatti e trattative |
Account e Impostazioni
| Server | Endpoint | Scopo |
|---|---|---|
| senders | /v1/brevo_senders/mcp | Gestione identità mittente |
| domains | /v1/brevo_domains/mcp | Gestione domini mittente |
| ips | /v1/brevo_ips/mcp | Gestione IP dedicati |
| accounts | /v1/brevo_accounts/mcp | Gestione account e sub-account |
| users | /v1/brevo_users/mcp | Gestione utenti e permessi |
| webhooks_management | /v1/brevo_webhooks_management/mcp | Configurazione webhook |
| external_feeds | /v1/brevo_external_feeds/mcp | Gestione feed RSS |
| folders | /v1/brevo_folders/mcp | Organizzazione campagne in cartelle |
| processes | /v1/brevo_processes/mcp | Monitoraggio processi in background |
Tutti gli endpoint usano l’URL base https://mcp.brevo.com.
Strumenti con Scope per gli Agenti
Per gli agenti Tajo, connetti solo i server di cui l’agente ha bisogno. Così si implementa lo scope dei permessi, ogni agente riceve un set diverso di server MCP.
Esempio: Agente Recupero Carrelli
Questo agente ha bisogno solo di contatti, campagne email e SMS:
{ "mcpServers": { "brevo_contacts": { "url": "https://mcp.brevo.com/v1/brevo_contacts/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_email": { "url": "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_templates": { "url": "https://mcp.brevo.com/v1/brevo_templates/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_sms": { "url": "https://mcp.brevo.com/v1/brevo_sms_campaigns/mcp", "headers": { "Authorization": "Bearer your-token" } } }}Esempio: Agente Sales CRM
Questo agente lavora solo con trattative e aziende:
{ "mcpServers": { "brevo_deals": { "url": "https://mcp.brevo.com/v1/brevo_deals/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_companies": { "url": "https://mcp.brevo.com/v1/brevo_companies/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_pipelines": { "url": "https://mcp.brevo.com/v1/brevo_pipelines/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_tasks": { "url": "https://mcp.brevo.com/v1/brevo_tasks/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_notes": { "url": "https://mcp.brevo.com/v1/brevo_notes/mcp", "headers": { "Authorization": "Bearer your-token" } } }}Come Tajo Usa il MCP Brevo
Tajo si posiziona tra il tuo intento e gli strumenti MCP di Brevo. Il flusso di orchestrazione:
Intento del Marketer "Recupera i clienti che non hanno ordinato in 90 giorni" ↓Livello Agente Tajo Seleziona: Win-Back Agent L'agente legge la sua specifica: strumenti, vincoli, strategia ↓Strumenti MCP Brevo brevo_contacts → trova i clienti abbandonati brevo_segments → crea il segmento target brevo_email → invia la campagna di recupero brevo_sms → SMS di follow-up per chi non ha aperto ↓Piattaforma Brevo Email consegnate, SMS inviati, eventi tracciatiOgni specifica agente Tajo dichiara quali server MCP Brevo necessita. Il livello di orchestrazione connette solo quei server, applicando il principio del minimo privilegio.
Risoluzione dei Problemi
”Command not found: npx”
Installa Node.js. Il bridge npx mcp-remote è necessario per Claude Desktop e Claude Code.
Strumenti non appaiono
- Riavvia completamente l’applicazione (non solo ricaricare)
- Verifica che il JSON non abbia errori di sintassi (virgole finali, parentesi mancanti)
- Controlla che il token MCP non abbia spazi extra
Errori di autenticazione
- Verifica che il token MCP sia ancora attivo in Dashboard Brevo > SMTP & API
- Conferma che l’intestazione
Authorizationsia formattata comeBearer <token>con uno spazio
Passi Successivi
- Creare il Primo Agente, Usa gli strumenti MCP Brevo per creare un agente di marketing
- Formato Specifiche Agenti, Definisci agenti personalizzati con accesso agli strumenti con scope
- Riferimento Skill, Scopri come le Skill Tajo si compongono sugli strumenti MCP
- Documentazione Ufficiale Brevo, Documentazione MCP Brevo completa