On this page

Brevo MCP сървър

Brevo предоставя официален хостван MCP сървър на mcp.brevo.com, излагащ 27 модула, контакти, кампании, сделки, шаблони, WhatsApp, SMS и много повече, като инструменти, които всеки AI агент може да извика. Не е необходима локална инсталация.

Tip

Brevo MCP сървърът използва Model Context Protocol (MCP), отворен стандарт на Anthropic, свързващ AI асистентите с външни инструменти и услуги.

Бърз старт

1. Вземете вашия MCP токен

Brevo MCP използва специален MCP токен (не стандартен API ключ):

Влезте в app.brevo.com
Отидете на Account > SMTP & API > API Keys
Щракнете Generate a new API key и активирайте Create MCP server API key
Копирайте и съхранете токена сигурно

Caution

Вашият MCP токен предоставя пълен достъп за четене/запис до вашия акаунт в Brevo. Никога не го записвайте в контрол на версиите или не го споделяйте публично.

2. Свържете вашия AI инструмент

Добавете към конфигурационния файл на 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": "paste-your-mcp-token-here"
      }
    }
  }
}

Рестартирайте Claude Desktop след запазване. Изисква инсталиран Node.js.

Добавете към ~/.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": "paste-your-mcp-token-here"
      }
    }
  }
}

Проверете с:

claude mcp list

Добавете към ~/.cursor/mcp.json (глобално) или .cursor/mcp.json (за проект):

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

Добавете към .vscode/mcp.json (за проект) или mcp.json на ниво потребител:

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

Добавете към ~/.codeium/windsurf/mcp_config.json:

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

3. Тествайте връзката

След свързване попитайте вашия AI асистент:

> Колко контакта имам?
> Създайте имейл кампания за пускането на моя продукт
> Покажи ми сделките в етап "Преговори"
> Добавете контакт към моя списък за бюлетин

Налични сървъри

Основният сървър на /v1/brevo/mcp включва всичките 27 модула. За по-добро качество на отговорите при фокусирани случаи на употреба, свържете се към отделни сървъри, даващи на AI по-малък, по-насочен набор от инструменти.

Основен сървър

Крайна точка	Описание
`https://mcp.brevo.com/v1/brevo/mcp`	Всички функции комбинирани (27 модула)

Отделни сървъри

Свържете само модулите, необходими на вашия агент. Това подобрява качеството на AI отговорите чрез намаляване на повърхността на инструментите.

Контакти и CRM

Сървър	Крайна точка	Предназначение
contacts	`/v1/brevo_contacts/mcp`	Управление на контакти и списъци
lists	`/v1/brevo_lists/mcp`	Управление на списъци с контакти
segments	`/v1/brevo_segments/mcp`	Управление на сегменти на контакти
attributes	`/v1/brevo_attributes/mcp`	Управление на атрибути на контакти
groups	`/v1/brevo_groups/mcp`	Управление на групи на контакти
contact_import_export	`/v1/brevo_contact_import_export/mcp`	Масов внос/износ на контакти

Кампании и съобщения

Сървър	Крайна точка	Предназначение
email_campaign_management	`/v1/brevo_email_campaign_management/mcp`	Създаване и управление на имейл кампании
campaign_analytics	`/v1/brevo_campaign_analytics/mcp`	Преглед на представянето на кампании
templates	`/v1/brevo_templates/mcp`	Управление на имейл шаблони
transac_templates	`/v1/brevo_transac_templates/mcp`	Управление на транзакционни имейл шаблони
sms_campaigns	`/v1/brevo_sms_campaigns/mcp`	Създаване и изпращане на SMS кампании
whatsapp_campaigns	`/v1/brevo_whatsapp_campaigns/mcp`	Създаване и изпращане на WhatsApp кампании
whatsapp_management	`/v1/brevo_whatsapp_management/mcp`	Конфигурация на WhatsApp настройки

Продажби CRM

Сървър	Крайна точка	Предназначение
deals	`/v1/brevo_deals/mcp`	Управление на CRM сделки
companies	`/v1/brevo_companies/mcp`	Управление на CRM компании
tasks	`/v1/brevo_tasks/mcp`	Управление на CRM задачи
pipelines	`/v1/brevo_pipelines/mcp`	Конфигурация на CRM тръбопроводи
notes	`/v1/brevo_notes/mcp`	Добавяне на бележки към контакти и сделки

Акаунт и настройки

Сървър	Крайна точка	Предназначение
senders	`/v1/brevo_senders/mcp`	Управление на идентичности на подателя
domains	`/v1/brevo_domains/mcp`	Управление на домейни на подателя
ips	`/v1/brevo_ips/mcp`	Управление на специализирани IP адреси
accounts	`/v1/brevo_accounts/mcp`	Управление на акаунт и подакаунти
users	`/v1/brevo_users/mcp`	Управление на потребители и разрешения
webhooks_management	`/v1/brevo_webhooks_management/mcp`	Конфигурация на webhook-и
external_feeds	`/v1/brevo_external_feeds/mcp`	Управление на RSS потоци
folders	`/v1/brevo_folders/mcp`	Организиране на кампании в папки
processes	`/v1/brevo_processes/mcp`	Наблюдение на фонови процеси

Всички крайни точки използват базовия URL https://mcp.brevo.com.

Обхват на инструменти за агенти

За агентите на Tajo свържете само сървърите, необходими на вашия агент. Така прилагате обхват на разрешения, всеки агент получава различен набор от MCP сървъри.

Пример: Агент за възстановяване на количка

Този агент се нуждае само от контакти, имейл кампании и 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" }
    }
  }
}

Пример: Агент за CRM продажби

Този агент работи само със сделки и компании:

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

Tajo стои между вашето намерение и MCP инструментите на Brevo. Потокът на оркестрация:

Намерение на маркетолога
    "Спечели обратно клиенти, неправили поръчка от 90 дни"
        ↓
Слой агенти на Tajo
    Избира: Агент за спечелване обратно
    Агентът чете своята спецификация: инструменти, ограничения, стратегия
        ↓
MCP инструменти на Brevo
    brevo_contacts → намиране на напуснали клиенти
    brevo_segments → създаване на целеви сегмент
    brevo_email    → изпращане на кампания за възстановяване
    brevo_sms      → SMS проследяване за неотварящи
        ↓
Платформа Brevo
    Доставени имейли, изпратени SMS-и, проследени събития

Всяка спецификация на агент в Tajo декларира кои MCP сървъри на Brevo са му необходими. Оркестриращият слой свързва само тези сървъри, прилагайки достъп с минимални привилегии.

Отстраняване на неизправности

”Command not found: npx”

Инсталирайте Node.js. Мостът npx mcp-remote е необходим за Claude Desktop и Claude Code.

Инструментите не се появяват

Рестартирайте приложението напълно (не само презареждане)
Проверете дали вашият JSON няма синтактични грешки (запетаи в края, липсващи скоби)
Проверете дали вашият MCP токен няма допълнителни интервали

Грешки при удостоверяване

Проверете дали вашият MCP токен е все още активен в Brevo Dashboard > SMTP & API
Потвърдете, че заглавката Authorization е форматирана като Bearer <token> с интервал

Следващи стъпки

Изграждане на първия ви агент, Използване на MCP инструментите на Brevo за изграждане на маркетингов агент
Формат на спецификация на агент, Дефиниране на персонализирани агенти с обхван достъп до инструменти
Справочник за умения, Вижте как уменията на Tajo се съставят върху MCP инструменти
Официална документация на Brevo, Пълна документация на Brevo MCP

Brevo MCP сървър