Braze MCP 서버 기능
Braze MCP 서버는 특정 Braze REST API 엔드포인트에 매핑되는 API 기능 세트를 노출합니다. Claude 및 Cursor와 같은 MCP 클라이언트는 이러한 기능을 호출하여 비PII 데이터를 검색하고, 적절한 권한이 있는 경우 비PII 쓰기 동작을 수행할 수 있습니다. 더 일반적인 정보는 Braze MCP 서버를 참조하세요.
Braze MCP 서버는 베타 버전입니다. 사용하기 위해 별도의 액세스 요청은 필요하지 않습니다. 설정 안내에 따라 시작하세요. Braze MCP 서버를 사용하면 Braze 베타 약관에 동의하는 것으로 간주됩니다. 더 나은 제품을 만들 수 있도록 [email protected]으로 피드백을 보내주세요.
필수 조건
이 기능을 사용하려면 먼저 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 고객지원으로 문의해 주세요.