콘텐츠로 건너뛰기

Braze MCP 서버 기능

Braze MCP 서버는 읽기 및 쓰기 도구를 제공합니다. 대부분은 Braze REST API 엔드포인트에 매핑되며, 일부는 MCP 서버를 통해서만 사용할 수 있습니다. 자세한 내용은 Braze MCP 서버를 참조하세요.

필수 조건

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

사용 가능한 Braze API 기능

MCP 클라이언트는 다음 도구를 참조하여 Braze MCP 서버와 상호작용합니다. API 엔드포인트 열에 “MCP 전용”으로 표시된 도구는 Braze MCP 서버를 통해서만 사용할 수 있으며, 이에 대응하는 공개 REST API 엔드포인트는 없습니다.

워크스페이스

도구 API 엔드포인트 액세스 권한 설명
get_workspaces MCP 전용 읽기 없음 현재 OAuth 액세스 토큰으로 접근할 수 있는 Braze 워크스페이스를 확인합니다. 이 도구를 가장 먼저 호출하세요. 반환되는 각 워크스페이스의 id는 다른 모든 도구에 필요한 app_group_id입니다.

Campaigns

도구 API 엔드포인트 액세스 권한 설명
get_campaign_list /campaigns/list 읽기 Campaign 분석 보기 이름, Campaign API 식별자, API Campaign 여부 플래그, 태그가 포함된 Campaign 목록을 내보냅니다.
get_campaign_details /campaigns/details 읽기 Campaign 분석 보기 campaign_id로 지정한 Campaign의 관련 정보를 조회합니다.
get_campaign_dataseries /campaigns/data_series 읽기 Campaign 분석 보기 시간에 따른 Campaign 통계의 일별 시리즈입니다(채널별 발송, 열람, 클릭, 전환).
duplicate_campaign /campaigns/duplicate 생성 Campaign 생성 기존 Campaign을 복제합니다. 복사본은 원본의 Segment, 스케줄, 메시지 콘텐츠를 그대로 이어받습니다.
create_campaign MCP 전용 생성 Campaign 생성 타겟팅, 스케줄, 전달 제어, 전환 이벤트, 진입 제한을 포함한 Campaign 초안을 생성합니다. Braze는 MCP 서버를 통해 Campaign을 실행하지 않으므로, 초안은 Braze 대시보드에서 실행하세요.
edit_campaign MCP 전용 업데이트 Campaign 편집 초안 또는 실시간 Campaign의 메타데이터(이름, 타겟팅, 스케줄, 전달 제어, 전환 이벤트, 진입 제한 등)를 편집합니다.
stop_campaign MCP 전용 업데이트 Campaign 중지 실시간 Campaign의 전달을 일시 중지하여 진행 중인 발송을 멈춥니다. 다시 시작하려면 Braze 대시보드에서 Campaign을 실행하세요.
archive_campaign MCP 전용 업데이트 Campaign 보관 Campaign을 보관하여 전달을 중지하고 Campaign을 삭제됨으로 표시합니다. 이 작업을 되돌리려면 unarchive_campaign을 사용하세요.
unarchive_campaign MCP 전용 업데이트 Campaign 보관 이전에 보관한 Campaign의 보관을 해제합니다. Campaign은 중지된 상태로 돌아오므로, 다시 실시간으로 전환하려면 Braze 대시보드에서 실행하세요.
get_campaign_draft MCP 전용 읽기 Campaign 분석 보기 타겟팅, 채널, 배리에이션, 전달 제어를 포함한 Campaign의 편집 가능한 초안을 읽습니다.
get_campaign_live_details MCP 전용 읽기 Campaign 분석 보기 실행된 Campaign의 실시간 상태를 초안과 동일한 형태로 읽습니다.
create_campaign_message MCP 전용 생성 Campaign 편집 혼합 채널 Campaign 초안에 메시지 채널을 추가합니다.
update_campaign_message MCP 전용 업데이트 Campaign 편집 혼합 채널 Campaign 초안의 메시지 채널을 업데이트합니다.
delete_campaign_message MCP 전용 삭제 Campaign 편집 혼합 채널 Campaign 초안에서 메시지 채널을 제거합니다.
create_campaign_message_variation MCP 전용 생성 Campaign 편집 유형 지정 Campaign 또는 빠른 푸시 Campaign에 A/B 배리에이션을 추가합니다.
update_campaign_message_variation MCP 전용 업데이트 Campaign 편집 유형 지정 Campaign 또는 빠른 푸시 Campaign의 A/B 배리에이션 하나를 업데이트합니다.
delete_campaign_message_variation MCP 전용 삭제 Campaign 편집 유형 지정 Campaign 또는 빠른 푸시 Campaign에서 A/B 배리에이션 하나를 제거합니다.
update_campaign_distribution MCP 전용 업데이트 Campaign 편집 Campaign 초안의 대조군 비율과 A/B 배리에이션 간 비율 분배를 설정합니다.
get_campaign_translations MCP 전용 읽기 Campaign 분석 보기 메시지 배리에이션의 로캘별 번역 맵을 읽습니다.
get_campaign_translation_source MCP 전용 읽기 Campaign 분석 보기 배리에이션의 {% translation id %} 태그 안에 있는 기본 소스 문자열을 읽습니다.
update_campaign_translation MCP 전용 업데이트 Campaign 편집 메시지 배리에이션에 대해 한 로캘의 번역을 작성합니다.

