On this page

Integrazione Custom API + Brevo

Custom API + Brevo

Non tutte le piattaforme hanno un server MCP. Per WooCommerce, BigCommerce, Magento, CRM proprietari, o qualsiasi sistema con un’API REST, crea un agente connettore che collega i tuoi dati a Brevo.

Due Approcci

Approccio 1: Server MCP Community

Verifica se esiste un server MCP community per la tua piattaforma:

Piattaforma	MCP Community	Stato
WooCommerce	`woocommerce-mcp-server`	Mantenuto dalla community
BigCommerce	Verifica la directory server MCP	Variabile
Magento	Verifica la directory server MCP	Variabile
Salesforce	Diverse opzioni disponibili	Community attiva
Zendesk	Disponibile tramite Composio/Zapier	Attivo

Se esiste un server community, usalo allo stesso modo di quelli ufficiali, aggiungilo alla configurazione Claude insieme al MCP Brevo.

Approccio 2: Agente con Strumenti HTTP

Per le piattaforme senza server MCP, crea un agente che usa le funzionalità HTTP integrate di Claude per chiamare direttamente le API REST, poi scrive su Brevo tramite MCP.

Creare un Agente Connettore Personalizzato

Passo 1: Comprendi l’API Sorgente

Documenta gli endpoint chiave di cui il tuo agente ha bisogno:

# Esempio: WooCommerce REST API
source_api:
  base_url: "https://your-store.com/wp-json/wc/v3"
  auth: Basic (consumer_key:consumer_secret)
  endpoints:
    - GET /customers          # Elenco clienti
    - GET /customers/{id}     # Dettagli cliente
    - GET /orders             # Elenco ordini
    - GET /orders/{id}        # Dettagli ordine
    - GET /products           # Elenco prodotti

Passo 2: Definisci l’Agente Connettore

---
name: custom-api-brevo-connector
description: Connette qualsiasi API REST a Brevo per campagne automatizzate
tools:
  - brevo_contacts
  - brevo_email_campaign_management
  - brevo_segments
  - brevo_campaign_analytics
triggers:
  - schedule: "0 */2 * * *"
---

# Agente Connettore API Personalizzata

Sei un agente specializzato nella sincronizzazione dei dati tra
sistemi esterni e Brevo. Utilizzi chiamate HTTP dirette per
recuperare i dati dalla sorgente e il server MCP Brevo
per gestire i contatti e le campagne.

## Processo
1. Chiama l'API sorgente per recuperare i dati aggiornati
2. Trasforma i dati nel formato Brevo
3. Crea o aggiorna i contatti in Brevo
4. Attiva le campagne appropriate

## Credenziali (da variabili d'ambiente)
- SOURCE_API_URL
- SOURCE_API_KEY

Passo 3: Configurazione Claude

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

Passo 4: Esegui l’Agente

Chiedi a Claude:
"Recupera i clienti dall'API [PIATTAFORMA] usando
GET [URL]/customers con la chiave API [KEY].
Per ciascuno, crea un contatto in Brevo con
email, nome e attributi personalizzati.
Poi segmenta per valore lifetime."

Template per Piattaforme Comuni

Magento / Adobe Commerce

source_api:
  base_url: "https://your-store.com/rest/V1"
  auth: Bearer token
  key_endpoints:
    - GET /customers/search    # Cerca clienti
    - GET /orders              # Elenco ordini
    - GET /products            # Catalogo prodotti

Zendesk

source_api:
  base_url: "https://yourcompany.zendesk.com/api/v2"
  auth: Basic (email:api_token)
  key_endpoints:
    - GET /users               # Elenco utenti
    - GET /tickets             # Ticket di supporto
    - GET /organizations       # Organizzazioni