이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.
Braze MCP 서버 기능
Braze MCP 서버는 읽기 및 쓰기 도구를 제공합니다. 대부분은 Braze REST API 엔드포인트에 매핑되며, 일부는 MCP 서버를 통해서만 사용할 수 있습니다. 자세한 내용은 Braze MCP 서버를 참조하세요.

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

참고
Braze MCP 서버에는 Operator 도구처럼 베타 프로그램에 참여 중인 고객만 사용할 수 있는 도구가 포함되어 있습니다. 베타 프로그램에 속한 도구에 접근하려고 할 때 계정에서 해당 기능이 활성화되어 있지 않으면 오류 응답을 받을 수 있습니다. 베타 프로그램에 참여하려면 계정 매니저에게 문의하세요.
필수 조건
이 기능을 사용하려면 먼저 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_custom_attributes |
/custom_attributes |
읽기 |
커스텀 이벤트, 속성 및 구매 보기 |
앱에 기록된 커스텀 속성을 50개 단위로 알파벳순으로 내보냅니다. |
커스텀 이벤트
| 도구 |
API 엔드포인트 |
액세스 |
권한 |
설명 |
get_events |
/events |
읽기 |
커스텀 이벤트, 속성 및 구매 보기 |
앱에 기록된 커스텀 이벤트를 50개 단위로 알파벳순으로 내보냅니다(커서 페이지 매김). |
get_events_list |
/events/list |
읽기 |
커스텀 이벤트, 속성 및 구매 보기 |
커스텀 이벤트 이름을 250개 단위로 알파벳순으로 내보냅니다(페이지 단위 페이지 매김). |
get_events_data_series |
/events/data_series |
읽기 |
커스텀 이벤트, 속성 및 구매 보기 |
지정된 기간 동안 커스텀 이벤트가 발생한 횟수입니다. |
CDI 통합
KPI
| 도구 |
API 엔드포인트 |
액세스 |
권한 |
설명 |
create_media_library_asset |
/media_library/create |
생성 |
미디어 라이브러리 에셋 관리 |
외부 URL 또는 base64 파일 콘텐츠를 통해 Braze 미디어 라이브러리에 에셋을 업로드합니다. 업로드 모드는 정확히 하나만 제공해야 합니다. |
구매
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 도구는 정식 출시되었으며, 베타 프로그램에 참여하지 않아도 사용할 수 있습니다.

참고
MCP 도구는 Campaigns, Segments, 태그, 브랜드 가이드라인을 프로그래밍 방식으로 관리하는 데 지원되는 방법입니다. 이러한 도구를 구동하는 기본 API는 공개 API 설명서에 나와 있지 않으며, 이를 직접 사용하는 것은 지원되지 않습니다. Braze 지원팀은 이러한 API를 직접 사용하여 발생한 문제는 도와드릴 수 없습니다. 프로덕션 워크플로에는 MCP 도구를 사용하세요.
| 도구 |
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일 동안 저장합니다. |
세션
템플릿
콘텐츠 블록
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 작업을 취소합니다. |

중요
이 도구는 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 클라이언트를 통해 구현하기 전에 반드시 검토해 주세요.