Operator Connect

Operator Connectを使用すると、Claude、Cursor、その他のMCPクライアントなど、すでに使用しているAIツールからBrazeでアクションを実行でき、BrazeAI Operator^TMがBrazeダッシュボードで実行します。

始める前に

Operator Connect は各アクションを事前承認するアクションカードに対応していません

MCP クライアントからプロンプトを送信してアクションを実行する場合、Operator は各ステップで一時停止して承認を求めません (Braze ダッシュボードで Operator を使用する場合とは異なります)。そのため、プロンプトで Operator Connect に依頼したアクションは、承認の機会なしにすぐ実行されます。チームに厳格な変更管理要件がある場合は、権限を制限した Braze ダッシュボードユーザーを用意してそのユーザーとして認証するか、ダッシュボードの BrazeAI Operator でそれらのワークフローを実行してください。

現在、Operator はキャンペーンやキャンバスを開始できません。

権限を制限したダッシュボードユーザーの設定方法については、会社ユーザーの管理を参照してください。こうすることで、ダッシュボード上で Operator による変更を識別しやすくなります。

サードパーティプロバイダーの MCP の使用

Operator Connect を使用すると、Braze は Claude、ChatGPT、Copilot、Gemini CLI、Codex、Cursor などのサードパーティプロバイダーの MCP クライアントから指示を受け取ります。この指示は、そのプロバイダーの基盤となる AI モデルが作成したとおりの内容です。自然言語でリクエストを入力すると、AI モデルがリクエストを解釈し、send_operator_prompt ツールを使用すると判断した場合に、そのリクエストを Operator 向けのプロンプトに変換します。Braze は元の自然言語のプロンプトを確認できず、生成されたプロンプトが意図したリクエストを完全かつ正確に反映しているかを検証することはできません。

BrazeAI Operator がデータや結果を返すと、そのレスポンスはサードパーティプロバイダーの MCP クライアントに送り返され、クライアントがそれを解釈、整形してユーザーに提示します。返された情報を AI モデルがどのように提示、要約、説明するかを Braze が制御することはできません。

Braze は、サードパーティプロバイダーの MCP クライアントによって生成された指示、またはそのクライアントを通じて伝えられたレスポンスについて責任を負いません。AI が生成した要約は、Braze ダッシュボードのソースデータと照らし合わせて確認してください。MCP クライアントの「自動モード」は使用せず、AI が提案するアクションは実行前に確認することをおすすめします。

エージェント的で判断を要する作業には Operator Connect を使用する

Operator Connect は、ブリーフからのキャンペーン作成、キャンバスの再構成、ワークスペースに関する複雑な質問への回答などに使用してください。大量かつ高頻度のプログラムによる操作には適していません。そのようなワークフローには、Braze REST API を使用してください。

変更追跡と編集履歴

Operator Connect を通じて行われたキャンペーンとキャンバスの編集は、ダッシュボードの編集履歴にユーザー名とともに表示されます。Braze は、ダッシュボードで直接行った編集と同じ方法でこれらの変更を追跡します。

send_operator_prompt ツールを使用してキャンペーンまたはキャンバスを編集すると、編集履歴にはダッシュボードのユーザーアカウントでの変更として表示されます。これは、ダッシュボード内の BrazeAI Operator と、Braze MCP サーバー経由の Operator Connect の両方に適用されます。

その他の Braze MCP サーバーツール (update_campaign_message_variation など) を使用して行った編集は、キャンペーンの編集履歴には表示されません。すべてのキャンペーン変更について完全な監査証跡が必要な場合は、個別の MCP 更新ツールを直接呼び出すのではなく、Operator Connect を使用してください。

前提条件

Operator Connect を使用する前に、以下を確認してください。

前提条件	説明
ホスト型 Braze MCP サーバー	Operator Connect は、OAuth ベースのホスト型 Braze MCP サーバーからのみ利用できます。ローカルの API キー方式の MCP サーバーを使用している顧客は、先にリモートホスト型サーバーへ移行する必要があります。Braze MCP サーバーの設定を参照してください。
US または EU クラスター	現在のベータ段階では、Operator Connect は US および EU クラスターでのみ利用できます。
有料の 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でできることをすべて実行できます。たとえば、次のようなことが可能です。

