Braze MCP 서버 사용하기
Claude 및 Cursor와 같은 자연어 도구를 사용하여 Braze 데이터와 상호작용하는 방법을 배우세요. 더 일반적인 정보는 Braze MCP 서버를 참조하세요.

로컬 호스팅 Braze MCP 서버(베타)는 올여름 서비스 종료 예정입니다. 기존 기능은 계속 작동하지만, 더 이상 엔드포인트를 추가하거나 베타를 지원하지 않습니다. 원격 Braze 호스팅 MCP 서버가 올여름 얼리 액세스로 제공될 예정입니다.
필수 조건
이 기능을 사용하려면 먼저 Braze MCP 서버 설정을 완료해야 합니다.
모범 사례
Claude 및 Cursor와 같은 자연어 도구를 통해 Braze MCP 서버를 사용할 때 최상의 결과를 얻기 위해 다음 팁을 염두에 두세요:
- LLM은 실수를 할 수 있으므로 항상 답변을 다시 확인하세요.
- 데이터 분석 시 필요한 시간 범위를 명확히 지정하세요. 짧은 범위가 더 정확한 결과를 제공하는 경우가 많습니다.
- 정확한 Braze 용어를 사용하여 LLM이 올바른 함수를 호출하도록 하세요.
- 결과가 불완전해 보이면 LLM에게 계속 진행하거나 더 깊이 파고들도록 요청하세요.
- 창의적인 프롬프트를 시도해 보세요! MCP 클라이언트에 따라 CSV 또는 기타 유용한 파일을 내보낼 수 있습니다.
사용 예시
Braze MCP 서버를 설정한 후, Claude 또는 Cursor와 같은 도구를 사용하여 자연어로 Braze와 상호작용할 수 있습니다. 시작하는 데 도움이 되는 몇 가지 예시입니다:
내가 사용할 수 있는 Braze 함수는 무엇인가요?
예시 프롬프트
What are my available Braze functions?
예시 응답
list_functions를 사용하여 Braze MCP 서버를 확인한 결과 38개의 사용 가능한 API 함수를 찾았습니다.
다음은 카테고리별 몇 가지 예시입니다:
- Campaign 분석 및 관리
get_campaign_dataseriesget_campaign_detailsget_campaign_list
- Canvas 분석 및 관리
get_canvas_data_seriesget_canvas_data_summaryget_canvas_listget_canvas_details
- 템플릿
create_email_template
- 콘텐츠 블록
create_content_blockget_content_blocksget_content_block_infoupdate_content_block
예시 프롬프트
What are my available Braze functions?
예시 응답
Braze MCP 서버를 사용하여 사용 가능한 함수를 확인하겠습니다.
list_functions호출 완료
결과에 따르면, 다음과 같은 카테고리로 구성된 38개의 Braze API 함수를 사용할 수 있습니다:
- Campaign 분석 및 관리
- Canvas 분석 및 관리
- 템플릿
- 콘텐츠 블록
예시 함수:
get_campaign_listget_canvas_listget_canvas_detailscreate_email_templateupdate_content_block
list_functions 함수에 대한 자세한 내용은 사용 가능한 API 함수를 참조하세요.
Canvas ID에 대한 세부 정보 가져오기
예시 프롬프트
Get details about canvas ID YOUR-TEST-CANVAS-ID-123
예시 응답
get_canvas_details를 사용하여 YOUR-TEST-CANVAS-ID-123의 세부 정보를 가져왔습니다.
- Canvas 이름:
YOUR-TEST-CANVAS-NAME - ID:
YOUR-TEST-CANVAS-ID-123 - 상태: 초안 (활성화되지 않음)
- 생성일: 2026년 1월 15일 오전 10:30 UTC
- 마지막 업데이트: 2026년 1월 16일 오후 02:45 UTC
- 스케줄 유형: 시간 기반
- 기본 채널: 이메일
이메일 메시지 세부 정보:
- 제목:
YOUR-TEST-SUBJECT-LINE - 발신자:
[email protected] - 메시지 ID:
YOUR-TEST-MESSAGE-ID-123
예시 프롬프트
Get details about canvas ID YOUR-TEST-CANVAS-ID-123
예시 응답
get_canvas_details를 사용하여 이 Canvas를 가져왔습니다:
- Canvas ID:
YOUR-TEST-CANVAS-ID-123 - Canvas 이름:
YOUR-TEST-CANVAS-NAME - 상태: 초안
- 채널: 이메일
- 메시지 ID:
YOUR-TEST-MESSAGE-ID-123
이메일 콘텐츠 요약:
- 브랜드 이미지가 포함된 헤더 섹션
- 메인 헤드라인 섹션
- CTA 버튼이 포함된 히어로 섹션
- 보조 콘텐츠가 포함된 기능 섹션
get_canvas_details 함수에 대한 자세한 내용은 사용 가능한 API 함수를 참조하세요.
최근 Canvases 보기
예시 프롬프트
Show me my recent Canvases
예시 응답
list_functions로 사용 가능한 도구를 확인한 후 get_canvas_list를 사용하여 가장 최근에 편집된 Canvases를 가져왔습니다.
최근 Canvases:
- YOUR-TEST-CANVAS-ALPHA
- ID:
YOUR-TEST-ID-123 - 마지막 수정일: 2026년 1월 16일 오후 02:45 UTC
- ID:
- YOUR-TEST-CANVAS-BETA
- ID:
YOUR-TEST-ID-456 - 마지막 수정일: 2026년 1월 15일 오전 11:10 UTC
- ID:
- YOUR-TEST-CANVAS-GAMMA
- ID:
YOUR-TEST-ID-789 - 마지막 수정일: 2026년 1월 14일 오후 08:25 UTC
- ID:
예시 프롬프트
Show me my recent Canvases
예시 응답
Braze MCP 서버에서 최근 Canvas 목록을 가져오겠습니다.
list_functions호출 완료get_canvas_list호출 완료
최근 Canvases (최근 편집순 정렬):
- Canvas 이름:
YOUR-TEST-CANVAS-ALPHA- 마지막 수정일: 2026년 1월 16일 오후 02:45 UTC
- Canvas ID:
YOUR-TEST-ID-123 - 태그:
lifecycle,email
- Canvas 이름:
YOUR-TEST-CANVAS-BETA- 마지막 수정일: 2026년 1월 15일 오전 11:10 UTC
- Canvas ID:
YOUR-TEST-ID-456 - 태그:
promo
get_canvas_list 함수에 대한 자세한 내용은 사용 가능한 API 함수를 참조하세요.
이메일 템플릿 생성하기
예시 프롬프트
Create an email template named "YOUR-TEST-TEMPLATE-NAME" for onboarding messages.
예시 응답
create_email_template을 사용하여 템플릿을 생성했습니다.
- 템플릿 이름:
YOUR-TEST-TEMPLATE-NAME - 템플릿 ID:
YOUR-TEST-TEMPLATE-ID-123 - 제목란:
YOUR-TEST-SUBJECT-LINE - 프리헤더:
YOUR-TEST-PREHEADER - 생성일: 2026년 1월 16일 오후 03:10 UTC
이제 Campaigns 및 Canvases를 생성하거나 업데이트할 때 YOUR-TEST-TEMPLATE-ID-123을 참조할 수 있습니다.
예시 프롬프트
Create an email template named "YOUR-TEST-TEMPLATE-NAME" for onboarding messages.
예시 응답
create_email_template을 사용하여 새 템플릿을 성공적으로 생성했습니다.
- 템플릿 ID:
YOUR-TEST-TEMPLATE-ID-123 - 템플릿 이름:
YOUR-TEST-TEMPLATE-NAME - 제목:
YOUR-TEST-SUBJECT-LINE - 설명:
Onboarding lifecycle template
원하시면 이 템플릿에 대한 기본 HTML 본문과 일반 텍스트 대체 콘텐츠도 생성할 수 있습니다.
create_email_template 함수에 대한 자세한 내용은 사용 가능한 API 함수를 참조하세요.
콘텐츠 블록 업데이트하기
예시 프롬프트
Update content block "YOUR-TEST-CONTENT-BLOCK-ID-123" with new body copy for our spring promotion.
예시 응답
update_content_block을 사용하여 콘텐츠 블록을 업데이트했습니다.
- 콘텐츠 블록 ID:
YOUR-TEST-CONTENT-BLOCK-ID-123 - 이름:
YOUR-TEST-CONTENT-BLOCK-NAME - 상태: 업데이트됨
- 업데이트 일시: 2026년 1월 16일 오후 03:25 UTC
미리보기:
YOUR-TEST-CONTENT-BLOCK-BODY-V2
예시 프롬프트
Update content block "YOUR-TEST-CONTENT-BLOCK-ID-123" with new body copy for our spring promotion.
예시 응답
update_content_block을 실행하여 업데이트가 완료되었음을 확인했습니다.
- 콘텐츠 블록 ID:
YOUR-TEST-CONTENT-BLOCK-ID-123 - 이전 버전:
v1 - 현재 버전:
v2 - 마지막 업데이트: 2026년 1월 16일 오후 03:25 UTC
업데이트된 콘텐츠 미리보기:
YOUR-TEST-CONTENT-BLOCK-BODY-V2
update_content_block 함수에 대한 자세한 내용은 사용 가능한 API 함수를 참조하세요.
Disclaimer
모델 컨텍스트 프로토콜(MCP)은 새로 도입된 오픈 소스 프로토콜로, 현재 보안 문제나 취약점에 노출될 수 있습니다.
Braze MCP 서버 설정 코드 및 지침은 Braze에서 “있는 그대로” 어떠한 보증 없이 제공되며, 고객은 자신의 위험 부담 하에 사용합니다. Braze는 부적절한 설정, MCP의 오용 또는 발생할 수 있는 잠재적인 보안 문제로 인한 모든 결과에 대해 책임을 지지 않습니다. Braze는 고객이 구성을 신중하게 검토하고, Braze 환경의 무결성 및 보안과 관련된 위험을 줄이기 위해 안내된 지침을 따를 것을 강력히 권장합니다.
도움이나 추가 설명이 필요하시면 Braze 고객지원으로 문의해 주세요.