Brevo MCP 서버
Brevo는 mcp.brevo.com에서 공식 호스팅 MCP 서버를 제공합니다. 연락처, 캠페인, 딜, 템플릿, WhatsApp, SMS 등 27개 모듈을 모든 AI 에이전트가 호출할 수 있는 도구로 노출하며, 별도의 로컬 설치가 필요 없습니다.
Tip
Brevo MCP 서버는 Model Context Protocol (MCP)을 사용합니다. AI 어시스턴트를 외부 도구 및 서비스에 연결하는 Anthropic의 개방형 표준입니다.
빠른 시작
1. MCP 토큰 발급받기
Brevo MCP는 일반 API 키가 아닌 전용 MCP 토큰을 사용합니다.
- app.brevo.com에 로그인합니다
- Account > SMTP & API > API Keys로 이동합니다
- Generate a new API key를 클릭하고 Create MCP server API key를 켭니다
- 토큰을 복사해 안전하게 보관합니다
Caution
MCP 토큰은 Brevo 계정에 대한 전체 읽기/쓰기 권한을 부여합니다. 버전 관리 시스템에 커밋하거나 공개적으로 공유하지 마세요.
2. AI 도구 연결하기
3. 연결 테스트하기
연결이 완료되면 AI 어시스턴트에게 이렇게 물어보세요.
> 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사용 가능한 서버
/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 | 웹훅 구성 |
| 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는 사용자의 의도와 Brevo MCP 도구 사이에 자리합니다. 오케스트레이션 흐름은 다음과 같습니다.
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 trackedTajo 에이전트 명세는 각각 필요한 Brevo MCP 서버를 선언합니다. 오케스트레이션 계층은 선언된 서버만 연결해 최소 권한 원칙을 강제합니다.
문제 해결
”Command not found: npx”
Node.js를 설치하세요. Claude Desktop과 Claude Code에는 npx mcp-remote 브리지가 필요합니다.
도구가 나타나지 않음
- 애플리케이션을 다시 로드하지 말고 완전히 재시작하세요
- JSON에 문법 오류(후행 쉼표, 누락된 괄호)가 없는지 확인하세요
- MCP 토큰에 불필요한 공백이 없는지 확인하세요
인증 오류
- Brevo 대시보드 > SMTP & API에서 MCP 토큰이 여전히 활성 상태인지 확인하세요
Authorization헤더가 공백을 포함한Bearer <token>형식인지 확인하세요
다음 단계
- 첫 에이전트 만들기, Brevo MCP 도구로 마케팅 에이전트를 구축합니다
- 에이전트 명세 형식, 도구 접근 범위를 지정한 커스텀 에이전트를 정의합니다
- 스킬 레퍼런스, Tajo Skills가 MCP 도구 위에 어떻게 결합되는지 살펴봅니다
- Brevo 공식 문서, Brevo MCP 전체 문서