이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.

Braze MCP 서버 기능

Braze MCP 서버는 특정 Braze REST API 엔드포인트에 매핑되는 읽기 및 쓰기 도구를 노출합니다. 자세한 내용은 Braze MCP 서버를 참조하세요.

중요

로컬 호스팅 Braze MCP 서버(베타)는 지원 종료되었으며 추가 업데이트는 제공되지 않습니다.

참고

Braze MCP 서버에는 베타 프로그램에 참여 중인 고객만 사용할 수 있는 도구가 포함되어 있습니다. 베타 프로그램에 포함된 도구에 접근하려 할 때 계정에 해당 기능이 활성화되어 있지 않으면 오류 응답을 받을 수 있습니다. 베타 프로그램에 참여하려면 계정 매니저에게 문의하세요.

사전 요구 사항

이 기능을 사용하려면 먼저 Braze MCP 서버를 설정해야 합니다.

사용 가능한 Braze API 기능

MCP 클라이언트는 이 도구들을 참조하여 Braze MCP 서버와 상호작용합니다.

워크스페이스

도구	API 엔드포인트	접근	설명
`get_workspaces`	N/A	read	현재 OAuth 액세스 토큰이 접근할 수 있는 Braze 워크스페이스를 확인합니다. 이 도구를 먼저 호출하세요. 반환되는 각 워크스페이스 `id`가 다른 모든 도구에서 필요한 `app_group_id`입니다.

Campaigns

도구	API 엔드포인트	접근	설명
`get_campaign_list`	`/campaigns/list`	read	이름, Campaign API 식별자, API Campaign 플래그, 태그가 포함된 Campaign 목록을 내보냅니다.
`get_campaign_details`	`/campaigns/details`	read	`campaign_id`로 지정된 Campaign의 관련 정보를 조회합니다.
`get_campaign_dataseries`	`/campaigns/data_series`	read	시간 경과에 따른 Campaign 통계의 일별 시리즈를 조회합니다(채널별 전송, 열람, 클릭, 전환).
`duplicate_campaign`	`/campaigns/duplicate`	create	기존 Campaign을 복제합니다.
`create_campaign`^*	N/A	create	새 Campaign을 생성합니다.
`edit_campaign`^*	N/A	update	기존 Campaign을 편집합니다.
`launch_campaign`^*	N/A	update	Campaign을 실행합니다.
`stop_campaign`^*	N/A	update	실행 중인 Campaign을 중지합니다.
`archive_campaign`^*	N/A	update	Campaign을 보관합니다.
`unarchive_campaign`^*	N/A	update	Campaign의 보관을 해제합니다.
`get_campaign_draft`^*	N/A	read	Campaign 초안 세부 정보를 조회합니다.
`get_campaign_live_details`^*	N/A	read	실시간 Campaign 세부 정보를 조회합니다.
`create_campaign_message`^*	N/A	create	Campaign 내 메시지를 생성합니다.
`update_campaign_message`^*	N/A	update	Campaign 메시지를 업데이트합니다.
`delete_campaign_message`^*	N/A	delete	Campaign 메시지를 삭제합니다.
`create_campaign_message_variation`^*	N/A	create	Campaign 내 메시지 배리언트를 생성합니다.
`update_campaign_message_variation`^*	N/A	update	Campaign 메시지 배리언트를 업데이트합니다.
`delete_campaign_message_variation`^*	N/A	delete	Campaign 메시지 배리언트를 삭제합니다.
`update_campaign_distribution`^*	N/A	update	Campaign 배포 설정을 업데이트합니다.

^* 이 도구는 Campaign API 베타 프로그램에 참여 중인 고객만 사용할 수 있습니다. 계정에 이 기능이 활성화되어 있지 않으면 사용 시 오류가 발생할 수 있습니다. 베타 프로그램에 참여하려면 계정 매니저에게 문의하세요.

Canvases

도구	API 엔드포인트	접근	설명
`get_canvas_list`	`/canvas/list`	read	이름, Canvas API 식별자, 태그가 포함된 Canvas 목록을 내보냅니다.
`get_canvas_details`	`/canvas/details`	read	Canvas 메타데이터를 내보냅니다: 이름, 생성 시간, 현재 상태 등.
`get_canvas_data_series`	`/canvas/data_series`	read	Canvas의 시계열 데이터를 내보냅니다.
`get_canvas_data_summary`	`/canvas/data_summary`	read	Canvas 시계열 데이터의 요약 롤업을 내보냅니다.

카탈로그

