Braze MCP 서버 기능
Braze MCP 서버는 특정 Braze REST API 엔드포인트에 매핑되는 API 기능 세트를 노출합니다. Claude 및 Cursor와 같은 MCP 클라이언트는 이러한 기능을 호출하여 비PII 데이터를 검색하고, 적절한 권한이 있는 경우 비PII 쓰기 동작을 수행할 수 있습니다. 더 일반적인 정보는 Braze MCP 서버를 참조하세요.
로컬 호스팅 Braze MCP 서버(베타)는 올여름 서비스 종료 예정입니다. 기존 기능은 계속 작동하지만, 더 이상 엔드포인트를 추가하거나 베타를 지원하지 않습니다. 원격 Braze 호스팅 MCP 서버가 올여름 얼리 액세스로 제공될 예정입니다.
필수 조건
이 기능을 사용하려면 먼저 Braze MCP 서버를 설정해야 합니다.
사용 가능한 Braze API 기능
MCP 클라이언트는 다음 API 기능을 참조하여 Braze MCP 서버와 상호작용합니다.
일반 기능
이 기능들은 MCP 클라이언트가 사용 가능한 Braze API 기능을 검색하고 실행하는 데 도움을 줍니다.
| 기능 | 설명 |
|---|---|
list_functions |
설명 및 매개변수와 함께 사용 가능한 모든 Braze API 기능을 나열합니다. |
call_function |
제공된 매개변수로 특정 읽기 전용 Braze API 기능을 호출합니다. |
call_write_function |
제공된 매개변수로 특정 쓰기 가능 Braze API 기능을 호출합니다. |
Campaigns
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_campaign_list |
/campaigns/list |
메타데이터와 함께 Campaign 목록을 내보냅니다. |
get_campaign_details |
/campaigns/details |
특정 Campaign에 대한 상세 정보를 가져옵니다. |
get_campaign_dataseries |
/campaigns/data_series |
Campaign에 대한 시계열 분석 데이터를 검색합니다. |
Canvases
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_canvas_list |
/canvas/list |
메타데이터와 함께 Canvases 목록을 내보냅니다. |
get_canvas_details |
/canvas/details |
특정 Canvas에 대한 상세 정보를 가져옵니다. |
get_canvas_data_summary |
/canvas/data_summary |
Canvas 성과에 대한 요약 분석을 가져옵니다. |
get_canvas_data_series |
/canvas/data_series |
Canvases에 대한 시계열 분석 데이터를 검색합니다. |
카탈로그
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_catalogs |
/catalogs |
워크스페이스의 카탈로그 목록을 반환합니다. |
get_catalog_items |
/catalogs/{catalog_name}/items |
페이지네이션을 지원하여 여러 카탈로그 항목 및 해당 콘텐츠를 반환합니다. |
get_catalog_item |
/catalogs/{catalog_name}/items/{item_id} |
ID로 특정 카탈로그 항목 및 해당 콘텐츠를 반환합니다. |
클라우드 데이터 수집
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
list_integrations |
/cdi/integrations |
기존 CDI 통합 목록을 반환합니다. |
get_integration_job_sync_status |
/cdi/integrations/{integration_id}/job_sync_status |
지정된 CDI 통합에 대한 과거 동기화 상태를 반환합니다. |
Content Blocks
create_content_block 및 update_content_block 기능은 쓰기 기능입니다. MCP 클라이언트는 call_write_function으로 이를 호출해야 하며, API 키에 해당하는 content_blocks.create 또는 content_blocks.update 권한이 있어야 합니다.
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_content_blocks_list |
/content_blocks/list |
사용 가능한 콘텐츠 블록을 나열합니다. |
get_content_blocks_info |
/content_blocks/info |
콘텐츠 블록에 대한 정보를 가져옵니다. |
create_content_block |
/content_blocks/create |
콘텐츠 블록을 생성합니다. name 및 content가 필수입니다. 선택 필드로 description, state(active 또는 draft여야 함), tags가 있습니다. |
update_content_block |
/content_blocks/update |
기존 콘텐츠 블록을 업데이트합니다. content_block_id와 하나 이상의 업데이트 가능한 필드(name, content, description, state(active 또는 draft여야 함), tags)가 필요합니다. |
커스텀 속성
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_custom_attributes |
/custom_attributes |
앱에 기록된 커스텀 속성을 내보냅니다. |
이벤트
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_events_list |
/events/list |
앱에 기록된 커스텀 이벤트 목록을 내보냅니다. |
get_events_data_series |
/events/data_series |
커스텀 이벤트에 대한 시계열 데이터를 검색합니다. |
get_events |
/events |
페이지네이션을 지원하는 상세 이벤트 데이터를 가져옵니다. |
KPI
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_new_users_data_series |
/kpi/new_users/data_series |
일일 신규 사용자 수 시리즈입니다. |
get_dau_data_series |
/kpi/dau/data_series |
일일 활성 사용자 시계열 데이터입니다. |
get_mau_data_series |
/kpi/mau/data_series |
월간 활성 사용자 시계열 데이터입니다. |
get_uninstalls_data_series |
/kpi/uninstalls/data_series |
앱 삭제 시계열 데이터입니다. |
미디어 라이브러리
create_media_library_asset 기능은 쓰기 기능입니다. MCP 클라이언트는 call_write_function으로 이를 호출해야 하며, API 키에 media_library.create 권한이 있어야 합니다.
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
create_media_library_asset |
/media_library/create |
Braze 미디어 라이브러리에 자산을 업로드합니다. 공개적으로 접근 가능한 URL(asset_url) 또는 base64로 인코딩된 파일(asset_file_base64) 중 하나를 제공할 수 있지만, 둘 다 동시에 제공할 수는 없습니다. 이미지 크기 제한은 5MB입니다. |
메시지
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_scheduled_broadcasts |
/messages/scheduled_broadcasts |
예정된 Campaigns 및 Canvases 목록을 나열합니다. |
환경설정 센터
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_preference_centers |
/preference_center/v1/list |
사용 가능한 환경설정 센터를 나열합니다. |
get_preference_center_details |
/preference_center/v1/{preferenceCenterExternalID} |
HTML 콘텐츠 및 옵션을 포함한 특정 환경설정 센터의 세부 정보를 봅니다. |
구매
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_product_list |
/purchases/product_list |
페이지네이션된 제품 ID 목록을 내보냅니다. |
get_revenue_series |
/purchases/revenue_series |
매출 분석 시계열 데이터입니다. |
get_quantity_series |
/purchases/quantity_series |
구매 수량 시계열 데이터입니다. |
Segments
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_segment_list |
/segments/list |
분석 추적 상태가 포함된 Segment 목록을 내보냅니다. |
get_segment_data_series |
/segments/data_series |
Segment에 대한 시계열 분석 데이터입니다. |
get_segment_details |
/segments/details |
특정 Segment에 대한 상세 정보입니다. |
전송
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_send_data_series |
/sends/data_series |
추적된 Campaign 전송에 대한 일일 분석입니다. |
세션
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_session_data_series |
/sessions/data_series |
앱 세션 수에 대한 시계열 데이터입니다. |
SDK 인증 키
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_sdk_authentication_keys |
/app_group/sdk_authentication/keys |
앱에 대한 모든 SDK 인증 키를 나열합니다. |
구독
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_user_subscription_groups |
/subscription/user/status |
특정 사용자의 구독 그룹을 나열하고 가져옵니다. |
get_subscription_group_status |
/subscription/status/get |
구독 그룹에서 사용자의 구독 상태를 가져옵니다. |
템플릿
create_email_template 및 update_email_template 기능은 쓰기 기능입니다. MCP 클라이언트는 call_write_function으로 이를 호출해야 하며, API 키에 해당하는 templates.email.create 또는 templates.email.update 권한이 있어야 합니다.
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_email_templates_list |
/templates/email/list |
사용 가능한 이메일 템플릿을 나열합니다. |
get_email_template_info |
/templates/email/info |
이메일 템플릿에 대한 정보를 가져옵니다. |
create_email_template |
/templates/email/create |
이메일 템플릿을 생성합니다. template_name, subject, body가 필수입니다. 선택 필드로 plaintext_body, preheader, tags, should_inline_css가 있습니다. |
update_email_template |
/templates/email/update |
기존 이메일 템플릿을 업데이트합니다. email_template_id와 하나 이상의 업데이트 가능한 필드(template_name, subject, body, plaintext_body, preheader, tags, should_inline_css)가 필요합니다. |
Disclaimer
모델 컨텍스트 프로토콜(MCP)은 새로 도입된 오픈 소스 프로토콜로, 현재 보안 문제나 취약점에 노출될 수 있습니다.
Braze MCP 서버 설정 코드 및 지침은 Braze에서 “있는 그대로” 어떠한 보증 없이 제공되며, 고객은 자신의 위험 부담 하에 사용합니다. Braze는 부적절한 설정, MCP의 오용 또는 발생할 수 있는 잠재적인 보안 문제로 인한 모든 결과에 대해 책임을 지지 않습니다. Braze는 고객이 구성을 신중하게 검토하고, Braze 환경의 무결성 및 보안과 관련된 위험을 줄이기 위해 안내된 지침을 따를 것을 강력히 권장합니다.
도움이나 추가 설명이 필요하시면 Braze 고객지원으로 문의해 주세요.