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 |
메타데이터와 함께 Canvas 목록을 내보냅니다. |
get_canvas_details |
/canvas/details |
특정 Canvas에 대한 상세 정보를 가져옵니다. |
get_canvas_data_summary |
/canvas/data_summary |
Canvas 성과에 대한 요약 분석을 가져옵니다. |
get_canvas_data_series |
/canvas/data_series |
Canvas에 대한 시계열 분석 데이터를 검색합니다. |
카탈로그
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
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
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_content_blocks_list |
/content_blocks/list |
사용 가능한 콘텐츠 블록을 나열합니다. |
get_content_blocks_info |
/content_blocks/info |
콘텐츠 블록에 대한 정보를 가져옵니다. |
커스텀 속성
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
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 |
앱 삭제 시계열 데이터입니다. |
미디어 라이브러리
이것은 Braze MCP 서버의 유일한 쓰기 기능입니다. 이 기능을 사용하려면 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 |
구독 그룹에서 사용자의 구독 상태를 가져옵니다. |
템플릿
| 기능 | 엔드포인트 | 설명 |
|---|---|---|
get_email_templates_list |
/templates/email/list |
사용 가능한 이메일 템플릿을 나열합니다. |
get_email_template_info |
/templates/email/info |
이메일 템플릿에 대한 정보를 가져옵니다. |
Disclaimer
모델 컨텍스트 프로토콜(MCP)은 새로 도입된 오픈 소스 프로토콜로, 현재 보안 문제나 취약점에 노출될 수 있습니다.
Braze MCP 서버 설정 코드 및 지침은 Braze에서 “있는 그대로” 어떠한 보증 없이 제공되며, 고객은 자신의 위험 부담 하에 사용합니다. Braze는 부적절한 설정, MCP의 오용 또는 발생할 수 있는 잠재적인 보안 문제로 인한 모든 결과에 대해 책임을 지지 않습니다. Braze는 고객이 구성을 신중하게 검토하고, Braze 환경의 무결성 및 보안과 관련된 위험을 줄이기 위해 안내된 지침을 따를 것을 강력히 권장합니다.
도움이나 추가 설명이 필요하시면 Braze 고객지원으로 문의해 주세요.