브레이즈

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

Team MAXONOMY ・ 2025.09.11

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

팀맥소노미

YOUR DIGITAL MARKETING HERO

비즈니스 성장을 위한 최적의 솔루션과 무료 데모 시연, 활용 시나리오를 제안 받아보세요

관련 글 보기

Braze Forge 2025 리뷰: 마케터, 미래 설계의 주체가 되다

Braze Forge 2025 리뷰: 마케터, 미래 설계의 주체가 되다

Braze Forge 2025 업데이트: Zero-copy triggers, WhatsApp Flows, Automated IP warning 한눈에 보기

AI 콘텐츠 마케팅 시작하기

AI 콘텐츠 마케팅 시작하기

AI를 활용한 콘텐츠 마케팅 단계와 AI 콘텐츠의 함정을 극복하는 법

마케팅 기여도 분석하기(with Braze AI)

마케팅 기여도 분석하기(with Braze AI)

난감했던 마케팅 ROI 측정, 기존 분석법 한계와 AI를 활용한 돌파구

Braze에서 카카오톡 마케팅 시작하기

Braze에서 카카오톡 마케팅 시작하기

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는 크게 클라이언트와와 서버로 구성되어있습니다.







Braze MCP 서버 소개



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


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



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 서버를 사용할 때 다음 사항을 주의하세요.




2. 지원 툴

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




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



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



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





4. 실제 활용 케이스


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











자주 묻는 질문(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 모델 설정을 확인해보세요. 자동 모드 대신 잘 사용하던 특정 모델을 지정하는 것을 권장합니다. 새 채팅으로 다시 시도해보는 것도 좋은 방법입니다.






콘텐츠 더 읽어보기

브레이즈, 인공지능(AI), 도입/구축, AX, MCP, Braze AI