Tajo 사전 이용 신청

이름과 이메일 주소 또는 전화번호를 입력해 주세요. Tajo 이용 방법을 안내해 드립니다.

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 토큰을 사용합니다.

  1. app.brevo.com에 로그인합니다
  2. Account > SMTP & API > API Keys로 이동합니다
  3. Generate a new API key를 클릭하고 Create MCP server API key를 켭니다
  4. 토큰을 복사해 안전하게 보관합니다

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/mcpSMS 캠페인 생성 및 발송
whatsapp_campaigns/v1/brevo_whatsapp_campaigns/mcpWhatsApp 캠페인 생성 및 발송
whatsapp_management/v1/brevo_whatsapp_management/mcpWhatsApp 설정 구성

세일즈 CRM

서버엔드포인트용도
deals/v1/brevo_deals/mcpCRM 딜 관리
companies/v1/brevo_companies/mcpCRM 회사 관리
tasks/v1/brevo_tasks/mcpCRM 업무 관리
pipelines/v1/brevo_pipelines/mcpCRM 파이프라인 구성
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/mcpRSS 피드 관리
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 tracked

Tajo 에이전트 명세는 각각 필요한 Brevo MCP 서버를 선언합니다. 오케스트레이션 계층은 선언된 서버만 연결해 최소 권한 원칙을 강제합니다.

문제 해결

”Command not found: npx”

Node.js를 설치하세요. Claude Desktop과 Claude Code에는 npx mcp-remote 브리지가 필요합니다.

도구가 나타나지 않음

  • 애플리케이션을 다시 로드하지 말고 완전히 재시작하세요
  • JSON에 문법 오류(후행 쉼표, 누락된 괄호)가 없는지 확인하세요
  • MCP 토큰에 불필요한 공백이 없는지 확인하세요

인증 오류

  • Brevo 대시보드 > SMTP & API에서 MCP 토큰이 여전히 활성 상태인지 확인하세요
  • Authorization 헤더가 공백을 포함한 Bearer <token> 형식인지 확인하세요

다음 단계

Tajo 사전 이용 신청

이름과 이메일 주소 또는 전화번호를 입력해 주세요. Tajo 이용 방법을 안내해 드립니다.

자동 감지
AI 어시스턴트

안녕하세요! 문서에 대해 무엇이든 물어보세요.