Skip to content

Braze MCP 서버 사용하기

원격 Braze MCP 서버에 연결한 후 자연어를 통해 Braze 데이터와 상호작용하는 방법을 배우세요. 자세한 내용은 Braze MCP 서버를 참조하세요.

사전 요구 사항

이 기능을 사용하려면 먼저 Braze MCP 서버를 설정해야 합니다.

모범 사례

자연어 도구를 통해 Braze MCP 서버를 사용할 때 다음 팁을 참고하세요.

  • 특히 여러 워크스페이스에 액세스할 수 있는 경우, 프롬프트에서 워크스페이스를 확인하세요.
  • 분석을 요청할 때 날짜 범위와 측정기준을 구체적으로 지정하세요.
  • 출력을 검증할 때 에이전트에게 어떤 도구를 사용했는지 확인하도록 요청하세요.
  • 영향력이 큰 권장 사항은 Braze 대시보드의 소스 데이터와 비교하세요.

사용 예시

Braze MCP 서버를 설정한 후, 자연어를 통해 Braze와 상호작용할 수 있습니다. 다음은 시작하는 데 도움이 되는 예시입니다.

어떤 워크스페이스에 접근할 수 있나요?

사용 가능한 Braze 워크스페이스를 보여주고, 프로덕션 캠페인 분석에 어떤 워크스페이스를 사용해야 하는지 알려주세요.

get_workspaces를 호출하여 다음 워크스페이스를 찾았습니다:

  • Marketing - Production (app_group_id: YOUR-APP-GROUP-ID-1)
  • Marketing - Staging (app_group_id: YOUR-APP-GROUP-ID-2)

프로덕션 캠페인 분석 프롬프트에는 Marketing - Production을 사용하세요.

자세한 내용은 사용 가능한 API 함수를 참조하세요.

지난주 캠페인 성과를 보여주세요

Marketing - Production 워크스페이스에서 지난 7일간의 캠페인 성과를 발송, 열람, 클릭, 상위 성과 캠페인을 포함하여 보여주세요.

요청하신 워크스페이스와 기간에 대해 get_campaign_list와 get_campaign_dataseries를 사용했습니다.

요약:

  • 총 발송 수: YOUR-TEST-SENDS
  • 총 열람 수: YOUR-TEST-OPENS
  • 총 클릭 수: YOUR-TEST-CLICKS
  • 열람 기준 상위 캠페인: YOUR-TEST-CAMPAIGN-NAME

필요하시면 캠페인별, 채널별 또는 일별로 세분화할 수 있습니다.

자세한 내용은 사용 가능한 API 함수를 참조하세요.

이메일 템플릿 만들기

Marketing - Production 워크스페이스에서 "YOUR-TEST-TEMPLATE-NAME"이라는 이름의 온보딩 이메일 템플릿을 만들어 주세요.

create_email_template을 사용하여 템플릿을 생성했습니다.

  • 템플릿 ID: YOUR-TEST-TEMPLATE-ID-123
  • 템플릿 이름: YOUR-TEST-TEMPLATE-NAME
  • 워크스페이스: Marketing - Production

자세한 내용은 사용 가능한 API 함수를 참조하세요.

워크플로 예시

이 예시들은 여러 도구를 결합하여 작업을 처음부터 끝까지 완료하는 방법을 보여줍니다.

여러 워크스페이스에 걸친 리포트 생성

Get me an analytics report for the past week from my US Prod workspace and my EU Prod workspace, and compare total sends and open rates.

get_workspaces를 호출하여 접근 권한을 확인한 후, 각 워크스페이스에 대해 지난 7일간의 get_campaign_dataseries를 실행했습니다.

  • US Prod: YOUR-TEST-SENDS 발송, YOUR-TEST-OPEN-RATE 열람율
  • EU Prod: YOUR-TEST-SENDS 발송, YOUR-TEST-OPEN-RATE 열람율

이번 주에는 US Prod에서 더 많은 메시지를 발송했고, EU Prod의 열람율이 더 높았습니다. 각 워크스페이스를 Campaign 또는 채널별로 세분화할 수 있습니다.

스테이징에서 프로덕션으로 템플릿 복사

Copy the email templates from my Staging workspace to my Production workspace.

get_email_templates와 get_email_template_info를 사용하여 Staging의 템플릿을 읽은 후, create_email_template을 사용하여 Production에 각 템플릿을 다시 생성했습니다.

  • YOUR-TEST-TEMPLATE-NAME-1: Production에 생성됨 (YOUR-TEST-TEMPLATE-ID-1)
  • YOUR-TEST-TEMPLATE-NAME-2: Production에 생성됨 (YOUR-TEST-TEMPLATE-ID-2)

get_email_template_info에서 지원하지 않는 드래그 앤 드롭 편집기 템플릿은 건너뛰었습니다. 복사된 템플릿을 검토하길 원하시면 알려주세요.

주간 Campaign 상태 요약

Give me a weekly campaign health summary for the Production workspace.

get_campaign_list와 get_campaign_dataseries를 사용하여 Production의 지난 7일간 활동 데이터를 가져왔습니다.

  • 총 발송 수: YOUR-TEST-SENDS
  • 열람율: YOUR-TEST-OPEN-RATE
  • 클릭률: YOUR-TEST-CLICK-RATE
  • 전환 기준 상위 Campaign: YOUR-TEST-CAMPAIGN-NAME

발송 수가 전주 대비 증가했습니다. 채널별 세분화를 추가하거나 인게이지먼트가 감소하고 있는 Campaign을 표시할 수 있습니다.

원격 MCP 서버 작동 방식

요청을 보내면 백그라운드에서 몇 가지 단계가 진행됩니다.

  1. 클라이언트에 프롬프트를 입력합니다. 지난주 Campaign 성과를 요청하는 것처럼 자연어로 요청을 입력합니다.
  2. 클라이언트의 모델이 도구를 선택합니다. 클라이언트의 AI 모델이 요청을 해석하고 get_campaign_list 및 get_campaign_dataseries와 같은 하나 이상의 Braze 도구 호출로 변환합니다.
  3. Braze가 도구 호출을 실행합니다. 원격 MCP 서버가 인증된 OAuth 세션을 통해 각 도구 호출을 수신하고, 지정한 워크스페이스를 적용한 후 해당하는 Braze REST API 엔드포인트에 대해 실행합니다.
  4. Braze가 결과를 반환합니다. 서버가 데이터를 클라이언트로 다시 전송하면, 클라이언트가 이를 포맷하여 사용자에게 표시합니다.

사용자의 접근 권한은 두 가지의 교집합으로 결정됩니다.

  • 연결 인증 시 부여된 스코프(예: mcp:tools).
  • 사용자 본인의 대시보드 권한. 대시보드에서 Campaigns를 조회할 수 없다면 에이전트도 조회할 수 없습니다. 이메일 템플릿을 생성할 수 있다면 에이전트도 생성할 수 있습니다. 에이전트는 사용자 본인의 접근 권한을 초과할 수 없습니다.

워크스페이스 컨텍스트는 로컬 설정 파일에 저장되지 않고 각 요청과 함께 전달되므로, 하나의 연결로 접근 권한이 있는 모든 워크스페이스에서 작업할 수 있습니다.

지시 및 응답 처리 방식

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