Braze MCP 서버
Braze MCP 서버에 대해 알아보세요. 이는 Claude 및 Cursor와 같은 AI 도구가 비PII Braze 데이터에 접근하여 질문에 답하고, 트렌드를 분석하며, 인사이트를 제공하고, 콘텐츠를 생성할 수 있는 안전한 원격 연결입니다.
모델 컨텍스트 프로토콜(MCP)이란 무엇인가요?
모델 컨텍스트 프로토콜(Model Context Protocol, MCP)은 인공지능 에이전트가 다른 플랫폼에 연결하여 해당 플랫폼의 데이터를 활용할 수 있도록 해 주는 표준입니다. MCP는 크게 두 부분으로 구성됩니다:
- MCP 클라이언트: Cursor나 Claude처럼 인공지능 에이전트가 실행되는 애플리케이션입니다.
- MCP 서버: Braze와 같은 다른 플랫폼이 제공하는 서비스로, 인공지능이 사용할 수 있는 도구와 액세스할 수 있는 데이터를 정의합니다.
Braze MCP 서버 정보
Braze MCP 서버를 설정한 후에는 에이전트, 어시스턴트, 챗봇과 같은 AI 도구를 Braze에 직접 연결할 수 있습니다. 이렇게 연결된 도구는 Canvas 및 Campaign 분석, 커스텀 속성, Segments 등 집계된 데이터를 읽을 수 있습니다. Braze MCP 서버는 다음과 같은 경우에 유용합니다.
- Braze 컨텍스트가 필요한 AI 기반 도구를 구축하는 경우
- CRM 엔지니어가 여러 단계로 구성된 에이전트 워크플로를 만드는 경우
- 기술 마케터가 자연어 쿼리를 실험하는 경우
Braze MCP 서버에는 읽기 도구와 쓰기 도구가 모두 포함되어 있습니다. 이러한 도구는 Braze 고객 프로필의 데이터를 반환하지 않습니다. 에이전트는 Braze 대시보드의 사용자 권한을 그대로 상속받습니다. 사용 가능한 도구의 전체 목록은 사용 가능한 API 함수를 참조하세요.
사용자 수준의 PII를 노출하는 도구는 사용할 수 없습니다.
MCP 서버를 사용하면 자연어로 Campaign 및 Canvas 성능에 대해 질문하고, Segments와 커스텀 속성을 살펴보고, 보고서를 생성할 수 있습니다. 또한 이메일 템플릿, 콘텐츠 블록, 미디어 라이브러리 에셋과 같은 콘텐츠도 만들 수 있습니다.
베타 MCP 서버는 지원 중단되었나요?
네. 2025년 8월에 출시된 로컬 호스팅 MCP 서버는 지원 중단되었으며 더 이상 업데이트되지 않습니다. 계속 사용할 수는 있지만, Braze는 원격 호스팅 버전으로 마이그레이션할 것을 권장합니다.
원격 서버는 무엇이 다른가요?
이전 Braze MCP 서버는 사용자의 컴퓨터에서 로컬로 실행되었습니다. 패키지를 설치하고, 구성 파일을 관리하고, 적절한 권한이 있는 Braze API 키를 생성해야 했습니다. 원격 MCP 서버를 사용하면 이러한 로컬 설정이 필요 없습니다.
지원되는 MCP 클라이언트에서 1분 이내에 연결할 수 있습니다. 인증에는 OAuth를 사용합니다. 액세스 권한은 공유 API 키가 아닌 Braze 대시보드 사용자 계정에 연결되므로, 에이전트가 보고 수행할 수 있는 작업은 대시보드 권한과 동일합니다. 대시보드 사용자가 Braze에서 액세스 권한을 잃으면 클라이언트도 액세스 권한을 잃습니다.
주요 차이점은 다음과 같습니다.
- 설정: 패키지를 설치하고 구성 파일을 편집하는 대신 Braze URL을 붙여넣습니다.
- 인증: API 키를 생성하는 대신 Braze 계정으로 로그인합니다.
- 권한: 액세스 권한은 API 키 권한이 아닌 대시보드 사용자 계정을 기반으로 합니다.
- 워크스페이스 타겟팅: 워크스페이스 컨텍스트가 로컬 구성에 고정되지 않고 요청마다 전달됩니다.
자주 묻는 질문(FAQ)
어떤 MCP 클라이언트가 지원되나요?
OAuth를 지원하는 원격 MCP 서버와 호환되는 MCP 클라이언트라면 모두 사용할 수 있습니다. Braze에서 검증한 클라이언트는 다음과 같습니다.
- 커스텀 커넥터를 통한 Claude
- 커스텀 커넥터를 통한 ChatGPT
- Cursor
- OpenAI Codex
- Claude Code
- Visual Studio Code
내 MCP 클라이언트가 어떤 Braze 데이터에 접근할 수 있나요?
MCP 클라이언트는 사용자 수준 PII를 반환하지 않는 도구에 접근할 수 있습니다.
내 MCP 클라이언트가 Braze 데이터를 변경할 수 있나요?
네, 대시보드 사용자에게 해당 권한이 있다면 가능합니다.
Braze API 키가 여전히 필요한가요?
MCP에는 필요하지 않습니다. API 키는 REST API에서 계속 작동하며, 지원이 중단될 예정도 없습니다.
어떤 리전이 지원되나요?
두 Braze 클러스터 모두 지원됩니다. 현재 사용할 수 있는 엔드포인트는 두 개입니다.
https://mcp.braze.com/mcp(US)https://mcp.braze.eu/mcp(EU)
두 엔드포인트 중 어느 것을 사용해도 모든 Braze 클러스터에 접근할 수 있습니다.
검증된 목록 외의 도구에서도 Braze 원격 MCP 서버를 사용할 수 있나요?
시도해 볼 수는 있지만 인증이 차단될 수 있습니다. Braze는 현재 보안을 위해 지원 도메인 허용 목록을 관리하고 있습니다. support for your MCP client을(를) 원하시나요? 제품 피드백을 남겨 보세요.
원격 서버가 여러 워크스페이스를 지원하나요?
네. 대화별 또는 요청별로 워크스페이스를 지정하면 됩니다. 연결 하나로 접근 권한이 있는 모든 워크스페이스를 사용할 수 있습니다.
에이전트가 사용자 수준 PII에 접근할 수 있나요?
아니요. 현재 PII를 노출하는 도구는 제공되지 않습니다.
MCP 서버를 통해 수행한 Campaign 편집이 편집 기록에 표시되나요?
네. MCP 도구를 통해 수행한 Campaign 편집은 로그인한 대시보드 사용자의 작업으로 기록되며 Campaign 편집 기록에 표시됩니다.
Canvas 전용 MCP 도구(get_canvas_list, get_canvas_details, get_canvas_data_series, get_canvas_data_summary)는 현재 읽기 전용입니다.
권한이 변경되면 어떻게 되나요?
에이전트 접근 권한은 대시보드 사용자의 권한에 따라 변경됩니다. 권한 변경 사항은 다음 요청부터 적용됩니다. 비활성화된 대시보드 사용자는 MCP 접근 권한을 잃게 됩니다.
클라이언트 디렉토리에서 Braze 커넥터가 보이지 않는 이유는 무엇인가요?
디렉토리 목록은 아직 일부 MCP 클라이언트에서 제공되지 않을 수 있습니다. 이 경우에도 Braze MCP URL을 사용하여 언제든지 수동으로 연결할 수 있습니다.
회사에서 IP 허용 목록을 사용하고 있습니다. 원격 MCP 서버를 사용할 수 있나요?
현재는 사용할 수 없습니다. IP 허용 목록을 사용하는 경우 원격 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 클라이언트를 통해 구현하기 전에 반드시 검토해 주세요.