Integração Shopify + Brevo

Shopify + Brevo

Ligue os dados de commerce do Shopify à plataforma de envolvimento do Brevo através de MCP. Sincronize clientes, acione sequências pós-compra, recupere carrinhos abandonados e execute campanhas de fidelidade, tudo orquestrado por agentes de IA no Claude.

Servidores MCP Utilizados

ServidorPacote/URLPropósito
Shopify Dev MCPnpx -y @shopify/dev-mcp@latestPesquisar docs da API Shopify, introspectar esquema GraphQL, validar queries
Shopify Storefront MCPConfiguração específica da appCatálogo de produtos, operações de carrinho, dados de clientes, rastreamento de pedidos
Brevo MCPmcp.brevo.com/v1/brevo/mcpContactos, campanhas de e-mail, SMS, WhatsApp, rastreamento de eventos

Tip

O Shopify Dev MCP é para desenvolvimento, ajuda o Claude a compreender as APIs do Shopify. O Storefront MCP é para acesso a dados de produção. Normalmente usa ambos durante o desenvolvimento, depois Storefront MCP + Brevo MCP para o agente em produção.

Configuração

Passo 1: Ligar Ambos os Servidores MCP

Adicione à sua configuração do Claude Desktop ou Claude Code:

{
"mcpServers": {
"brevo": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.brevo.com/v1/brevo/mcp",
"--header",
"Authorization: Bearer ${BREVO_MCP_TOKEN}"
],
"env": {
"BREVO_MCP_TOKEN": "your-brevo-mcp-token"
}
},
"shopify-dev-mcp": {
"command": "npx",
"args": ["-y", "@shopify/dev-mcp@latest"]
}
}
}

Passo 2: Verificar Ligação

Pergunte ao Claude:

> Que APIs Shopify estão disponíveis para ler dados de clientes?
> Quantos contactos tenho no Brevo?

O Claude deve usar o Shopify Dev MCP para a primeira pergunta e o Brevo MCP para a segunda.

Caso de Uso 1: Agente de Sincronização de Clientes

Sincronize clientes Shopify para contactos Brevo com histórico completo de compras:

---
name: shopify-customer-sync
description: Sync Shopify customers to Brevo contacts with purchase data
version: 1.0.0
temperature: 0.1
tools:
- shopify-dev-mcp
- brevo_contacts
- brevo_attributes
- brevo_lists
triggers:
- schedule: "0 */6 * * *"
- event: customer_created
- event: order_completed
---
# Agente de Sincronização de Clientes Shopify
Sincronize dados de clientes do Shopify para contactos Brevo.
## Estratégia
1. Consultar o Shopify para clientes atualizados desde a última sincronização
2. Para cada cliente, criar ou atualizar contacto Brevo com:
- E-mail, nome, telefone
- Total de pedidos, total gasto (como atributos Brevo)
- Data do último pedido
- Tags e segmentos
3. Adicionar clientes às listas Brevo adequadas com base no comportamento:
- Novos clientes → lista "Welcome Series"
- Compradores recorrentes → lista "Loyal Customers"
- Alto valor (LTV >$500) → lista "VIP"
## Mapeamento de Campos
| Campo Shopify | Atributo Brevo |
|--------------|-----------------|
| email | EMAIL |
| first_name | FIRSTNAME |
| last_name | LASTNAME |
| phone | SMS |
| orders_count | ORDER_COUNT |
| total_spent | TOTAL_SPENT |
| last_order_date | LAST_ORDER |
| tags | SHOPIFY_TAGS |
| accepts_marketing | OPT_IN |
## Regras
- APENAS sincronizar clientes que aceitaram marketing
- NUNCA sobrescrever dados Brevo se o campo Shopify estiver vazio
- SEMPRE validar números de telefone para formato E.164 antes de sincronizar
- Rastrear eventos de sincronização para depuração: shopify_sync_success, shopify_sync_error

Caso de Uso 2: Agente de Campanha Pós-Compra

Acione sequências pós-compra personalizadas com base nos dados do pedido:

---
name: shopify-post-purchase
description: Orchestrate post-purchase email sequences based on Shopify order data
version: 1.0.0
temperature: 0.3
tools:
- shopify-dev-mcp
- brevo_contacts
- brevo_email_campaign_management
- brevo_templates
- brevo_sms_campaigns
triggers:
- event: order_completed
---
# Agente Pós-Compra
Quando um pedido Shopify é concluído, projete e acione
a sequência de acompanhamento adequada no Brevo.
## Lógica da Sequência
### Primeiras Compras
1. Imediato: Confirmação de pedido (transacional)
2. Dia 3: E-mail de boas-vindas com história da marca
3. Dia 7: Dicas de cuidado do produto / guia de utilização
4. Dia 14: Pedido de avaliação
5. Dia 30: Venda cruzada com base na categoria comprada
### Compradores Recorrentes
1. Imediato: Confirmação de pedido
2. Dia 3: Notificação de pontos de fidelidade
3. Dia 14: Lembrete de "reabastecimento" se produto consumível
4. Dia 21: Acesso antecipado exclusivo a novos produtos
### Pedidos VIP (>$200)
1. Imediato: Confirmação de pedido premium
2. Dia 1: Agradecimento pessoal do fundador (e-mail)
3. Dia 3: SMS com rastreamento + dicas de cuidado
4. Dia 7: Convite para o programa VIP
## Regras
- SEMPRE verificar o estado do pedido antes de enviar, ignorar se cancelado/reembolsado
- NUNCA enviar marketing para clientes que não aceitaram
- Personalizar com: nome do produto, número do pedido, primeiro nome do cliente
- Usar variáveis de template Brevo para conteúdo dinâmico

Caso de Uso 3: Recuperação de Carrinho Abandonado

Ligue dados de carrinho Shopify com as mensagens do Brevo:

---
name: shopify-cart-recovery
description: Recover Shopify abandoned carts via Brevo email and SMS
version: 2.0.0
temperature: 0.2
tools:
- shopify-dev-mcp
- brevo_contacts
- brevo_email_campaign_management
- brevo_templates
- brevo_sms_campaigns
triggers:
- event: cart_abandoned
conditions:
- cart_value: "> 40"
- time_since_activity: "> 1h"
---
# Agente de Recuperação de Carrinho
Monitorize carrinhos abandonados Shopify e execute sequências
de recuperação através do Brevo.
## Sequência de Recuperação
1. **+1 hora**: E-mail de lembrete com conteúdo e imagens do carrinho
2. **+24 horas**: Se sem abertura → SMS com link curto para o carrinho
3. **+48 horas**: Se sem recuperação → E-mail com código de desconto de 10%
4. **+72 horas**: Se carrinho >$150 e sem recuperação → WhatsApp com mensagem pessoal
## Dados do Carrinho a Incluir
- Imagens e nomes de produtos (do Shopify)
- Total do carrinho com formatação de moeda
- Link direto para o checkout
- Código de desconto (gerado dinamicamente para o passo 3)
## Regras
- NUNCA enviar para clientes que já concluíram o checkout
- SEMPRE verificar o estado do carrinho antes de cada passo
- Máximo de 4 pontos de contacto por carrinho abandonado
- Respeitar as preferências de cancelamento por canal

Exemplo: Orquestração em Linguagem Natural

Com ambos os servidores MCP ligados, pode orquestrar em tempo real:

Utilizador: "Verifique a minha loja Shopify para clientes que encomendaram
nos últimos 7 dias mas que ainda não estão no Brevo, e adicione-os."
Claude: A verificar o Shopify para clientes recentes...
[Usa shopify-dev-mcp para compreender a API de Clientes]
[Consulta o Shopify para pedidos nos últimos 7 dias]
Encontrei 43 clientes dos últimos 7 dias.
A verificar os contactos Brevo...
[Usa brevo_contacts para pesquisar cada e-mail]
23 clientes ainda não estão no Brevo. A adicioná-los...
[Usa brevo_contacts para criar 23 novos contactos]
[Usa brevo_lists para adicionar compradores de primeira vez à "Welcome Series"]
[Usa brevo_lists para adicionar compradores recorrentes à "Loyal Customers"]
Concluído:
- 23 novos contactos criados no Brevo
- 15 adicionados à lista "Welcome Series" (primeiras compras)
- 8 adicionados à lista "Loyal Customers" (compradores recorrentes)
- Todos os contactos sincronizados com número de pedidos e total gasto

Próximos Passos

Assistente AI

Olá! Pergunte-me qualquer coisa sobre a documentação.

Comece grátis com Brevo