Braze MCP 서버: AI로 Braze를 빠르고 안전하게 분석하는 방법

Braze MCP 서버는 AI 도구(Claude, Cursor)가 Braze 데이터에 접근하여 질문에 답하거나, 트렌드를 분석하고, 인사이트를 제공할 수 있게 해주는 기능입니다. 읽기 전용으로 안전하게 접근하기 때문에 코드, 파일 등 데이터를 변경하지는 않습니다. 또한 개인식별정보(PII, Personally Identifiable Information)를 포함하지 않는 데이터에만 접근하기 때문에 안심하고 사용해도 됩니다.

이번 포스팅에서는 MCP 및 Braze MCP에 대해서 간단하게 알아보도록 하겠습니다.

MCP(Model Context Protocol)란?

MCP는 AI 에이전트가 다른 플랫폼의 데이터를 연결하고 다룰 수 있게 해주는 개방형 표준입니다. 쉽게 말해 AI가 “외부 서비스의 데이터를 직접 들여다보고 싶을 때" 그 사이에서 안전한 다리 역할을 하는 것이 MCP입니다. 가령, Braze의 캠페인·세그먼트 통계를 분석하고 싶을 때, AI 챗봇을 직접 연결해, 사용자가 자연어로 “최근 캠페인 성과를 보여줘”라고 물으면 AI가 실시간으로 분석해 답하게 만들 수 있습니다. MCP는 크게 클라이언트와와 서버로 구성되어있습니다.

• MCP 클라이언트: AI 에이전트가 실행되는 애플리케이션 (예: Cursor, Claude)
• MCP 서버: Braze처럼 다른 플랫폼이 제공하는 서비스로, AI가 사용할 수 있는 도구와 접근 가능한 데이터를 정의

Braze MCP 서버 소개

앞서 설명했듯, Braze MCP 서버를 설정하면 에이전트·어시스턴트·챗봇과 같은 AI 도구가 Braze에 직접 연결되어 캔버스(Canvas)·캠페인 분석, 커스텀 속성, 세그먼트 등 집계 데이터를 읽을 수 있습니다.

Braze MCP 서버는 다음과 같은 상황에 활용해볼 수 있습니다.

• Braze 맥락(Context)이 필요한 AI 기반 도구 개발
• 여러 단계의 에이전트 워크플로를 설계하는 CRM 엔지니어 업무
• 자연어 쿼리를 실험하는 테크니컬 마케터 업무

Braze MCP 서버는 총 38개의 읽기 전용 엔드포인트를 지원하며, Braze 사용자 프로필 데이터는 반환하지 않습니다. API 키를 설정할 때 접근 가능한 엔드포인트를 선택해 AI가 볼 수 있는 데이터를 추가로 제한할 수 있습니다.

※주의사항

API 키에 읽기 전용 권한 외의 권한을 부여하지 마세요. 쓰기나 삭제 권한이 있으면 AI가 데이터를 변경하려 할 수 있으며, 이는 예기치 않은 결과를 초래할 수 있습니다.

Braze MCP 서버 세팅하기

총 5단계를 걸쳐 Braze MCP를 세팅할 수 있습니다.

- 1단계: uv설치

- 2단계: API 생성

- 3단계: 식별자와 엔드 포인트 확인

- 4단계: MCP 클라이언트 구성

- 5단계: 테스트 프롬프트 실행

각 단계별 상세 설정 방법은 Braze 공식 가이드 문서를 확인해주세요

활용 가이드

1. 활용 시 주의사항

Braze MCP 서버를 사용할 때 다음 사항을 주의하세요.

• LLM(대규모 언어 모델)은 실수할 수 있습니다. 항상 결과를 재확인하세요.
• 분석 범위를 명확히 지정하세요. 짧은 기간을 설정할수록 정확도가 높아집니다.
• Braze의 정확한 용어를 사용할 수록 AI가 더 올바른 함수를 호출합니다.
• 결과가 불완전해 보이면 추가 요청이나 심층 탐색을 지시하세요.
• MCP 클라이언트에 따라 CSV나 다른 유용한 파일로 내보내기도 가능하니 다양한 프롬프트를 시도해 보세요.

2. 지원 툴

현재는 Claude나 Cursor 에서 Braze MCP 서버를 사용할 수 있습니다.

3. 추천 프롬프트 및 프롬프트 구성 팁

다음과 같은 프롬프트를 활용해보세요. Braze MCP 서버 활용 범위와 패턴을 익히기 훨씬 쉬워질 것입니다.

• 사용 가능한 Braze 함수를 조회하고 싶어(What are my available Braze functions?)
• 특정 Canvas ID 상세 정보를 조회하고 싶어(Get details about a canvas ID)
• 최근 Canvas를 보여줘(Show me my recent canvases)

