Operator Connect

Operator Connect를 사용하면 이미 사용 중인 AI 도구(Claude, Cursor 또는 기타 MCP 클라이언트)에서 Braze에 대한 작업을 수행할 수 있으며, BrazeAI Operator^TM가 Braze 대시보드에서 이를 실행합니다.

시작하기 전에

Operator Connect는 각 작업의 사전 승인을 위한 액션 카드를 지원하지 않습니다

MCP 클라이언트를 통해 프롬프트를 제출하여 작업을 수행할 때, Operator는 각 단계를 승인하도록 일시 중지하지 않습니다(Braze 대시보드에서 Operator를 사용할 때와는 다릅니다). 즉, Operator Connect에 프롬프트를 통해 요청한 작업은 승인을 요청할 기회 없이 즉시 실행됩니다. 팀에서 엄격한 변경 관리 요구 사항이 있는 경우, 제한된 권한을 가진 Braze 대시보드 사용자를 프로비저닝하고 해당 사용자로 인증하거나, 대시보드에서 BrazeAI Operator를 통해 해당 워크플로우를 수행하세요.

Operator는 현재 Campaign 또는 Canvases를 실행할 수 없습니다.

제한된 권한을 가진 대시보드 사용자를 설정하는 방법은 회사 사용자 관리를 참조하세요. 이렇게 하면 대시보드에서 Operator의 변경 사항을 더 쉽게 식별할 수 있습니다.

서드파티 공급자 MCP 사용

Operator Connect를 사용할 때, Braze는 Claude, ChatGPT, Copilot, Gemini CLI, Codex 또는 Cursor와 같은 서드파티 공급자 MCP 클라이언트로부터 해당 공급자의 기본 AI 모델이 구성한 그대로의 지침을 수신합니다. 자연어로 요청을 입력하면, AI 모델이 요청을 해석하고 send_operator_prompt 도구를 사용하도록 선택할 때 Operator를 위한 프롬프트로 변환합니다. Braze는 원래의 자연어 프롬프트를 확인하지 않으며, 생성된 프롬프트가 의도한 요청을 완전히 또는 정확하게 반영하는지 검증할 수 없습니다.

BrazeAI Operator가 데이터 또는 결과를 반환하면, 해당 응답은 서드파티 공급자 MCP 클라이언트로 다시 전송되며, 클라이언트가 이를 해석하고 포맷하여 사용자에게 표시합니다. Braze는 AI 모델이 반환된 정보를 어떻게 표시, 요약 또는 설명하는지 제어하지 않습니다.

Braze는 서드파티 공급자 MCP 클라이언트를 통해 생성된 지침이나 전달된 응답에 대해 책임을 지지 않습니다. AI가 생성한 요약 내용은 Braze 대시보드의 소스 데이터와 대조하여 검토하고, AI가 제안한 작업은 서드파티 공급자 MCP 클라이언트를 통해 구현하기 전에 반드시 검토하세요.

에이전트 기반의 판단이 필요한 작업에 Operator Connect를 사용하세요

브리프를 바탕으로 캠페인을 구축하거나, Canvas를 재구성하거나, 워크스페이스에 대한 복잡한 질문에 답하는 것과 같은 작업에 사용하세요. Operator Connect는 대량, 고빈도의 프로그래밍 방식 작업에 적합한 도구가 아닙니다. 그러한 워크플로우에는 Braze REST API를 사용하세요.

변경 추적 및 편집 기록

Operator Connect를 통해 이루어진 Campaign 및 Canvas 편집은 대시보드 편집 기록에 사용자 이름과 함께 표시됩니다. Braze는 대시보드에서 직접 편집한 내용을 추적하는 것과 동일한 방식으로 이러한 변경 사항을 추적합니다.

send_operator_prompt 도구를 사용하여 Campaign 또는 Canvas를 편집하면, 편집 기록에 대시보드 사용자 계정 아래에 변경 사항이 표시됩니다. 이는 대시보드의 BrazeAI Operator와 Braze MCP 서버를 통한 Operator Connect 모두에 적용됩니다.