도구	API 엔드포인트	접근	설명
`get_catalogs`	`/catalogs`	read	워크스페이스의 카탈로그 목록을 조회합니다.
`get_catalog_items`	`/catalogs/{catalog_name}/items`	read	여러 카탈로그 항목과 해당 콘텐츠를 반환합니다.
`get_catalog_item`	`/catalogs/{catalog_name}/items/{item_id}`	read	단일 카탈로그 항목과 해당 콘텐츠를 반환합니다.
`create_catalog`	`/catalogs`	create	카탈로그를 생성합니다.
`delete_catalog`	`/catalogs/{catalog_name}`	delete	카탈로그를 삭제합니다.
`create_catalog_fields`	`/catalogs/{catalog_name}/fields`	create	카탈로그에 여러 필드를 생성합니다.
`delete_catalog_field`	`/catalogs/{catalog_name}/fields/{field_name}`	delete	카탈로그 필드를 삭제합니다.
`create_catalog_items`	`/catalogs/{catalog_name}/items`	create	카탈로그에 여러 항목을 생성합니다. 요청당 최대 50개 항목.
`edit_catalog_items`	`/catalogs/{catalog_name}/items`	update	카탈로그의 기존 항목 여러 개를 편집합니다. 요청당 최대 50개 항목.
`replace_catalog_items`	`/catalogs/{catalog_name}/items`	update	카탈로그의 여러 항목을 교체합니다. 항목이 존재하지 않으면 새로 생성합니다. 요청당 최대 50개 항목.
`delete_catalog_items`	`/catalogs/{catalog_name}/items`	delete	카탈로그의 여러 항목을 삭제합니다. 요청당 최대 50개 항목.
`create_catalog_selection`	`/catalogs/{catalog_name}/selections`	create	카탈로그에 셀렉션을 생성합니다.
`delete_catalog_selection`	`/catalogs/{catalog_name}/selections/{selection_name}`	delete	카탈로그 셀렉션을 삭제합니다.

커스텀 속성

도구	API 엔드포인트	접근	설명
`get_custom_attributes`	`/custom_attributes`	read	앱에 기록된 커스텀 속성을 알파벳순으로 50개씩 내보냅니다.

커스텀 이벤트

도구	API 엔드포인트	접근	설명
`get_events`	`/events`	read	앱에 기록된 커스텀 이벤트를 알파벳순으로 50개씩 내보냅니다(커서 페이지네이션).
`get_events_list`	`/events/list`	read	커스텀 이벤트 이름을 알파벳순으로 250개씩 내보냅니다(페이지 페이지네이션).
`get_events_data_series`	`/events/data_series`	read	지정된 기간 동안 커스텀 이벤트의 발생 횟수를 조회합니다.

CDI 통합

도구	API 엔드포인트	접근	설명
`list_integrations`	`/cdi/integrations`	read	기존 클라우드 데이터 수집 통합 목록을 조회합니다. 호출당 10개.
`get_integration_job_sync_status`	`/cdi/integrations/{integration_id}/job_sync_status`	read	지정된 CDI 통합의 과거 동기화 상태를 조회합니다. 호출당 10개.
`trigger_integration_sync`	`/cdi/integrations/{integration_id}/sync`	write	지정된 CDI 통합의 동기화를 트리거합니다.

KPI

도구	API 엔드포인트	접근	설명
`get_dau_data_series`	`/kpi/dau/data_series`	read	날짜별 고유 활성 사용자의 일별 시리즈를 조회합니다.
`get_mau_data_series`	`/kpi/mau/data_series`	read	30일 롤링 윈도우 기준 고유 활성 사용자의 일별 시리즈를 조회합니다.
`get_new_users_data_series`	`/kpi/new_users/data_series`	read	날짜별 총 신규 사용자의 일별 시리즈를 조회합니다.
`get_uninstalls_data_series`	`/kpi/uninstalls/data_series`	read	날짜별 총 앱 삭제 수의 일별 시리즈를 조회합니다.

미디어 라이브러리

도구	API 엔드포인트	접근	설명
`create_media_library_asset`	`/media_library/create`	create	외부 URL 또는 base64 파일 콘텐츠를 통해 Braze 미디어 라이브러리에 에셋을 업로드합니다. 정확히 하나의 업로드 모드를 제공해야 합니다.

구매

도구	API 엔드포인트	접근	설명
`get_product_list`	`/purchases/product_list`	read	페이지네이션된 제품 ID 목록을 조회합니다.
`get_quantity_series`	`/purchases/quantity_series`	read	지정된 기간 동안 앱의 총 구매 수를 조회합니다.
`get_revenue_series`	`/purchases/revenue_series`	read	지정된 기간 동안 앱에서 발생한 총 매출을 조회합니다.

Segments

도구	API 엔드포인트	접근	설명
`get_segment_list`	`/segments/list`	read	이름, Segment API 식별자, 분석 추적 플래그가 포함된 Segment를 내보냅니다.
`get_segment_details`	`/segments/details`	read	`segment_id`로 Segment의 관련 정보를 조회합니다.
`get_segment_data_series`	`/segments/data_series`	read	시간 경과에 따른 Segment 예상 규모의 일별 시리즈를 조회합니다.
`get_segment_filters`^*	N/A	read	Segment 필터 정의를 조회합니다.
`create_segment`^*	N/A	create	새 Segment를 생성합니다.
`edit_segment`^*	N/A	update	기존 Segment를 편집합니다.

