Braze MCP 서버 기능

Braze MCP 서버는 특정 Braze REST API 엔드포인트에 매핑되는 API 기능 세트를 노출합니다. Claude 및 Cursor와 같은 MCP 클라이언트는 이러한 기능을 호출하여 비PII 데이터를 검색하고, 적절한 권한이 있는 경우 비PII 쓰기 동작을 수행할 수 있습니다. 더 일반적인 정보는 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 고객지원으로 문의해 주세요.