더 자세한 프롬프트 구성 팁은 다음과 같습니다.

• 구체적일수록 좋음: 날짜, 캠페인 범위, 데이터 유형을 명확히 지정하면 정확도가 높아 집니다.
• 부분 데이터 주의: 원하는 결과의 일부만 나오는 경우가 종종 있습니다. 명령어를 통해 범위를 넓혀 놓치는 데이터가 없는지 추가 확인하세요.
• 답변이 루프에 빠지면 새 질문하기: AI의 답변이 특정 반복되면 새로운 질문을 생성하세요.
• 한 단계 더 깊이: 분석이 만족스러웠던라도 “추가로 무엇을 배울 수 있을까?”와 같이 물어보면 더 깊은 인사이트를 얻을 수 있습니다.
• 우선순위 요청: “가장 큰 임팩트 순으로 정리해줘”와 같이 빠른 의사결정이 필요한 상황에서 활용하세요.
• 내부 보고 활용: CMO 보고용 슬라이드 요약, Slack 공유용 시각화, 엔지니어에게 전달할 커스텀 이벤트 요약 등 스토리텔링을 요청 가능합니다.

4. 실제 활용 케이스

Braze 마케팅팀이 수주간 내부적으로 활용한 결과 다음과 같은 부분에 성과가 있었습니다. 참고하여, 산업에 맞게 적용해보세요!

• 개요 파악: “회계연도별 캠페인과 캔버스 수를 알려줘”라는 질문으로 2024년에는 215개 이상, 2025년에는 100개에 가까운 아이템을 확인했습니다. 현재 추세라면 2025년 전체 약 200개에 이를 것으로 예측되어, 자원 배분 논의에 큰 도움이 되었습니다.
• 성과 분석: “2025년 7월 캠페인과 캔버스 성과 요약” 요청으로, 제품 교육 및 커뮤니티 뉴스레터가 가장 높은 오픈율을 기록했으며 월말 발송이 월 중 발송 대비 2배 성과를 보였다는 사실을 몇 분 만에 파악했습니다.
• 실행 계획 제안: “시작·유지·중단할 것 2가지씩 제안해줘”라는 질문에 MCP는 월간 제품 스포트라이트와 월말 스케줄링을 시작할 것, 복잡한 캔버스 워크플로와 커뮤니티 시리즈는 유지할 것, 활동 없는 이벤트 캠페인과 중복 캠페인은 중단할 것을 추천했습니다.
• 데이터 정리: 180개 이상의 중복 커스텀 속성과 사용되지 않는 세그먼트를 찾아 아카이빙 계획까지 제안했습니다.

자주 묻는 질문(FAQ)

Q. Claude와 Cursor 외에 지원되는 MCP 클라이언트는 없나요?

A. 네 현재는 Claude와 Cursor만 공식 지원합니다.

Q. 접근 가능한 Braze 데이터 범위가 어떻게 되나요?

A. MCP 클라이언트는 PII가 없는 읽기 전용 엔드포인트만 접근합니다. Braze 데이터를 직접 수정할 수 없습니다.

Q. 타사 MCP 서버 사용이 가능한가요?

A. 권장하지 않습니다. 반드시 공식 Braze MCP 서버(PyPi 배포)를 사용하세요.

Q. PII 조회나 쓰기 권한이 없는 이유가 뭔가요?

A. 데이터 보호를 위해 MCP 서버는 기본적으로 읽기 전용 및 비 PII 데이터만 제공합니다.

Q. API 키는 재사용 가능한가요?

A. 기존 API 키는 재사용할 수 없습니다. MCP 클라이언트 전용 새 API 키를 발급해야 하며, 되도록 필요한 최소 권한만 부여하세요.

Q. Braze MCP의 서버 위치는 어디인가요?

A. 현재 Braze MCP 서버는 로컬 환경에서 호스팅됩니다.

Q. Cursor가 함수만 나열하는데 어떻게 해결하나요?

A. Cursor 설정에서 Ask 모드인지 확인하세요. Agent 모드일 때, 함수만 나열하는 현상이 발생합니다.

Q. AI 응답 결과가 다소 부정확해요.

A. Cursor 모델 설정을 확인해보세요. 자동 모드 대신 잘 사용하던 특정 모델을 지정하는 것을 권장합니다. 새 채팅으로 다시 시도해보는 것도 좋은 방법입니다.

콘텐츠 더 읽어보기

• 맥사이트-픽: MCP: AI 사용자 경험을 확장시켜줄 핵심 연결고리
• 영상으로 보기: [코너스톤42] Beyond Chat: AX 시대의 LLM과 MCP가 여는 지능형 인터페이스
• 프리피엄 가이드북: AI로 설계하는 마케팅 자동화 가이드북