^* 이 도구는 Segment API 베타 프로그램에 참여 중인 고객만 사용할 수 있습니다. 계정에 이 기능이 활성화되어 있지 않으면 사용 시 오류가 발생할 수 있습니다. 베타 프로그램에 참여하려면 계정 매니저에게 문의하세요.

전송

도구	API 엔드포인트	접근	설명
`get_send_data_series`	`/sends/data_series`	read	추적된 `send_id`에 대한 일별 통계를 조회합니다(API Campaign). Braze는 전송 후 14일 동안 전송 분석 데이터를 보관합니다.

세션

도구	API 엔드포인트	접근	설명
`get_session_data_series`	`/sessions/data_series`	read	지정된 기간 동안 앱의 세션 수를 조회합니다.

템플릿

도구	API 엔드포인트	접근	설명
`get_email_templates`	`/templates/email/list`	read	Braze 계정에서 사용 가능한 이메일 템플릿 목록을 조회합니다.
`get_email_template_info`	`/templates/email/info`	read	특정 이메일 템플릿의 정보를 가져옵니다. 드래그 앤 드롭 편집기 템플릿은 지원되지 않습니다.
`create_email_template`	`/templates/email/create`	create	Braze 대시보드에서 이메일 템플릿을 생성합니다.
`update_email_template`	`/templates/email/update`	update	기존 이메일 템플릿을 업데이트합니다.

Content Blocks

도구	API 엔드포인트	접근	설명
`get_content_blocks`	`/content_blocks/list`	read	기존 콘텐츠 블록 정보를 조회합니다.
`get_content_block_info`	`/content_blocks/info`	read	기존 콘텐츠 블록의 정보를 가져옵니다. 선택적으로 Campaign 또는 Canvas 포함 데이터도 조회할 수 있습니다.
`create_content_block`	`/content_blocks/create`	create	콘텐츠 블록을 생성합니다.
`update_content_block`	`/content_blocks/update`	update	콘텐츠 블록을 업데이트합니다.

Operator

도구	API 엔드포인트	접근	설명
`send_operator_prompt`	N/A	update	BrazeAI Operator에 자연어 프롬프트를 전송합니다. 백그라운드 작업을 제출하고 job_id를 반환합니다.
`get_operator_result`	N/A	read	job_id를 사용하여 제출된 Operator 작업의 결과를 폴링합니다.
`cancel_operator_job`	N/A	update	실행 중인 Operator 작업을 취소합니다.

중요

이 도구들은 Operator 베타 프로그램에 참여 중인 고객만 사용할 수 있습니다. 계정에 이 기능이 활성화되어 있지 않으면 사용 시 오류가 발생할 수 있습니다. 베타 프로그램에 참여하려면 계정 매니저에게 문의하세요.

법적 고지 사항

지시 및 응답 처리 방식

Braze MCP 서버는 Claude, ChatGPT, Copilot, Gemini CLI, Codex 또는 Cursor와 같은 서드파티 공급자 MCP 클라이언트로부터 해당 공급자의 기본 AI 모델이 생성한 그대로의 지시를 수신합니다. 사용자가 자연어로 요청을 입력하면, AI 모델이 해당 요청을 해석하여 Braze에 대한 하나 이상의 특정 도구 호출로 변환합니다. Braze는 전송된 도구 호출을 그대로 수신하고 실행합니다. Braze는 사용자의 원래 자연어 프롬프트를 확인할 수 없으며, 생성된 도구 호출이 사용자의 의도한 요청을 완전하고 정확하게 반영하는지 검증할 수 없습니다.

Braze가 데이터 또는 결과를 반환하면, 해당 응답은 서드파티 공급자 MCP 클라이언트로 다시 전송되며, 클라이언트가 이를 해석하고 형식을 지정하여 사용자에게 표시합니다. Braze는 AI 모델이 반환된 정보를 표시, 요약 또는 설명하는 방식을 제어하지 않습니다.

Braze는 서드파티 공급자 MCP 클라이언트에 의해 생성된 지시 또는 전달된 응답에 대해 책임을 지지 않습니다. 서드파티 공급자 MCP 클라이언트가 자동 작업 구현을 위한 “자동 모드”를 제공하는 경우, 이를 사용하지 않는 것을 권장합니다. AI가 생성한 요약은 Braze 대시보드의 원본 데이터와 대조하여 검토하고, AI가 제안한 모든 작업은 서드파티 공급자 MCP 클라이언트를 통해 구현하기 전에 반드시 검토해 주세요.

New Stuff!