On this page

Servidor MCP de Brevo

Brevo proporciona un servidor MCP oficial alojado en mcp.brevo.com que expone 27 módulos, contactos, campañas, tratos, plantillas, WhatsApp, SMS y más, como herramientas que cualquier agente de IA puede invocar. No se requiere instalación local.

Tip

El Servidor MCP de Brevo utiliza el Protocolo de Contexto de Modelos (MCP), un estándar abierto de Anthropic que conecta asistentes de IA con herramientas y servicios externos.

Inicio Rápido

1. Obtener Tu Token MCP

Brevo MCP usa un token MCP dedicado (no una clave API estándar):

Inicia sesión en app.brevo.com
Ve a Account > SMTP & API > API Keys
Haz clic en Generate a new API key y activa Create MCP server API key
Copia y guarda tu token de forma segura

Caution

Tu token MCP otorga acceso completo de lectura/escritura a tu cuenta de Brevo. Nunca lo incluyas en el control de versiones ni lo compartas públicamente.

2. Conectar Tu Herramienta de IA

Añade a tu archivo de configuración de 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"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar. Requiere Node.js instalado.

Añade 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": "paste-your-mcp-token-here"
      }
    }
  }
}

Verifica con:

claude mcp list

Añade a ~/.cursor/mcp.json (global) o .cursor/mcp.json (por proyecto):

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

Añade a .vscode/mcp.json (por proyecto) o mcp.json a nivel de usuario:

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

Añade a ~/.codeium/windsurf/mcp_config.json:

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

3. Probar la Conexión

Una vez conectado, pregunta a tu asistente de IA:

> ¿Cuántos contactos tengo?
> Crea una campaña de email para el lanzamiento de mi producto
> Muéstrame los tratos en la etapa de Negociación
> Añade un contacto a mi lista de newsletter

Servidores Disponibles

El servidor principal en /v1/brevo/mcp incluye los 27 módulos. Para mejor calidad de respuesta en casos de uso específicos, conéctate a servidores individuales que dan a tu IA un conjunto de herramientas más pequeño y específico.

Servidor Principal

Endpoint	Descripción
`https://mcp.brevo.com/v1/brevo/mcp`	Todas las funciones combinadas (27 módulos)

Servidores Individuales

Conecta solo los módulos que necesita tu agente. Esto mejora la calidad de respuesta de IA al reducir la superficie de herramientas.

Contactos y CRM

Servidor	Endpoint	Propósito
contacts	`/v1/brevo_contacts/mcp`	Gestionar contactos y listas
lists	`/v1/brevo_lists/mcp`	Gestionar listas de contactos
segments	`/v1/brevo_segments/mcp`	Gestionar segmentos de contactos
attributes	`/v1/brevo_attributes/mcp`	Gestionar atributos de contactos
groups	`/v1/brevo_groups/mcp`	Gestionar grupos de contactos
contact_import_export	`/v1/brevo_contact_import_export/mcp`	Importación/exportación masiva de contactos

Campañas y Mensajería

Servidor	Endpoint	Propósito
email_campaign_management	`/v1/brevo_email_campaign_management/mcp`	Crear y gestionar campañas de email
campaign_analytics	`/v1/brevo_campaign_analytics/mcp`	Ver rendimiento de campañas
templates	`/v1/brevo_templates/mcp`	Gestionar plantillas de email
transac_templates	`/v1/brevo_transac_templates/mcp`	Gestionar plantillas de email transaccional
sms_campaigns	`/v1/brevo_sms_campaigns/mcp`	Crear y enviar campañas SMS
whatsapp_campaigns	`/v1/brevo_whatsapp_campaigns/mcp`	Crear y enviar campañas de WhatsApp
whatsapp_management	`/v1/brevo_whatsapp_management/mcp`	Configurar ajustes de WhatsApp

CRM de Ventas

Servidor	Endpoint	Propósito
deals	`/v1/brevo_deals/mcp`	Gestionar tratos de CRM
companies	`/v1/brevo_companies/mcp`	Gestionar empresas de CRM
tasks	`/v1/brevo_tasks/mcp`	Gestionar tareas de CRM
pipelines	`/v1/brevo_pipelines/mcp`	Configurar pipelines de CRM
notes	`/v1/brevo_notes/mcp`	Añadir notas a contactos y tratos

Cuenta y Configuración

Servidor	Endpoint	Propósito
senders	`/v1/brevo_senders/mcp`	Gestionar identidades de remitente
domains	`/v1/brevo_domains/mcp`	Gestionar dominios de remitente
ips	`/v1/brevo_ips/mcp`	Gestionar IPs dedicadas
accounts	`/v1/brevo_accounts/mcp`	Gestionar cuenta y subcuentas
users	`/v1/brevo_users/mcp`	Gestionar usuarios y permisos
webhooks_management	`/v1/brevo_webhooks_management/mcp`	Configurar webhooks
external_feeds	`/v1/brevo_external_feeds/mcp`	Gestionar feeds RSS
folders	`/v1/brevo_folders/mcp`	Organizar campañas en carpetas
processes	`/v1/brevo_processes/mcp`	Monitorear procesos en segundo plano

Todos los endpoints usan la URL base https://mcp.brevo.com.

Alcance de Herramientas para Agentes

Para agentes de Tajo, conecta solo los servidores que el agente necesita. Así es como implementas el alcance de permisos, cada agente obtiene un conjunto diferente de servidores MCP.

Ejemplo: Agente de Recuperación de Carrito

Este agente solo necesita contactos, campañas de email y 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" }
    }
  }
}

Resolución de Problemas

”Command not found: npx”

Instala Node.js. El puente npx mcp-remote es necesario para Claude Desktop y Claude Code.

Las herramientas no aparecen

Reinicia tu aplicación completamente (no solo recarga)
Verifica que tu JSON no tenga errores de sintaxis (comas finales, corchetes faltantes)
Comprueba que tu token MCP no tenga espacios extra

Errores de autenticación

Verifica que tu token MCP siga activo en Brevo Dashboard > SMTP & API
Confirma que el encabezado Authorization tiene el formato Bearer <token> con un espacio

Próximos Pasos

Construcción de Tu Primer Agente, Usa las herramientas MCP de Brevo para construir un agente de marketing
Formato de Especificación de Agentes, Define agentes personalizados con acceso a herramientas con alcance
Referencia de Skills, Consulta cómo las Skills de Tajo se componen sobre las herramientas MCP
Documentación Oficial de Brevo, Documentación completa de Brevo MCP

Servidor MCP de Brevo