• キャンペーンとキャンバスの作成と編集
• セグメントの作成と更新
• メール、SMS、プッシュ、アプリ内メッセージのコピーとテンプレートの下書き作成
• Content Blocksの管理
• ワークスペースのデータに基づくレポートの生成と質問への回答

機能の一覧については、Operatorでできることを参照してください。

Operator Connectの仕組み

プロンプトは自然言語で記述します。通常、Operatorやそのツールを名前で指定しなくても、MCPクライアントが指示内容からOperator Connectを選択します。

Operatorで完了できるタスクなのにクライアントがOperator Connectを使わない場合は、Operator Connectを使うよう明示的な指示を追加できます。

プロンプトを送信すると、クライアントがそれをOperatorに送信し、結果を自動的に取得します。この処理は、ホスト型Braze MCPサーバー上の次の3つのツールが担います。

• send_operator_prompt — 自然言語のプロンプトを送信し、ジョブIDを返します。Operatorはジョブを非同期で実行します。
• get_operator_result — 指定したジョブIDの結果を取得します。
• cancel_operator_job — 実行中のジョブを停止します。

たとえば、AIツールに指示内容に基づいてアクティベーション用のキャンバスを作成するよう依頼できます。クライアントがOperator Connectを呼び出し、Operator Connectがワークスペースとセグメントを検索したうえで、Brazeでキャンバスを下書きとして作成します。作成されたキャンバスは、確認してからローンチできます。

プロンプトの例

まずは自然言語で指示内容を記述しましょう。以下にいくつか例を紹介します。

想定される動作

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 Connect は、サービスアカウントや共有の認証情報を使用しません。
• ダッシュボードでは、すべての変更がサインインしたユーザーによるものとして記録されます。たとえば、「Alex」という名前のユーザーが Operator Connect を通じてキャンペーンを更新した場合、ダッシュボードには「最終更新者: Operator」ではなく「最終更新者: Alex」と表示されます。
• ユーザーが Braze へのアクセス権を失うと、Braze は次回のリクエスト時にそのユーザーの Operator Connect へのアクセス権を取り消します。

料金

Operator Connectの使用量は、ダッシュボードでの使用と同じく、会社全体で共通の1日あたりのOperatorコスト上限にカウントされます。プログラムによる使用は通常、対話型の使用よりも多くのリソースを消費するため、ベータ参加者にはプログラム期間中、1日あたりの上限が一時的に引き上げられます。

• 引き上げられた上限はベータプログラムの期間中のみ適用され、変更される場合があります。
• Brazeは、お客様が上限内に収まることを保証できません。上限に達した場合は、カスタマーサクセスマネージャーにお問い合わせください。

Operator Connectは、一般提供時に有料機能となる予定です。ベータへの参加は無料ですが、将来の料金を反映するものではありません。

データのプライバシーとセキュリティ

Operator Connect は、BrazeAI Operator^TM と同じプライバシーおよびセキュリティモデルに従っており、データ処理者との関係も同じです。詳細については、BrazeAI Operatorのデータプライバシーとセキュリティを参照してください。

トラブルシューティング

アクセスが有効になった後、Operatorツールが表示されない

BrazeがアカウントでOperator Connectを有効にしても、既存のMCPクライアント接続は更新されたアクセス権限を自動的に取得しない場合があります。プロンプトを送信して認証エラーが発生した場合、またはOperatorツールがクライアントに表示されない場合は、以下の手順を実行してください。

1. MCPクライアントで、Braze MCPサーバー接続を削除します。
2. エンドポイントURL（USの場合はhttps://mcp.braze.com/mcp、EUの場合はhttps://mcp.braze.eu/mcp）を使用してBraze MCPサーバーを再追加します。
3. OAuthサインインフローを再度完了します。

再追加後、クライアントはOperator Connectを含む更新されたアクセス権限で登録されます。問題が続く場合は、カスタマーサクセスマネージャーにお問い合わせください。

次のステップ

• Braze MCP サーバーを設定する(Operator Connect の前提条件)
• BrazeAI Operator
• Operator でできること