다른 Braze MCP 서버 도구(예: update_campaign_message_variation)를 사용하여 수행한 편집은 Campaign 편집 기록에 표시되지 않습니다. 모든 Campaign 변경 사항에 대한 전체 감사 추적이 필요한 경우, 개별 MCP 업데이트 도구를 직접 호출하는 대신 Operator Connect를 사용하세요.

전제 조건

Operator Connect를 사용하기 전에 다음 사항을 확인하세요.

전제 조건	설명
호스팅된 Braze MCP 서버	Operator Connect는 호스팅된 OAuth 기반 Braze MCP 서버를 통해서만 사용할 수 있습니다. 로컬 API 키 MCP 서버를 사용하는 고객은 먼저 원격 호스팅 서버로 마이그레이션해야 합니다. Braze MCP 서버 설정을 참조하세요.
US 또는 EU 클러스터	Operator Connect는 현재 베타 단계에서 US 및 EU 클러스터에서만 사용할 수 있습니다.
워크스페이스에서 Operator 활성화	BrazeAI Operator가 워크스페이스에서 활성 상태여야 합니다.
MCP 서버 사용 권한	대시보드 사용자에게 “Use MCP Server” 권한이 필요합니다.

액세스 활성화 후 재인증

Braze에서 계정에 Operator Connect를 활성화하면 기존 MCP 연결이 새로운 범위를 자동으로 가져오지 않습니다. Braze에서 액세스가 활성화되었음을 확인한 후 클라이언트에서 Braze MCP 서버를 제거하고 다시 추가하세요. 도움이 필요하면 문제 해결을 참조하세요.

Operator Connect로 할 수 있는 것

Operator Connect는 대시보드에서 BrazeAI Operator가 할 수 있는 모든 작업을 수행할 수 있으며, 다음을 포함합니다:

• Campaigns 및 Canvases 빌드 및 편집
• Segments 생성 및 업데이트
• 이메일, 단문 메시지 서비스, 푸시, 인앱 메시지 문구 및 템플릿 작성
• Content Blocks 관리
• 보고서 생성 및 워크스페이스 데이터에 기반한 질문 응답

전체 기능 목록은 Operator로 할 수 있는 것을 참조하세요.

Operator Connect 작동 방식

프롬프트를 자연어로 작성하세요. MCP 클라이언트는 일반적으로 브리프를 기반으로 Operator Connect를 자동으로 선택하므로, Operator나 해당 도구를 직접 지정할 필요가 없습니다.

클라이언트가 Operator로 완료할 수 있는 작업에 대해 Operator Connect를 건너뛰는 경우, Operator Connect를 사용하도록 보다 명시적인 지시를 추가할 수 있습니다.

프롬프트를 전송하면 클라이언트가 이를 Operator에 제출하고 결과를 자동으로 가져옵니다. 호스팅된 Braze MCP 서버의 세 가지 도구가 이를 처리합니다:

• send_operator_prompt — 자연어 프롬프트를 제출하고 작업 ID를 반환합니다. Operator는 작업을 비동기적으로 실행합니다.
• get_operator_result — 주어진 작업 ID에 대한 결과를 가져옵니다.
• cancel_operator_job — 실행 중인 작업을 중지합니다.

예를 들어, AI 도구에 브리프를 기반으로 활성화 Canvas를 생성하도록 요청할 수 있습니다. 클라이언트가 Operator Connect를 호출하면, 워크스페이스와 Segment를 조회한 다음 Braze에서 Canvas를 초안으로 작성하여 검토 후 실행할 수 있도록 합니다.

프롬프트 예시

자연어 브리프로 시작하세요. 다음은 몇 가지 예시입니다:

예상할 수 있는 사항

Operator Connect는 동기식 API 호출과는 다르게 작동합니다. 다음 사항을 미리 계획해 두세요.

비동기 응답

응답이 몇 초가 아닌 몇 분이 걸릴 수 있습니다. Operator Connect는 각 작업을 완전한 에이전트 세션으로 실행하며, 대시보드에서 동일한 작업을 수행하는 것과 비슷한 시간이 소요됩니다. Operator Connect 출력을 다른 사람이나 다운스트림 시스템과 공유하는 경우 이에 맞게 기대치를 설정하세요. 이러한 도구를 직접 호출하는 커스텀 에이전트를 구축하는 경우, 즉각적인 응답을 기대하지 말고 get_operator_result를 폴링하도록 설계하세요. 응답은 구조화된 출력 형식 없이 텍스트로 반환됩니다.

