On this page

Servidor MCP Brevo

O Brevo fornece um servidor MCP oficial alojado em mcp.brevo.com que expõe 27 módulos, contactos, campanhas, negócios, templates, WhatsApp, SMS e muito mais, como ferramentas que qualquer agente de IA pode invocar. Não é necessária instalação local.

Tip

O Servidor MCP Brevo utiliza o Model Context Protocol (MCP), um padrão aberto da Anthropic que liga assistentes de IA a ferramentas e serviços externos.

Início Rápido

1. Obter o Seu Token MCP

O Brevo MCP usa um token MCP dedicado (não uma chave de API padrão):

Faça login em app.brevo.com
Aceda a Conta > SMTP & API > Chaves de API
Clique em Gerar uma nova chave de API e ative Criar chave de API para servidor MCP
Copie e guarde o seu token em segurança

Caution

O seu token MCP concede acesso total de leitura/escrita à sua conta Brevo. Nunca o commite para controlo de versão nem o partilhe publicamente.

2. Ligar a Sua Ferramenta de IA

Adicione ao ficheiro de configuração do 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": "cole-o-seu-token-mcp-aqui"
      }
    }
  }
}

Reinicie o Claude Desktop depois de guardar. Requer Node.js instalado.

Adicione 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": "cole-o-seu-token-mcp-aqui"
      }
    }
  }
}

Verifique com:

claude mcp list

Adicione a ~/.cursor/mcp.json (global) ou .cursor/mcp.json (por projeto):

{
  "mcpServers": {
    "brevo": {
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer cole-o-seu-token-mcp-aqui"
      }
    }
  }
}

Adicione a .vscode/mcp.json (por projeto) ou mcp.json ao nível do utilizador:

{
  "servers": {
    "brevo": {
      "type": "http",
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer cole-o-seu-token-mcp-aqui"
      }
    }
  }
}

Adicione a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "brevo": {
      "serverUrl": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer cole-o-seu-token-mcp-aqui"
      }
    }
  }
}

3. Testar a Ligação

Uma vez ligado, pergunte ao seu assistente de IA:

> Quantos contactos tenho?
> Crie uma campanha de e-mail para o lançamento do meu produto
> Mostre-me os negócios em fase de Negociação
> Adicione um contacto à minha lista de newsletter

Servidores Disponíveis

O servidor principal em /v1/brevo/mcp inclui todos os 27 módulos. Para melhor qualidade de resposta em casos de uso focados, ligue a servidores individuais que dão à sua IA um conjunto de ferramentas mais pequeno e direcionado.

Servidor Principal

Endpoint	Descrição
`https://mcp.brevo.com/v1/brevo/mcp`	Todas as funcionalidades combinadas (27 módulos)

Servidores Individuais

Ligue apenas os módulos de que o seu agente precisa. Isto melhora a qualidade das respostas de IA ao reduzir a superfície de ferramentas.

Contactos e CRM

Servidor	Endpoint	Propósito
contacts	`/v1/brevo_contacts/mcp`	Gerir contactos e listas
lists	`/v1/brevo_lists/mcp`	Gerir listas de contactos
segments	`/v1/brevo_segments/mcp`	Gerir segmentos de contactos
attributes	`/v1/brevo_attributes/mcp`	Gerir atributos de contactos
groups	`/v1/brevo_groups/mcp`	Gerir grupos de contactos
contact_import_export	`/v1/brevo_contact_import_export/mcp`	Importação/exportação de contactos em massa

Campanhas e Mensagens

Servidor	Endpoint	Propósito
email_campaign_management	`/v1/brevo_email_campaign_management/mcp`	Criar e gerir campanhas de e-mail
campaign_analytics	`/v1/brevo_campaign_analytics/mcp`	Ver desempenho de campanhas
templates	`/v1/brevo_templates/mcp`	Gerir templates de e-mail
transac_templates	`/v1/brevo_transac_templates/mcp`	Gerir templates de e-mail transacional
sms_campaigns	`/v1/brevo_sms_campaigns/mcp`	Criar e enviar campanhas SMS
whatsapp_campaigns	`/v1/brevo_whatsapp_campaigns/mcp`	Criar e enviar campanhas WhatsApp
whatsapp_management	`/v1/brevo_whatsapp_management/mcp`	Configurar definições WhatsApp

