Brevo MCP Server

Brevo, mcp.brevo.com adresinde resmi ve barındırılan bir MCP sunucusu sunar. Bu sunucu 27 modülü, yani kişileri, kampanyaları, anlaşmaları, şablonları, WhatsApp’ı, SMS’i ve daha fazlasını, herhangi bir AI ajanının çağırabileceği araçlar olarak açar. Yerel kurulum gerekmez.

Hızlı Başlangıç

1. MCP Token’ınızı Alın

Brevo MCP, standart bir API anahtarı yerine kendine özel bir MCP token’ı kullanır:

1. app.brevo.com adresinde oturum açın
2. Account > SMTP & API > API Keys bölümüne gidin
3. Generate a new API key düğmesine tıklayın ve Create MCP server API key seçeneğini açın
4. Token’ınızı kopyalayın ve güvenli biçimde saklayın

2. AI Aracınızı Bağlayın

{
  "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. Bağlantıyı Test Edin

Bağlantı kurulduktan sonra AI asistanınıza sorun:

> 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

Kullanılabilir Sunucular

/v1/brevo/mcp adresindeki ana sunucu 27 modülün tamamını içerir. Odaklı kullanım senaryolarında daha iyi yanıt kalitesi almak için, AI’nıza daha küçük ve daha hedefli bir araç seti veren bireysel sunuculara bağlanın.

Ana Sunucu

Bireysel Sunucular

Yalnızca ajanınızın ihtiyaç duyduğu modülleri bağlayın. Bu, araç yüzeyini küçülterek AI yanıt kalitesini artırır.

Kişiler ve CRM

Kampanyalar ve Mesajlaşma

Sales CRM

Hesap ve Ayarlar

Tüm endpoint’ler https://mcp.brevo.com temel URL’sini kullanır.

Ajanlar İçin Araçları Kapsamlandırma

Tajo ajanlarında yalnızca ajanınızın ihtiyaç duyduğu sunucuları bağlayın. İzin kapsamlandırmasını böyle uygularsınız, her ajan farklı bir MCP sunucusu kümesi alır.

Örnek: Sepet Kurtarma Ajanı

Bu ajanın yalnızca kişilere, e-posta kampanyalarına ve SMS’e ihtiyacı vardır:

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

Örnek: Sales CRM Ajanı

Bu ajan yalnızca anlaşmalar ve şirketlerle çalışır:

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

Tajo, Brevo MCP’yi Nasıl Kullanır

Tajo, sizin amacınız ile Brevo’nun MCP araçları arasında konumlanır. Orkestrasyon akışı şöyledir:

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

Her Tajo ajan spesifikasyonu, hangi Brevo MCP sunucularına ihtiyaç duyduğunu bildirir. Orkestrasyon katmanı yalnızca bu sunucuları bağlayarak en az ayrıcalık erişimini uygular.

Sorun Giderme

”Command not found: npx”

Node.js kurun. npx mcp-remote köprüsü Claude Desktop ve Claude Code için gereklidir.

Araçlar görünmüyor

• Uygulamanızı tamamen yeniden başlatın (yalnızca yeniden yüklemeyin)
• JSON’unuzda sözdizimi hatası olmadığını doğrulayın (sondaki virgüller, eksik parantezler)
• MCP token’ınızda fazladan boşluk olmadığını kontrol edin

Kimlik doğrulama hataları

• MCP token’ınızın Brevo Dashboard > SMTP & API altında hâlâ etkin olduğunu doğrulayın
• Authorization başlığının aralarında boşlukla Bearer <token> biçiminde yazıldığını onaylayın

Sonraki Adımlar

• İlk Ajanınızı Oluşturma, Pazarlama ajanı oluşturmak için Brevo MCP araçlarını kullanın
• Ajan Spesifikasyonu Biçimi, Kapsamlandırılmış araç erişimiyle özel ajanlar tanımlayın
• Skills Referansı, Tajo Skills’in MCP araçlarının üzerine nasıl kurulduğunu görün
• Resmi Brevo Belgeleri, Brevo MCP belgelerinin tamamı