이 페이지는 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 통계의 일별 시리즈(채널별 전송, 열람, 클릭, 전환)입니다. |
Canvases
| 도구 |
API 엔드포인트 |
접근 |
설명 |
get_canvas_list |
/canvas/list |
read |
이름, Canvas API 식별자 및 태그가 포함된 Canvases 목록을 내보냅니다. |
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_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 통합
핵심 성과 지표(KPI)
| 도구 |
API 엔드포인트 |
접근 |
설명 |
create_media_library_asset |
/media_library/create |
create |
외부 URL 또는 base64 파일 콘텐츠를 통해 Braze 미디어 라이브러리에 자산을 업로드합니다. 업로드 모드는 정확히 하나만 제공해야 합니다. |
메시지
구매
SDK 인증
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의 추정 크기 일별 시리즈입니다. |
전송
| 도구 |
API 엔드포인트 |
접근 |
설명 |
get_send_data_series |
/sends/data_series |
read |
추적된 send_id(API Campaigns)에 대한 일별 통계입니다. Braze는 전송 후 14일 동안 전송 분석 데이터를 저장합니다. |
세션
구독 그룹
템플릿
Content Blocks
법적 고지 사항
지시 및 응답 처리 방식
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 클라이언트를 통해 구현하기 전에 반드시 검토해 주세요.