Braze MCPサーバー
Braze MCPサーバーについて学びましょう。これはClaudeやCursorのようなAIツールが非PIIのBrazeデータにアクセスして質問に答え、傾向を分析し、インサイトを提供できるようにする安全な接続です。
ローカルホスト型のBraze MCPサーバー（ベータ版）は、今夏にSunsetting（配信停止）となります。引き続き動作しますが、エンドポイントの追加やベータ版のサポートは終了しています。リモートのBrazeホスト型MCPサーバーは、今夏に早期アクセスとして提供される予定です。
ローカルホスト型Braze MCPサーバーのSunsetting (配信停止)
今夏、BrazeはリモートのBrazeホスト型MCPサーバーを早期アクセスとして提供開始します。これは、ローカルホスト型のベータサーバー（PyPI上のbraze-mcp-serverおよびClaude Desktopの拡張機能ディレクトリ）に代わるものです。
これがあなたにとって意味すること：
- ローカルホスト型サーバーは引き続き動作しますが、サポートは終了しています。ベータ版への新しいエンドポイントの追加や問題の修正は行いません。
- リモートサーバーが早期アクセスで利用可能になった際には、切り替えが必要です。リモートサーバーはローカルインストール不要で、静的APIキーの代わりにOAuthを使用し、Claude、Copilot、Gemini CLI、Codex、CursorなどのMCPクライアントで動作します。
- 早期アクセスの提供開始については、このページをご確認いただくか、Brazeアカウントチームにご連絡ください。
モデルコンテキストプロトコル（MCP）とは
モデルコンテキストプロトコル（MCP）とは、AIエージェントが別のプラットフォームのデータに接続し、そのデータと連動できるようにする規格です。主に2つの部分で構成されています。
- MCPクライアント： AIエージェントが動作するアプリケーション（CursorやClaudeなど）。
- MCPサーバー： 別のプラットフォーム（Brazeなど）が提供するサービスで、AIが使用できるツールとアクセス可能なデータを定義します。
Braze MCPサーバーについて
Braze MCPサーバーの設定後、エージェントやアシスタント、チャットボットなどのAIツールをBrazeに直接接続し、CanvasやCampaignの分析、カスタム属性、Segmentsなどの集計データを読み取れるようになります。Braze MCPサーバーは以下のようなユースケースに最適です。
- Brazeのコンテキストを必要とするAI搭載ツールの構築。
- マルチステップのエージェントワークフローを作成するCRMエンジニア。
- 自然言語クエリを試す技術系マーケター。
Braze MCPサーバーには、読み取り専用と書き込みの両方のエンドポイントが含まれています。Brazeユーザープロファイルからデータを返すことはありません。Braze APIキーに割り当てるエンドポイントを選択することで、エージェントが読み取り、作成、または更新できる範囲をコントロールできます。利用可能なエンドポイントの完全なリストと必要な権限については、利用可能なAPI機能を参照してください。
エージェントに持たせたいAPIキーの権限のみを割り当ててください。エージェントにBraze内で変更を加えさせたくない場合は、APIキーを作成する際に書き込み権限をオフのままにしてください。エージェントは、付与された書き込み権限を通じてデータの書き込みを試みる可能性があります。
使用例
ClaudeやCursorのようなツールを使って、自然言語でBrazeとやり取りできます。その他の例やベストプラクティスについては、Braze MCPサーバーの使用方法を参照してください。
プロンプトの例： What are my available Braze functions?
応答の例： list_functionsを使用し、利用可能なBraze MCP機能カテゴリを返しました。
プロンプトの例： What are my available Braze functions?
応答の例： list_functionsをクエリし、get_canvas_listなどの機能を一覧表示しました。
よくある質問（FAQ）
どのMCPクライアントがサポートされていますか？
正式にサポートされているのはClaudeとCursorのみです。Braze MCPサーバーを利用するには、これらのクライアントのいずれかのアカウントが必要です。
MCPクライアントはBrazeのどのデータにアクセスできますか？
MCPクライアントは、PIIを返さないエンドポイントにアクセスできます。エージェントが使用できるエンドポイントは、APIキーに割り当てた権限によってコントロールできます。
MCPクライアントはBrazeデータを変更できますか？
はい。サーバーは、エージェントがワークスペース内のコンテンツ（メディアライブラリのアセット、メールテンプレート、Content Blocksなど）を作成または更新できる、限定された書き込みエンドポイントのセットを公開しています。各書き込みエンドポイントには、それぞれ独自のAPIキー権限が必要です。エージェントにBraze内で特定の変更を加えさせたくない場合は、APIキーを作成する際にその権限をオフのままにしてください。書き込み機能の完全なリストと必要な権限については、利用可能なAPI機能を参照してください。
BrazeでサードパーティのMCPサーバーを使用できますか？
Brazeデータに対してサードパーティのMCPサーバーを使用することは推奨されません。PyPiでホストされている公式のBraze MCPサーバーのみを使用してください。
なぜBraze MCPサーバーはPIIアクセスを提供しないのですか？
ユーザーデータを保護しつつ価値あるユースケースをサポートするため、サーバーは通常PIIを返さないエンドポイントに限定されています。これにより、ワークスペースとそこに含まれるユーザーのリスクが軽減されます。
APIキーは再利用できますか？
いいえ。MCPクライアント用に新しいAPIキーを作成する必要があります。AIツールには許容できる範囲のアクセスのみを付与し、過剰な権限は避けてください。
Braze MCPサーバーはローカルでホストされていますか、それともリモートですか？
現在利用可能なBraze MCPサーバーはローカルでホストされています。リモートのBrazeホスト型MCPサーバーは今夏に早期アクセスとして提供開始され、ローカルホスト型のベータサーバーに代わるものとなります。
Cursorが関数のリストしか表示しないのはなぜですか？
askモードかagentモードかを確認してください。MCPサーバーを使用するには、agentモードである必要があります。
エージェントが誤った回答を返した場合はどうすればよいですか？
Cursorのようなツールを使用している場合は、使用するモデルを変更してみてください。例えば、自動設定にしている場合は、特定のモデルに変更し、ユースケースに最適なモデルを見つける実験をしてみてください。新しいチャットを開始してプロンプトを再試行することもできます。
問題が解決しない場合は、mcp-product@braze.comまでメールでお知らせください。可能であれば、動画を添付し、コール機能を展開してエージェントが試みたコールを確認できるようにしてください。
免責事項
モデルコンテキストプロトコル（MCP）は新たに導入されたオープンソースプロトコルであり、現時点ではセキュリティ上の問題や脆弱性の影響を受けやすい可能性があります。
Braze MCPサーバーの設定コードと手順は、Brazeが「現状のまま」かつ一切の保証なしに提供するものであり、顧客は自己責任で使用するものとします。Brazeは、MCPの不適切な設定、誤用、または発生する可能性のあるセキュリティ上の問題に起因するいかなる結果についても責任を負いません。Brazeは、顧客に対し、設定を慎重に確認し、提示されたガイドラインに従うことで、Braze環境の完全性とセキュリティに関連するリスクを低減することを強く推奨します。
サポートが必要な場合や不明点がある場合は、Brazeサポートまでお問い合わせください。