Brevo MCP-Server
Brevo MCP-Server
Brevo stellt einen offiziellen gehosteten MCP-Server unter mcp.brevo.com bereit, der 27 Module – Kontakte, Kampagnen, Deals, Vorlagen, WhatsApp, SMS und mehr – als Tools bereitstellt, die jeder KI-Agent aufrufen kann. Keine lokale Installation erforderlich.
Tip
Der Brevo MCP-Server verwendet das Model Context Protocol (MCP), einen offenen Standard von Anthropic, der KI-Assistenten mit externen Tools und Diensten verbindet.
Schnellstart
1. MCP-Token erhalten
Brevo MCP verwendet ein dediziertes MCP-Token (kein Standard-API-Schlüssel):
- Bei app.brevo.com einloggen
- Zu Account > SMTP & API > API-Schlüssel gehen
- Neuen API-Schlüssel generieren klicken und MCP-Server-API-Schlüssel erstellen aktivieren
- Token kopieren und sicher aufbewahren
Caution
Ihr MCP-Token gewährt vollständigen Lese-/Schreibzugriff auf Ihr Brevo-Konto. Übergeben Sie es niemals in die Versionskontrolle oder teilen Sie es öffentlich.
2. KI-Tool verbinden
Zu Ihrer Claude Desktop-Konfigurationsdatei hinzufügen:
- 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": "paste-your-mcp-token-here" } } }}Claude Desktop nach dem Speichern neu starten. Node.js muss installiert sein.
Zu ~/.claude/config.json hinzufügen:
{ "mcpServers": { "brevo": { "command": "npx", "args": [ "mcp-remote", "https://mcp.brevo.com/v1/brevo/mcp", "--header", "Authorization: Bearer ${BREVO_MCP_TOKEN}" ], "env": { "BREVO_MCP_TOKEN": "paste-your-mcp-token-here" } } }}Überprüfen mit:
claude mcp listZu ~/.cursor/mcp.json (global) oder .cursor/mcp.json (pro Projekt) hinzufügen:
{ "mcpServers": { "brevo": { "url": "https://mcp.brevo.com/v1/brevo/mcp", "headers": { "Authorization": "Bearer paste-your-mcp-token-here" } } }}Zu .vscode/mcp.json (pro Projekt) oder benutzerweit mcp.json hinzufügen:
{ "servers": { "brevo": { "type": "http", "url": "https://mcp.brevo.com/v1/brevo/mcp", "headers": { "Authorization": "Bearer paste-your-mcp-token-here" } } }}Zu ~/.codeium/windsurf/mcp_config.json hinzufügen:
{ "mcpServers": { "brevo": { "serverUrl": "https://mcp.brevo.com/v1/brevo/mcp", "headers": { "Authorization": "Bearer paste-your-mcp-token-here" } } }}3. Verbindung testen
Sobald verbunden, Ihren KI-Assistenten fragen:
> Wie viele Kontakte habe ich?> Eine E-Mail-Kampagne für meinen Produktlaunch erstellen> Deals in der Verhandlungsphase anzeigen> Einen Kontakt zu meiner Newsletter-Liste hinzufügenVerfügbare Server
Der Hauptserver unter /v1/brevo/mcp enthält alle 27 Module. Für bessere Antwortqualität bei fokussierten Anwendungsfällen mit einzelnen Servern verbinden, die Ihrer KI einen kleineren, gezielteren Toolsatz geben.
Hauptserver
| Endpunkt | Beschreibung |
|---|---|
https://mcp.brevo.com/v1/brevo/mcp | Alle Funktionen kombiniert (27 Module) |
Einzelne Server
Nur die Module verbinden, die Ihr Agent benötigt. Dies verbessert die KI-Antwortqualität durch Reduzierung der Tool-Oberfläche.
Kontakte & CRM
| Server | Endpunkt | Zweck |
|---|---|---|
| contacts | /v1/brevo_contacts/mcp | Kontakte und Listen verwalten |
| lists | /v1/brevo_lists/mcp | Kontaktlisten verwalten |
| segments | /v1/brevo_segments/mcp | Kontaktsegmente verwalten |
| attributes | /v1/brevo_attributes/mcp | Kontaktattribute verwalten |
| groups | /v1/brevo_groups/mcp | Kontaktgruppen verwalten |
| contact_import_export | /v1/brevo_contact_import_export/mcp | Massimport/-export von Kontakten |
Kampagnen & Messaging
| Server | Endpunkt | Zweck |
|---|---|---|
| email_campaign_management | /v1/brevo_email_campaign_management/mcp | E-Mail-Kampagnen erstellen und verwalten |
| campaign_analytics | /v1/brevo_campaign_analytics/mcp | Kampagnenleistung anzeigen |
| templates | /v1/brevo_templates/mcp | E-Mail-Vorlagen verwalten |
| transac_templates | /v1/brevo_transac_templates/mcp | Transaktionelle E-Mail-Vorlagen verwalten |
| sms_campaigns | /v1/brevo_sms_campaigns/mcp | SMS-Kampagnen erstellen und senden |
| whatsapp_campaigns | /v1/brevo_whatsapp_campaigns/mcp | WhatsApp-Kampagnen erstellen und senden |
| whatsapp_management | /v1/brevo_whatsapp_management/mcp | WhatsApp-Einstellungen konfigurieren |
Vertriebs-CRM
| Server | Endpunkt | Zweck |
|---|---|---|
| deals | /v1/brevo_deals/mcp | CRM-Deals verwalten |
| companies | /v1/brevo_companies/mcp | CRM-Unternehmen verwalten |
| tasks | /v1/brevo_tasks/mcp | CRM-Aufgaben verwalten |
| pipelines | /v1/brevo_pipelines/mcp | CRM-Pipelines konfigurieren |
| notes | /v1/brevo_notes/mcp | Notizen zu Kontakten und Deals hinzufügen |
Account & Einstellungen
| Server | Endpunkt | Zweck |
|---|---|---|
| senders | /v1/brevo_senders/mcp | Absenderidentitäten verwalten |
| domains | /v1/brevo_domains/mcp | Absenderdomains verwalten |
| ips | /v1/brevo_ips/mcp | Dedizierte IPs verwalten |
| accounts | /v1/brevo_accounts/mcp | Account und Sub-Accounts verwalten |
| users | /v1/brevo_users/mcp | Benutzer und Berechtigungen verwalten |
| webhooks_management | /v1/brevo_webhooks_management/mcp | Webhooks konfigurieren |
| external_feeds | /v1/brevo_external_feeds/mcp | RSS-Feeds verwalten |
| folders | /v1/brevo_folders/mcp | Kampagnen in Ordnern organisieren |
| processes | /v1/brevo_processes/mcp | Hintergrundprozesse überwachen |
Alle Endpunkte verwenden die Basis-URL https://mcp.brevo.com.
Tools für Agents eingrenzen
Für Tajo-Agents nur die benötigten Server verbinden. So wird die Berechtigungsbeschränkung implementiert – jeder Agent erhält einen anderen Satz von MCP-Servern.
Beispiel: Warenkorb-Wiederherstellungs-Agent
Dieser Agent benötigt nur Kontakte, E-Mail-Kampagnen und 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" } } }}Beispiel: Vertriebs-CRM-Agent
Dieser Agent arbeitet nur mit Deals und Unternehmen:
{ "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" } } }}Wie Tajo Brevo MCP verwendet
Tajo sitzt zwischen Ihrer Absicht und Brevos MCP-Tools. Der Orchestrierungsablauf:
Marketer-Absicht "Kunden zurückgewinnen, die seit 90 Tagen nicht bestellt haben" ↓Tajo-Agent-Ebene Wählt: Win-Back-Agent Agent liest seine Spezifikation: Tools, Einschränkungen, Strategie ↓Brevo MCP-Tools brevo_contacts → abgewanderte Kunden finden brevo_segments → Zielsegment erstellen brevo_email → Wiedergewinnungskampagne senden brevo_sms → SMS-Follow-up für Nicht-Öffner ↓Brevo-Plattform E-Mails zugestellt, SMS gesendet, Events verfolgtJede Tajo-Agent-Spezifikation deklariert, welche Brevo MCP-Server sie benötigt. Die Orchestrierungsebene verbindet nur diese Server und setzt Least-Privilege-Zugriff durch.
Fehlerbehebung
”Command not found: npx”
Node.js installieren. Die npx mcp-remote-Bridge ist für Claude Desktop und Claude Code erforderlich.
Tools erscheinen nicht
- Anwendung vollständig neu starten (nicht nur neu laden)
- JSON auf Syntaxfehler prüfen (abschließende Kommas, fehlende Klammern)
- Sicherstellen, dass das MCP-Token keine extra Leerzeichen enthält
Authentifizierungsfehler
- MCP-Token unter Brevo Dashboard > SMTP & API auf Gültigkeit prüfen
- Bestätigen, dass der
Authorization-Header alsBearer <token>mit Leerzeichen formatiert ist
Nächste Schritte
- Ihren ersten Agent erstellen, Brevo MCP-Tools für einen Marketing-Agent nutzen
- Agent-Spezifikations-Format, Benutzerdefinierte Agents mit eingegrenztem Tool-Zugriff definieren
- Skills-Referenz, Wie Tajo-Skills auf MCP-Tools aufbauen
- Brevo Offizielle Docs, Vollständige Brevo MCP-Dokumentation