Campaign 도구는 정식 출시되었으며, 베타 프로그램에 참여하지 않아도 사용할 수 있습니다.

Canvases

도구 API 엔드포인트 액세스 권한 설명
get_canvas_list /canvas/list 읽기 Canvas 분석 보기 이름, Canvas API 식별자, 태그가 포함된 Canvas 목록을 내보냅니다.
get_canvas_details /canvas/details 읽기 Canvas 분석 보기 이름, 생성 시간, 현재 상태 등 Canvas 메타데이터를 내보냅니다.
get_canvas_data_series /canvas/data_series 읽기 Canvas 분석 보기 Canvas의 시계열 데이터를 내보냅니다.
get_canvas_data_summary /canvas/data_summary 읽기 Canvas 분석 보기 Canvas 시계열 데이터를 집계하여 간결한 결과 요약으로 내보냅니다.

카탈로그

도구 API 엔드포인트 액세스 권한 설명
get_catalogs /catalogs 읽기 카탈로그 보기 워크스페이스의 카탈로그를 나열합니다.
get_catalog_items /catalogs/{catalog_name}/items 읽기 카탈로그 아이템 보기 여러 카탈로그 아이템과 해당 콘텐츠를 반환합니다.
get_catalog_item /catalogs/{catalog_name}/items/{item_id} 읽기 카탈로그 아이템 보기 단일 카탈로그 아이템과 해당 콘텐츠를 반환합니다.
create_catalog /catalogs 생성 카탈로그 관리 카탈로그를 생성합니다.
delete_catalog /catalogs/{catalog_name} 삭제 카탈로그 관리 카탈로그를 삭제합니다.
create_catalog_fields /catalogs/{catalog_name}/fields 생성 카탈로그 필드 관리 카탈로그에 여러 필드를 생성합니다.
delete_catalog_field /catalogs/{catalog_name}/fields/{field_name} 삭제 카탈로그 필드 관리 카탈로그 필드를 삭제합니다.
create_catalog_items /catalogs/{catalog_name}/items 생성 카탈로그 아이템 관리 카탈로그에 여러 아이템을 생성합니다. 요청당 최대 50개 아이템까지 가능합니다.
edit_catalog_items /catalogs/{catalog_name}/items 업데이트 카탈로그 아이템 관리 카탈로그의 기존 아이템 여러 개를 편집합니다. 요청당 최대 50개 아이템까지 가능합니다.
replace_catalog_items /catalogs/{catalog_name}/items 업데이트 카탈로그 아이템 관리 카탈로그의 여러 아이템을 대체합니다. 아이템이 없으면 새로 생성합니다. 요청당 최대 50개 아이템까지 가능합니다.
delete_catalog_items /catalogs/{catalog_name}/items 삭제 카탈로그 아이템 관리 카탈로그의 여러 아이템을 삭제합니다. 요청당 최대 50개 아이템까지 가능합니다.
create_catalog_selection /catalogs/{catalog_name}/selections 생성 카탈로그 선택 항목 관리 카탈로그에 선택 항목을 생성합니다.
delete_catalog_selection /catalogs/{catalog_name}/selections/{selection_name} 삭제 카탈로그 선택 항목 관리 카탈로그 선택 항목을 삭제합니다.

커스텀 속성

도구 API 엔드포인트 액세스 권한 설명
get_custom_attributes /custom_attributes 읽기 커스텀 이벤트, 속성 및 구매 보기 앱에 기록된 커스텀 속성을 50개 단위로 알파벳순으로 내보냅니다.

커스텀 이벤트

도구 API 엔드포인트 액세스 권한 설명
get_events /events 읽기 커스텀 이벤트, 속성 및 구매 보기 앱에 기록된 커스텀 이벤트를 50개 단위로 알파벳순으로 내보냅니다(커서 페이지 매김).
get_events_list /events/list 읽기 커스텀 이벤트, 속성 및 구매 보기 커스텀 이벤트 이름을 250개 단위로 알파벳순으로 내보냅니다(페이지 단위 페이지 매김).
get_events_data_series /events/data_series 읽기 커스텀 이벤트, 속성 및 구매 보기 지정된 기간 동안 커스텀 이벤트가 발생한 횟수입니다.

