概要
AI に Braze を操作させます。キャンペーンと Canvas とその成果の確認、セグメント、デイリーアクティブユーザー、収益のチェック、ユーザープロファイルと購読の参照、属性とイベントの記録ができ、あなたの確認後に API キャンペーンを実行できます。
ガイド付きセットアップ
Braze を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Braze を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Braze のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Braze をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Braze + Microsoft Copilot
AI に Braze を操作させます。キャンペーンと Canvas とその成果の確認、セグメント、デイリーアクティブユーザー、収益のチェック、ユーザープロファイルと購読の参照、属性とイベントの記録ができ、あなたの確認後に API キャンペーンを実行できます。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
BRAZE_REST_ENDPOINT, BRAZE_REST_API_KEY
ステップ 1 — 認証情報を取得
- Braze で Settings → APIs and Identifiers → API Keys を開き、Create API Key をクリックします。キーは 1 つのワークスペースに属します。
- 名前を付け、ツールに必要な権限にチェックを入れます。読み取り用:
campaigns.list,campaigns.details,campaigns.data_series,sends.data_series,canvas.list,canvas.details,canvas.data_summary,segments.list,segments.details,segments.data_series,kpi.dau.data_series,kpi.mau.data_series,kpi.new_users.data_series,kpi.uninstalls.data_series,events.list,events.data_series,purchases.product_list,purchases.quantity_series,purchases.revenue_series,subscription.status.get,subscription.groups.get,users.export.ids。書き込みにはusers.track,campaigns.trigger.send,canvas.trigger.sendを追加し、削除ツールを有効にする場合にだけusers.deleteも追加します。キーの権限は後から変更できないため、必要なら新しいキーを作成してください。 - キーを Bearer という接頭辞を付けずに
BRAZE_REST_API_KEYにコピーします。 - 同じページに表示される REST endpoint を
BRAZE_REST_ENDPOINTにコピーします。エンドポイントは Braze のインスタンスによって異なり、ダッシュボードのアドレスと対応しています。dashboard-01.braze.comならhttps://rest.iad-01.braze.com、dashboard-01.braze.euならhttps://rest.fra-01.braze.euといった具合です。米国のインスタンスはrest.iad-01からrest.iad-08とrest.us-10（.braze.com）、EU のインスタンスはrest.fra-01とrest.fra-02（.braze.eu）、そのほかはrest.au-01、rest.id-01、rest.jp-01、rest.kr-01（.braze.com）です。キーは自分のインスタンスでしか使えません。 - コネクタをインストールします。接続チェックではキャンペーンを一覧するため、キーには
campaigns.listが必要です。
誰が何を見られるか: キーは個人ではなくワークスペース全体の権限で動きます。コネクタを使う人は、ユーザープロファイルを含め、キーで読めるものをすべて見られます。MCP サーバーは、それを見てよい人とだけ共有してください。
読み取れるデータ: 設定、メッセージ、日次の成果（送信、配信、開封、クリック、コンバージョン、収益）を含むキャンペーンと Canvas、API でトリガーした 1 回の送信の成果（保存期間 14 日）、推定サイズを含むセグメント（アナリティクス追跡を有効にしたセグメント）、デイリーとマンスリーのアクティブユーザー、新規ユーザー、アンインストール、カスタムイベント、購入と収益、external id、エイリアス、braze_id、メール、電話番号で指定するユーザープロファイル、購読グループの状態です。時系列は 1〜100 日、Canvas のサマリーは 1〜14 日が対象です。
先に確認します: braze_track_users は属性、カスタムイベント、購入を 1 回の呼び出しで最大 75 件記録し、ユーザーをセグメントに入れたり Canvas を開始させたりすることがあります。そのため AI は変更内容を示し、あなたの確認を待ちます。braze_send_campaign と braze_send_canvas は、実在の人に実際のメッセージを送る API キャンペーンと Canvas を開始します。AI はキャンペーンまたは Canvas、チャネル、受信する人を正確に示し、ブロードキャストや複数の受信者の場合は、はっきりした「はい、送信」を待ちます。braze_delete_users はインストール時に無効になっています。
制限: ほとんどのエンドポイントは 1 時間あたり 250,000 リクエストまでです。ユーザープロファイルの読み取りは、2024 年 8 月以降に開始したワークスペースで 1 分あたり 250 回（それ以前は 2,500 回）、カスタムイベントと商品の一覧は合わせて 1 時間あたり 1,000 回、送信エンドポイントはブロードキャストが 1 分あたり 250 回、オーディエンスごとに 1 分あたり 10 回までです。上限に達すると Braze は 429 を返します。
よくあるエラー: 401 "Invalid API key": キーが間違っているか、別のインスタンスのものです。REST endpoint がダッシュボードと合っているか確認してください。403 "Access Denied": キーにこのエンドポイントの権限がありません。権限を持つキーを作成してください。400: パラメーターが足りないか無効です。たとえば期間が範囲外、または不明なキャンペーン ID です。429: レート制限に達しています。時間をおいて一度だけ再試行してください。
このコネクタは、コンテンツブロックとテンプレート、カタログ、メールリストとハードバウンス、予約済みメッセージ、プリファレンスセンター、SCIM、ユーザーエイリアスと identify のエンドポイント、クラウドストレージへのセグメントエクスポート、Currents には対応していません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
Brazeのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
braze_list_campaigns | List the campaigns of the Braze workspace, 100 per page: id (campaign API identifier), name, whether it is an API campaign, tags and last… |
braze_get_campaign | Get the details of one Braze campaign: name, description, enabled, archived and draft flags, schedule type, channels, first and last sent… |
braze_get_campaign_data_series | Get a daily series of a Braze campaign's results: unique recipients, conversions, revenue and, per channel and variation, sends… |
braze_get_send_data_series | Get the daily results of one send of an API campaign (a send_id groups the messages of one trigger call): per channel and variation sends… |
braze_list_canvases | List the Canvases (multi-step journeys) of the Braze workspace, 100 per page: id (Canvas API identifier), name, tags and last edit time |
braze_get_canvas | Get the details of one Braze Canvas: name, description, enabled, archived and draft flags, schedule type, first and last entry, channels… |
braze_get_canvas_data_summary | Get the totals of a Braze Canvas for a period: entries, conversions, revenue and, on request, the same per variant and per step with… |
braze_list_segments | List the segments of the Braze workspace, 100 per page: id (segment API identifier), name, whether analytics tracking is enabled, and tags |
braze_get_segment | Get the details of one Braze segment: name, description of its filters, created and updated time, and tags |
braze_get_segment_size_series | Get the estimated size of a Braze segment per day |
braze_get_kpi_series | Get a daily series of a Braze key metric for the workspace or one app: dau (daily active users), mau (monthly active users, rolling 30… |
braze_list_custom_events | List the names of the custom events recorded in the Braze workspace, 250 per page, in alphabetical order |
braze_get_custom_event_series | Get how often a Braze custom event occurred per day or per hour, for the workspace, one app or one analytics-enabled segment |
braze_list_products | List the product ids of the purchases recorded in Braze, page by page |
braze_get_purchase_quantity_series | Get the number of items purchased per day or per hour in Braze, for all products or one, for the workspace or one app |
braze_get_revenue_series | Get the revenue per day or per hour recorded from purchases in Braze, for all products or one, for the workspace or one app |
braze_get_subscription_group_status | Get whether a user is subscribed to one Braze subscription group (SMS, WhatsApp or email), identified by external_id, email or phone |
braze_list_user_subscription_groups | List the subscription groups a Braze user belongs to and their state, identified by external_id, email or phone |
braze_export_users_by_ids | Read Braze user profiles by identifier: external_ids (up to 50), user aliases, braze_id, email_address or phone |
braze_track_users | Write to Braze user profiles: set or change attributes (standard and custom), record custom events and record purchases, up to 75 objects… |
braze_send_campaign | Send an API-triggered Braze campaign now: to listed recipients, to a connected audience, or with broadcast true to the campaign's whole… |
braze_send_canvas | Start an API-triggered Braze Canvas now: for listed recipients, a connected audience, or with broadcast true for the Canvas's whole target… |
braze_delete_users | Permanently delete Braze user profiles, up to 50 per call, by external_ids, user_aliases, braze_ids, email_addresses or phone_numbers, only… |
プロンプトの例
- 「過去 30 日に送ったキャンペーンはどれですか？開封率とクリック率が最も高かったのはどれですか？」
- 「先週オンボーディングの Canvas に入ったユーザーは何人で、各ステップで何人がコンバージョンしましたか？」
- 「過去 60 日のデイリーアクティブユーザーと新規ユーザーを見せてください。」
- 「external_id が 4821 のユーザーにカスタムイベント webinar_attended を記録してください。記録する前に書き込む内容を見せてください。」
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?