On this page

Serveur MCP Brevo

Brevo fournit un serveur MCP hébergé officiel sur mcp.brevo.com qui expose 27 modules, contacts, campagnes, deals, modèles, WhatsApp, SMS et plus encore, en tant qu’outils que tout agent IA peut invoquer. Aucune installation locale requise.

Tip

Le serveur MCP Brevo utilise le Model Context Protocol (MCP), un standard ouvert d’Anthropic qui connecte les assistants IA aux outils et services externes.

Démarrage rapide

1. Obtenir votre token MCP

Brevo MCP utilise un token MCP dédié (pas une clé API standard) :

Connectez-vous à app.brevo.com
Allez dans Compte > SMTP & API > Clés API
Cliquez sur Générer une nouvelle clé API et activez Créer une clé API serveur MCP
Copiez et conservez votre token en lieu sûr

Caution

Votre token MCP accorde un accès complet en lecture/écriture à votre compte Brevo. Ne le commitez jamais dans un système de contrôle de version et ne le partagez pas publiquement.

2. Connecter votre outil IA

Ajoutez au fichier de configuration 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": "paste-your-mcp-token-here"
      }
    }
  }
}

Redémarrez Claude Desktop après l’enregistrement. Nécessite Node.js installé.

Ajoutez à ~/.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": "paste-your-mcp-token-here"
      }
    }
  }
}

Vérifiez avec :

claude mcp list

Ajoutez à ~/.cursor/mcp.json (global) ou .cursor/mcp.json (par projet) :