호출 간 세션 메모리 없음

각 프롬프트는 자체 격리된 세션에서 실행됩니다. Operator는 한 호출에서 다음 호출로 컨텍스트를 전달하지 않습니다. 다음 프롬프트가 이전 프롬프트의 출력에 의존하는 경우, 새 프롬프트에 관련 컨텍스트를 포함하세요.

관찰 가능성 뷰 없음

이 베타 버전에서는 Operator Connect 사용에 대한 전용 대시보드 UI, 세션 로그 또는 관찰 가능성 뷰가 없습니다. Operator가 수행한 작업은 해당 대시보드 사용자의 일반 기여도 아래에 표시됩니다.

인증 및 권한

Operator Connect는 Braze MCP 서버와 동일한 로그인 방식을 사용합니다. 일반 Braze 자격 증명을 그대로 사용하며, 별도의 로그인이 필요하지 않습니다. Operator Connect는 공유 API 키가 아닌 대시보드 사용자 계정에 액세스를 연결합니다. 이는 다음을 의미합니다:

• Operator는 해당 사용자의 정확한 대시보드 권한으로 동작합니다. 사용자가 직접 수행할 수 없는 작업은 Operator도 수행할 수 없습니다.
• Operator Connect는 서비스 계정이나 공유 자격 증명을 사용하지 않습니다.
• 대시보드는 모든 변경 사항을 로그인한 사용자에게 귀속시킵니다. 예를 들어, “Alex”라는 사용자가 Operator Connect를 통해 Campaign을 업데이트하면 대시보드에는 Last updated by Operator가 아닌 Last updated by Alex로 표시됩니다.
• 사용자가 Braze에서 액세스 권한을 잃으면, Braze는 다음 요청 시 해당 사용자의 Operator Connect 액세스를 취소합니다.

가격 정책

Operator Connect 사용량은 대시보드 사용량과 동일한 회사 전체 일일 Operator 비용 한도에 포함됩니다. 프로그래밍 방식의 사용은 일반적으로 인터랙티브 사용보다 더 많은 비용을 소비하므로, 베타 참가자에게는 프로그램 기간 동안 일시적으로 상향된 일일 한도가 제공됩니다.

• 상향된 한도는 베타 프로그램 기간 동안에만 적용되며, 변경될 수 있습니다.
• Braze는 한도 내에서 유지될 수 있다고 보장하지 않습니다. 한도에 도달하면 고객 성공 매니저에게 문의하세요.

Operator Connect는 정식 출시 시 유료 기능이 될 예정입니다. 베타 참여는 무료이지만, 향후 가격 정책을 반영하지는 않습니다.

데이터 프라이버시 및 보안

Operator Connect는 BrazeAI Operator^TM와 동일한 프라이버시 및 보안 모델을 따르며, 동일한 데이터 프로세서 관계를 포함합니다. 자세한 내용은 BrazeAI Operator의 데이터 프라이버시 및 보안을 참조하세요.

문제 해결

액세스 활성화 후 Operator 도구가 표시되지 않는 경우

Braze가 계정에 Operator Connect를 활성화하면 기존 MCP 클라이언트 연결이 업데이트된 액세스 권한을 자동으로 인식하지 못할 수 있습니다. 프롬프트를 제출했을 때 인증 오류가 발생하거나 클라이언트에 Operator 도구가 표시되지 않는 경우:

1. MCP 클라이언트에서 Braze MCP 서버 연결을 제거합니다.
2. 엔드포인트 URL(https://mcp.braze.com/mcp(미국) 또는 https://mcp.braze.eu/mcp(EU))을 사용하여 Braze MCP 서버를 다시 추가합니다.
3. OAuth 로그인 흐름을 다시 완료합니다.

다시 추가한 후 클라이언트는 Operator Connect를 포함한 업데이트된 액세스 권한으로 등록됩니다. 문제가 계속되면 고객 성공 매니저에게 문의하세요.

다음 단계

• Braze MCP 서버 설정 (Operator Connect의 전제 조건)
• BrazeAI Operator
• Operator로 할 수 있는 것