CDI 통합

도구 API 엔드포인트 액세스 권한 설명
list_integrations /cdi/integrations 읽기 클라우드 데이터 수집 작업 상태 보기 기존 클라우드 데이터 수집 통합 목록을 호출당 10개씩 나열합니다.
get_integration_job_sync_status /cdi/integrations/{integration_id}/job_sync_status 읽기 클라우드 데이터 수집 작업 상태 보기 지정된 CDI 통합의 과거 동기화 상태를 호출당 10개씩 반환합니다.
trigger_integration_sync /cdi/integrations/{integration_id}/sync 쓰기 클라우드 데이터 수집 통합 동기화 지정된 CDI 통합의 동기화를 트리거합니다.

KPI

도구 API 엔드포인트 액세스 권한 설명
get_dau_data_series /kpi/dau/data_series 읽기 KPI 데이터 보기 날짜별 고유 활성 사용자 수의 일별 시리즈입니다.
get_mau_data_series /kpi/mau/data_series 읽기 KPI 데이터 보기 30일 롤링 기간 동안의 고유 활성 사용자 수 일별 시리즈입니다.
get_new_users_data_series /kpi/new_users/data_series 읽기 KPI 데이터 보기 날짜별 총 신규 사용자 수의 일별 시리즈입니다.
get_uninstalls_data_series /kpi/uninstalls/data_series 읽기 KPI 데이터 보기 날짜별 총 제거 수의 일별 시리즈입니다.

미디어 라이브러리

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

구매

도구 API 엔드포인트 액세스 권한 설명
get_product_list /purchases/product_list 읽기 커스텀 이벤트, 속성 및 구매 보기 페이지가 매겨진 제품 ID 목록입니다.
get_quantity_series /purchases/quantity_series 읽기 커스텀 이벤트, 속성 및 구매 보기 일정 기간 동안 앱에서 발생한 총 구매 수입니다.
get_revenue_series /purchases/revenue_series 읽기 커스텀 이벤트, 속성 및 구매 보기 일정 기간 동안 앱에서 지출된 총 금액입니다.

Segments

도구 API 엔드포인트 액세스 권한 설명
get_segment_list /segments/list 읽기 Segment 보기 이름, Segment API 식별자, 분석 추적 플래그가 포함된 Segment 목록을 내보냅니다.
get_segment_details /segments/details 읽기 Segment 보기 segment_id로 지정한 Segment의 관련 정보를 조회합니다.
get_segment_data_series /segments/data_series 읽기 Segment 보기 시간에 따른 Segment 예상 규모의 일별 시리즈입니다.
get_workspace_segments MCP 전용 읽기 Segment 보기 워크스페이스의 활성 Segment를 요약 형태로 호출당 최대 100개까지 커서 기반 페이지 매김으로 나열합니다. 보관된 Segment와 억제 목록은 제외됩니다.
get_segment_filters MCP 전용 읽기 Segment 보기 Segment 필터 트리에서 유효한 필터, 비교 연산자, 값 유형을 확인합니다.
create_segment MCP 전용 생성 Segment 생성 필터 트리로 사용자 정의 Segment를 생성합니다.
edit_segment MCP 전용 업데이트 Segment 편집 기존 사용자 정의 Segment를 편집합니다. 오디언스를 제공하면 해당 Segment의 필터 트리가 대체됩니다.
archive_segment MCP 전용 업데이트 Segment 보관 Segment와 이에 의존하는 Segment, Campaign, Canvas를 함께 보관합니다. 먼저 cascade 없이 호출하여 의존 항목을 검토하세요.
unarchive_segment MCP 전용 업데이트 Segment 보관 Segment의 보관을 해제합니다. 함께 보관된 의존 항목은 보관 상태로 유지됩니다.

Segment 도구는 정식 출시되었으며, 베타 프로그램에 참여하지 않아도 사용할 수 있습니다.

태그

도구 API 엔드포인트 액세스 권한 설명
get_workspace_tags MCP 전용 읽기 태그 보기 워크스페이스의 모든 활성 태그를 전체 이름 기준으로 이름순 정렬하여 페이지 매김 없이 한 번의 응답으로 나열합니다. 중첩된 태그의 이름은 Seasonal/Spring과 같은 전체 경로입니다.
create_workspace_tag MCP 전용 생성 태그 편집 워크스페이스에 최상위 태그 또는 기존 태그 아래의 중첩 태그를 생성하고 전체 이름을 반환합니다. 삭제된 태그만 사용 중인 이름을 지정하면 해당 태그가 복원됩니다. 대소문자와 관계없이 활성 태그가 이미 그 이름을 사용하고 있으면 호출이 409 오류로 실패하며 아무것도 변경되지 않습니다.