{
  "mcpServers": {
    "brevo": {
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

Ajoutez à .vscode/mcp.json (par projet) ou mcp.json au niveau utilisateur :

{
  "servers": {
    "brevo": {
      "type": "http",
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

Ajoutez à ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "brevo": {
      "serverUrl": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

3. Tester la connexion

Une fois connecté, demandez à votre assistant IA :

> How many contacts do I have?
> Create an email campaign for my product launch
> Show me deals in the Negotiation stage
> Add a contact to my newsletter list

Serveurs disponibles

Le serveur principal sur /v1/brevo/mcp inclut tous les 27 modules. Pour une meilleure qualité de réponse avec des cas d’usage ciblés, connectez-vous à des serveurs individuels qui donnent à votre IA un ensemble d’outils plus petit et plus ciblé.

Serveur principal

Point de terminaison	Description
`https://mcp.brevo.com/v1/brevo/mcp`	Toutes les fonctionnalités combinées (27 modules)

Serveurs individuels

Connectez uniquement les modules dont votre agent a besoin. Cela améliore la qualité des réponses IA en réduisant la surface d’outils.

Contacts & CRM

Serveur	Point de terminaison	Objectif
contacts	`/v1/brevo_contacts/mcp`	Gérer les contacts et listes
lists	`/v1/brevo_lists/mcp`	Gérer les listes de contacts
segments	`/v1/brevo_segments/mcp`	Gérer les segments de contacts
attributes	`/v1/brevo_attributes/mcp`	Gérer les attributs de contacts
groups	`/v1/brevo_groups/mcp`	Gérer les groupes de contacts
contact_import_export	`/v1/brevo_contact_import_export/mcp`	Import/export de contacts en masse

Campagnes & Messagerie

Serveur	Point de terminaison	Objectif
email_campaign_management	`/v1/brevo_email_campaign_management/mcp`	Créer et gérer les campagnes email
campaign_analytics	`/v1/brevo_campaign_analytics/mcp`	Voir les performances des campagnes
templates	`/v1/brevo_templates/mcp`	Gérer les modèles email
transac_templates	`/v1/brevo_transac_templates/mcp`	Gérer les modèles email transactionnels
sms_campaigns	`/v1/brevo_sms_campaigns/mcp`	Créer et envoyer des campagnes SMS
whatsapp_campaigns	`/v1/brevo_whatsapp_campaigns/mcp`	Créer et envoyer des campagnes WhatsApp
whatsapp_management	`/v1/brevo_whatsapp_management/mcp`	Configurer les paramètres WhatsApp

CRM de vente

Serveur	Point de terminaison	Objectif
deals	`/v1/brevo_deals/mcp`	Gérer les deals CRM
companies	`/v1/brevo_companies/mcp`	Gérer les entreprises CRM
tasks	`/v1/brevo_tasks/mcp`	Gérer les tâches CRM
pipelines	`/v1/brevo_pipelines/mcp`	Configurer les pipelines CRM
notes	`/v1/brevo_notes/mcp`	Ajouter des notes aux contacts et deals

Compte & Paramètres

Serveur	Point de terminaison	Objectif
senders	`/v1/brevo_senders/mcp`	Gérer les identités expéditeurs
domains	`/v1/brevo_domains/mcp`	Gérer les domaines expéditeurs
ips	`/v1/brevo_ips/mcp`	Gérer les IPs dédiées
accounts	`/v1/brevo_accounts/mcp`	Gérer le compte et les sous-comptes
users	`/v1/brevo_users/mcp`	Gérer les utilisateurs et permissions
webhooks_management	`/v1/brevo_webhooks_management/mcp`	Configurer les webhooks
external_feeds	`/v1/brevo_external_feeds/mcp`	Gérer les flux RSS
folders	`/v1/brevo_folders/mcp`	Organiser les campagnes dans des dossiers
processes	`/v1/brevo_processes/mcp`	Surveiller les processus en arrière-plan

Tous les points de terminaison utilisent l’URL de base https://mcp.brevo.com.

Portée des outils pour les agents

Pour les agents Tajo, connectez uniquement les serveurs dont votre agent a besoin. C’est ainsi que vous implémentez la portée des permissions, chaque agent obtient un ensemble différent de serveurs MCP.

Exemple : Agent de récupération de panier

Cet agent n’a besoin que des contacts, des campagnes email et des 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" }
    }
  }
}

Exemple : Agent CRM de vente

Cet agent ne travaille qu’avec les deals et les entreprises :

{
  "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" }
    }
  }
}

Comment Tajo utilise Brevo MCP

Tajo se place entre votre intention et les outils MCP de Brevo. Le flux d’orchestration :

Marketer Intent
    "Win back customers who haven't ordered in 90 days"
        ↓
Tajo Agent Layer
    Selects: Win-Back Agent
    Agent reads its spec: tools, constraints, strategy
        ↓
Brevo MCP Tools
    brevo_contacts → find churned customers
    brevo_segments → create target segment
    brevo_email    → send recovery campaign
    brevo_sms      → SMS follow-up for non-openers
        ↓
Brevo Platform
    Emails delivered, SMS sent, events tracked

Chaque spécification d’agent Tajo déclare les serveurs MCP Brevo dont il a besoin. La couche d’orchestration connecte uniquement ces serveurs, imposant un accès au moindre privilège.

Dépannage

”Command not found: npx”

Installez Node.js. Le pont npx mcp-remote est requis pour Claude Desktop et Claude Code.

Les outils n’apparaissent pas

Redémarrez complètement votre application (pas seulement un rechargement)
Vérifiez que votre JSON n’a pas d’erreurs de syntaxe (virgules finales, crochets manquants)
Vérifiez que votre token MCP n’a pas d’espaces supplémentaires

Erreurs d’authentification

Vérifiez que votre token MCP est toujours actif dans Tableau de bord Brevo > SMTP & API
Confirmez que l’en-tête Authorization est formaté comme Bearer <token> avec un espace

Prochaines étapes

Créer votre premier agent, Utilisez les outils MCP Brevo pour construire un agent marketing
Format de spécification d’agent, Définissez des agents personnalisés avec accès aux outils scopé
Référence des Skills, Voir comment les Skills Tajo se composent par-dessus les outils MCP
Docs officielles Brevo, Documentation MCP Brevo complète

Serveur MCP Brevo