CRM de Vendas

Servidor	Endpoint	Propósito
deals	`/v1/brevo_deals/mcp`	Gerir negócios CRM
companies	`/v1/brevo_companies/mcp`	Gerir empresas CRM
tasks	`/v1/brevo_tasks/mcp`	Gerir tarefas CRM
pipelines	`/v1/brevo_pipelines/mcp`	Configurar pipelines CRM
notes	`/v1/brevo_notes/mcp`	Adicionar notas a contactos e negócios

Conta e Definições

Servidor	Endpoint	Propósito
senders	`/v1/brevo_senders/mcp`	Gerir identidades de remetente
domains	`/v1/brevo_domains/mcp`	Gerir domínios de remetente
ips	`/v1/brevo_ips/mcp`	Gerir IPs dedicados
accounts	`/v1/brevo_accounts/mcp`	Gerir conta e sub-contas
users	`/v1/brevo_users/mcp`	Gerir utilizadores e permissões
webhooks_management	`/v1/brevo_webhooks_management/mcp`	Configurar webhooks
external_feeds	`/v1/brevo_external_feeds/mcp`	Gerir feeds RSS
folders	`/v1/brevo_folders/mcp`	Organizar campanhas em pastas
processes	`/v1/brevo_processes/mcp`	Monitorizar processos em segundo plano

Todos os endpoints usam o URL base https://mcp.brevo.com.

Limitar Ferramentas para Agentes

Para agentes Tajo, ligue apenas os servidores de que o seu agente precisa. Esta é a forma de implementar limitação de âmbito de permissão, cada agente obtém um conjunto diferente de servidores MCP.

Exemplo: Agente de Recuperação de Carrinho

Este agente apenas precisa de contactos, campanhas de e-mail 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" }
    }
  }
}

Exemplo: Agente CRM de Vendas

Este agente apenas trabalha com negócios e 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" }
    }
  }
}

Como o Tajo Usa o Brevo MCP

O Tajo posiciona-se entre a sua intenção e as ferramentas MCP do Brevo. O fluxo de orquestração:

Intenção do Profissional de Marketing
    "Reconquiste clientes que não encomendaram há 90 dias"
        ↓
Camada de Agentes Tajo
    Seleciona: Agente Win-Back
    Agente lê a sua especificação: ferramentas, restrições, estratégia
        ↓
Ferramentas MCP Brevo
    brevo_contacts → encontrar clientes perdidos
    brevo_segments → criar segmento alvo
    brevo_email    → enviar campanha de recuperação
    brevo_sms      → follow-up SMS para não-abridores
        ↓
Plataforma Brevo
    E-mails entregues, SMS enviados, eventos rastreados

Cada especificação de agente Tajo declara quais servidores MCP Brevo necessita. A camada de orquestração liga apenas esses servidores, aplicando o princípio de menor privilégio.

Resolução de Problemas

”Command not found: npx”

Instale o Node.js. A bridge npx mcp-remote é necessária para Claude Desktop e Claude Code.

Ferramentas não aparecem

Reinicie completamente a sua aplicação (não apenas recarregar)
Verifique se o seu JSON não tem erros de sintaxe (vírgulas finais, parênteses em falta)
Confirme que o seu token MCP não tem espaços extra

Erros de autenticação

Verifique se o seu token MCP ainda está ativo em Painel Brevo > SMTP & API
Confirme que o cabeçalho Authorization está formatado como Bearer <token> com um espaço

Próximos Passos

Construir o Seu Primeiro Agente, Use as ferramentas MCP Brevo para construir um agente de marketing
Formato de Especificação de Agente, Defina agentes personalizados com acesso a ferramentas limitado
Referência de Skills, Veja como as Skills Tajo se compõem sobre ferramentas MCP
Documentação Oficial Brevo, Documentação MCP Brevo completa

Servidor MCP Brevo