コンテンツにスキップ

Operator Connect

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

始める前に

Operator Connectは各アクションの事前承認用アクションカードをサポートしていません

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

Operatorは現在、キャンペーンやキャンバスをローンチすることはできません。

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

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

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

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

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

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クラスターでのみ利用可能です。
ワークスペースで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の仕組み

プロンプトは自然言語で記述します。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を呼び出し、ワークスペースとセグメントを検索してから、Brazeで下書きとしてキャンバスを構築します。あとはレビューして公開するだけです。

Operator Connectがfinanceappワークスペースとpyrite unfunded sign-ups 30 to 90 dayセグメントを検出し、キャンバスを作成するAIチャットセッション。キャンバス内のメール版のプレビューが横に表示されています。

プロンプトの例

自然言語のブリーフから始めましょう。以下にいくつかの例を示します。

Build a three-step welcome キャンバス for new loyalty members—email on day 1, push on day 3, and an in-app message on day 7. Save it as a draft in the Production workspace.

Review the Subject Line and Preheader of the 'Summer Sale Email' campaign in the Production workspace and suggest improvements for better open rates.

Create a segment for users who have made a purchase in the last 30 days but haven't opened a push notification in the last 14 days.

What were our top five email campaigns by click rate last quarter? Summarize the key differences between them.

想定されること

Operator Connectは同期APIコールとは異なる仕組みで動作します。以下の点を計画に含めてください。

非同期レスポンス

レスポンスには数秒ではなく、数分かかる場合があります。Operator Connectは各ジョブを完全なエージェントセッションとして実行するため、ダッシュボードで同等の作業を行うのとほぼ同じ時間がかかります。Operator Connectの出力を他の人や下流のシステムと共有する場合は、それに応じた期待値を設定してください。これらのツールを直接呼び出すカスタムエージェントを構築する場合は、即時レスポンスを期待するのではなく、get_operator_resultをポーリングするように設計してください。レスポンスはテキストとして返され、構造化された出力形式はありません。

コール間のセッションメモリなし

各プロンプトは独立したセッションで実行されます。Operatorはあるコールから次のコールへコンテキストを引き継ぎません。次のプロンプトが前のプロンプトの出力に依存する場合は、新しいプロンプトに関連するコンテキストを含めてください。

オブザーバビリティビューなし

このベータ版では、Operator Connectの使用状況に関する専用のダッシュボードUI、セッションログ、またはオブザーバビリティビューはありません。Operatorが実行したアクションは、操作を行ったダッシュボードユーザーの通常のアトリビューションとしてダッシュボードに表示されます。

認証と権限

Operator Connectは、Braze MCPサーバーと同じサインインを使用します。通常のBraze認証情報を使用し、別途ログインする必要はありません。Operator Connectは共有APIキーではなく、ダッシュボードのユーザーアカウントにアクセスを紐付けます。これは以下を意味します:

  • BrazeAI Operatorは、そのユーザーのダッシュボード権限と同じ権限で動作します。ユーザーが直接実行できないアクションを実行することはできません。
  • Operator Connectはサービスアカウントや共有認証情報を使用しません。
  • ダッシュボードでは、すべての変更がサインイン中のユーザーに帰属します。たとえば、「Alex」というユーザーがOperator Connectを通じてキャンペーンを更新した場合、ダッシュボードには「Last updated by Operator」ではなく「Last updated by Alex」と表示されます。
  • ユーザーがBrazeへのアクセスを失った場合、Brazeは次のリクエスト時にそのユーザーのOperator Connectアクセスを取り消します。

料金

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

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

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

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

Operator Connectは、BrazeAI OperatorTMと同じプライバシーおよびセキュリティモデルに従っており、同じデータ処理者関係が適用されます。詳細については、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を含む更新されたアクセス権限で登録されます。問題が続く場合は、カスタマーサクセスマネージャーにお問い合わせください。

次のステップ

New Stuff!