태그 도구는 정식 출시되었으며, 베타 프로그램에 참여하지 않아도 사용할 수 있습니다.

브랜드 가이드라인

도구 API 엔드포인트 액세스 권한 설명
get_brand_guidelines MCP 전용 읽기 없음 워크스페이스의 활성 브랜드 가이드라인을 가이드라인 텍스트 없이 최근 업데이트순으로 나열하고, 어떤 것이 기본값인지 표시합니다.
get_default_brand_guideline MCP 전용 읽기 없음 워크스페이스의 기본 브랜드 가이드라인을 가이드라인 텍스트와 함께 한 번의 호출로 가져옵니다. 워크스페이스에 기본값이 없으면 DEFAULT_BRAND_GUIDELINE_NOT_SET 오류를 반환합니다.
get_brand_guideline MCP 전용 읽기 없음 보관된 가이드라인을 포함하여 브랜드 가이드라인 하나를 가이드라인 텍스트와 함께 가져옵니다.

브랜드 가이드라인 도구는 정식 출시되었으며, 베타 프로그램에 참여하지 않아도 사용할 수 있습니다. 이 도구는 읽기 전용입니다. 브랜드 가이드라인을 생성하거나 편집하려면 Braze 대시보드를 사용하세요.

발송

도구 API 엔드포인트 액세스 권한 설명
get_send_data_series /sends/data_series 읽기 발송 데이터 보기 추적되는 send_id(API Campaign)의 일별 통계입니다. Braze는 발송 분석을 발송 후 14일 동안 저장합니다.

세션

도구 API 엔드포인트 액세스 권한 설명
get_session_data_series /sessions/data_series 읽기 세션 데이터 보기 지정된 기간 동안 앱의 세션 수입니다.

템플릿

도구 API 엔드포인트 액세스 권한 설명
get_email_templates /templates/email/list 읽기 이메일 템플릿 보기 Braze 계정에서 사용 가능한 이메일 템플릿을 나열합니다.
get_email_template_info /templates/email/info 읽기 이메일 템플릿 보기 특정 이메일 템플릿의 정보를 가져옵니다. 드래그 앤 드롭 편집기 템플릿은 허용되지 않습니다.
create_email_template /templates/email/create 생성 이메일 템플릿 관리 Braze 대시보드에 이메일 템플릿을 생성합니다.
update_email_template /templates/email/update 업데이트 이메일 템플릿 관리 기존 이메일 템플릿을 업데이트합니다.

콘텐츠 블록

도구 API 엔드포인트 액세스 권한 설명
get_content_blocks /content_blocks/list 읽기 콘텐츠 블록 보기 기존 콘텐츠 블록 정보를 나열합니다.
get_content_block_info /content_blocks/info 읽기 콘텐츠 블록 보기 기존 콘텐츠 블록의 정보를 가져오며, 선택적으로 Campaign 또는 Canvas 포함 데이터도 함께 가져옵니다.
create_content_block /content_blocks/create 생성 콘텐츠 블록 관리 콘텐츠 블록을 생성합니다.
update_content_block /content_blocks/update 업데이트 콘텐츠 블록 관리 콘텐츠 블록을 업데이트합니다.

Operator

도구 API 엔드포인트 액세스 권한 설명
send_operator_prompt MCP 전용 업데이트 BrazeAI Operator 사용 BrazeAI Operator에 자연어 프롬프트를 보냅니다. 백그라운드 작업을 제출하고 job_id를 반환합니다.
get_operator_result MCP 전용 읽기 BrazeAI Operator 사용 job_id를 사용하여 제출된 Operator 작업의 결과를 폴링합니다.
cancel_operator_job MCP 전용 업데이트 BrazeAI Operator 사용 실행 중인 Operator 작업을 취소합니다.

스킬

도구 API 엔드포인트 액세스 권한 설명
get_operator_skills MCP 전용 읽기 스킬 보기 워크스페이스의 스킬을 각 스킬의 이름 및 설명과 함께 나열합니다.
get_operator_skill MCP 전용 읽기 스킬 보기 지침을 포함하여 스킬을 읽습니다.
create_operator_skill MCP 전용 생성 스킬 보기, 스킬 편집 스킬을 생성합니다. 이름이 이미 사용 중이면 Braze가 접미사를 추가합니다.
update_operator_skill MCP 전용 업데이트 스킬 보기, 스킬 편집 스킬을 편집합니다. 지정하지 않은 필드는 현재 값을 유지합니다.

자세한 내용은 스킬을 참조하세요.

지시 및 응답 처리 방식

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!