Servidor MCP de Brevo

Brevo ofrece 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 hace falta ninguna instalación local.

Inicio rápido

1. Consigue tu token MCP

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

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

2. Conecta tu herramienta de IA

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

{
  "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 mcp list

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

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

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

3. Prueba la conexión

Una vez conectado, pregunta a tu asistente de 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

Servidores disponibles

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

Servidor principal

Servidores individuales

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

Contactos y CRM

Campañas y mensajería

CRM de ventas

Cuenta y ajustes

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

Alcance de herramientas para agentes

Para los agentes de Tajo, conecta solo los servidores que tu agente necesita. Así es como se aplica el alcance de permisos, cada agente recibe un conjunto distinto de servidores MCP.

Ejemplo: agente de recuperación de carritos

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

Ejemplo: agente de CRM de ventas

Este agente solo trabaja con tratos y empresas:

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

Cómo usa Tajo el MCP de Brevo

Tajo se sitúa entre tu intención y las herramientas MCP de Brevo. El flujo de orquestación:

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

La especificación de cada agente de Tajo declara qué servidores MCP de Brevo necesita. La capa de orquestación conecta solo esos servidores y aplica así un acceso de mínimo privilegio.

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 la aplicación por completo (no basta con recargarla)
• Comprueba que tu JSON no tenga errores de sintaxis (comas finales, corchetes que faltan)
• Verifica que tu token MCP no tenga espacios de más

Errores de autenticación

• Comprueba que tu token MCP siga activo en Brevo Dashboard > SMTP & API
• Confirma que la cabecera Authorization tiene el formato Bearer <token> con un espacio

Próximos pasos

• Crea 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 acotado
• Referencia de Skills, mira cómo las Skills de Tajo se componen sobre las herramientas MCP
• Documentación oficial de Brevo, documentación completa del MCP de Brevo