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는 현재 Campaigns 또는 Canvases를 실행할 수 없습니다.

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

타사 제공업체 MCP 사용

Operator Connect를 사용할 때 Braze는 Claude, ChatGPT, Copilot, Gemini CLI, Codex, Cursor 등 타사 제공업체 MCP 클라이언트로부터 해당 제공업체의 기본 인공지능 모델이 작성한 그대로 지침을 받습니다. 자연어로 요청을 입력하면 인공지능 모델이 요청을 해석하고, 모델이 send_operator_prompt 도구를 사용하기로 선택했을 때 이를 Operator용 프롬프트로 변환합니다. Braze는 원래 입력한 자연어 프롬프트를 볼 수 없으며, 생성된 프롬프트가 의도한 요청을 완전하고 정확하게 반영하는지 확인할 수 없습니다.

BrazeAI Operator가 데이터나 결과를 반환하면 해당 응답은 타사 제공업체 MCP 클라이언트로 다시 전송되고, 클라이언트가 이를 해석하고 형식을 지정하여 사용자에게 표시합니다. Braze는 인공지능 모델이 반환된 정보를 표시하거나 요약하거나 설명하는 방식을 제어하지 않습니다.

Braze는 타사 제공업체 MCP 클라이언트가 생성한 지침이나 이를 통해 전달된 응답에 대해 책임을 지지 않습니다. 인공지능이 생성한 요약은 Braze 대시보드의 원본 데이터와 비교하여 검토하고, 인공지능이 제안한 작업은 타사 제공업체 MCP 클라이언트를 통해 실행하기 전에 반드시 검토하세요.

에이전트 방식의 판단이 많이 필요한 작업에 Operator Connect 사용

브리프를 바탕으로 Campaign을 구축하거나, 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 클러스터	현재 베타 단계에서는 US 및 EU 클러스터에서만 Operator Connect를 사용할 수 있습니다.
유료 Braze 계정	Braze MCP 서버는 무료 평가판 계정에서 사용할 수 없습니다.
워크스페이스에 Operator 활성화	워크스페이스에서 BrazeAI Operator가 활성화되어 있어야 합니다.
Use MCP Server 권한	대시보드 사용자에게 “Use MCP Server” 권한이 있어야 합니다.

액세스 활성화 후 재인증하기

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

Operator Connect로 할 수 있는 작업

Operator Connect는 대시보드의 BrazeAI Operator가 할 수 있는 모든 작업을 수행할 수 있습니다. 예를 들면 다음과 같습니다.

• Campaigns 및 Canvases 구축 및 편집
• Segments 생성 및 업데이트
• 이메일, SMS, 푸시, 인앱 메시지 문구 및 템플릿 초안 작성
• 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를 호출하고, 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을 업데이트하면, 대시보드에는 “마지막 업데이트: Operator”가 아니라 “마지막 업데이트: 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로 할 수 있는 작업