Skip to content

Braze MCPサーバーの設定

Braze MCPサーバーの設定方法を学習すれば、ClaudeやCursorのような自然言語ツールを使ってBrazeデータとやり取りできるようになります。より一般的な情報については、Braze MCPサーバーを参照してください。

前提条件

開始する前に、以下のものが必要です。

Braze MCPサーバーの設定

ステップ 1: uvをインストールする

まず、uvをインストールします。これはAstralが提供するコマンドラインツールで、依存関係管理とPythonパッケージ処理に使用します。

ターミナルアプリケーションを開き、以下のコマンドを貼り付けて、Enterを押します。

1

curl -LsSf https://astral.sh/uv/install.sh | sh

出力は以下のようになります。

1
2
3
4
5
6
7
8

$ curl -LsSf https://astral.sh/uv/install.sh | sh

downloading uv 0.8.9 aarch64-apple-darwin
no checksums to verify
installing to /Users/Isaiah.Robinson/.local/bin
  uv
  uvx
everything's installed!

Windows PowerShellを開き、以下のコマンドを貼り付けてEnterを押します。

1

irm https://astral.sh/uv/install.ps1 | iex

出力は以下のようになります。

1
2
3
4
5
6
7
8

PS C:\Users\YourUser> irm https://astral.sh/uv/install.ps1 | iex

Downloading uv 0.8.9 (x86_64-pc-windows-msvc)
no checksums to verify
installing to C:\Users\YourUser\.local\bin
  uv.exe
  uvx.exe
everything's installed!

ステップ 2: APIキーを作成する

Braze MCPサーバーは、Brazeユーザープロファイルからデータを返さない39個のエンドポイントをサポートしています。

APIキーを作成するには：

  1. Settings > APIs and Identifiers > API Keysに移動します。
  2. 新しいキーを作成します。
  3. 以下の権限の一部または全部をキーに割り当てます。
サポートされている権限の一覧

Campaigns

Canvas

Catalogs

Cloud Data Ingestion

Content Blocks

Custom Attributes

Events

KPIs

Media Library

このエンドポイントは、Braze MCPサーバーがサポートする書き込みエンドポイントです。エージェントにメディアライブラリへのアセットアップロードを許可する場合のみ、この権限を追加してください。

Messages

Preference Center

Purchases

Segments

Sends

Sessions

SDK Authentication Keys

Subscription

Templates

ステップ 3: 識別子とエンドポイントを取得する

MCPクライアントを設定する際には、APIキーの識別子とワークスペースのRESTエンドポイントが必要です。これらの詳細を取得するには、ダッシュボードのAPI Keysページに戻ります。次のステップで参照できるよう、このページを開いたままにしておいてください。

Brazeの「API Keys」ページに、新しく作成されたAPIキーとユーザーのRESTエンドポイントが表示されている。

ステップ 4: MCPクライアントを設定する

あらかじめ用意された設定ファイルを使って、MCPクライアントを設定します。

Claude Desktopのコネクタディレクトリを使ってMCPサーバーを設定します。

  1. Claude Desktopで、Settings > Connectors > Browse Connectors > Desktop Extensions > Braze MCP Server > Installに移動します。
  2. APIキーとベースURLを入力します。
  3. 設定を保存し、Claude Desktopを再起動します。

Cursorで、Settings > Tools and Integrations > MCP Tools > Add Custom MCPに移動し、以下のスニペットを追加します。

1
2
3
4
5
6
7
8
9
10
11
12

{
  "mcpServers": {
    "braze": {
      "command": "uvx",
      "args": ["--native-tls", "braze-mcp-server@latest"],
      "env": {
        "BRAZE_API_KEY": "your-braze-api-key",
        "BRAZE_BASE_URL": "your-braze-endpoint-url"
      }
    }
  }
}

key-identifierとrest-endpointを、BrazeのAPI Keysページにある対応する値で置き換えます。設定は以下のようになります。

1
2
3
4
5
6
7
8
9
10
11
12

{
  "mcpServers": {
    "braze": {
      "command": "uvx",
      "args": ["--native-tls", "braze-mcp-server@latest"],
      "env": {
        "BRAZE_API_KEY": "2e8b-3c6c-d12e-bd75-4f0e2a8e5c71",
        "BRAZE_BASE_URL": "https://torchie.braze.com"
      }
    }
  }
}

完了したら、設定を保存してCursorを再起動します。

Gemini CLIはユーザー設定を~/.gemini/settings.jsonから読み込みます。このファイルが存在しない場合は、ターミナルで以下のコマンドを実行して作成できます。

1
2

mkdir -p ~/.gemini
nano ~/.gemini/settings.json

次に、yournameをターミナルプロンプトの@BZXXXXXXXXの前にある文字列に正確に置き換えます。続いて、key-identifierとrest-endpointを、BrazeのAPI Keysページにある対応する値で置き換えます。

設定は以下のようになります。

1
2
3
4
5
6
7
8
9
10
11
12

{
  "mcpServers": {
    "braze": {
      "command": "/Users/yourname/.local/bin/uvx",
      "args": ["--native-tls", "braze-mcp-server@latest"],
      "env": {
        "BRAZE_API_KEY": "2e8b-3c6c-d12e-bd75-4f0e2a8e5c71",
        "BRAZE_BASE_URL": "https://torchie.braze.com"
      }
    }
  }
}

完了したら、設定を保存してGemini CLIを再起動します。次に、Geminiで以下のコマンドを実行して、Braze MCPサーバーがリストに表示されていること、およびツールとスキーマが使用可能であることを確認します。

1
2
3
4

gemini
/mcp
/mcp desc
/mcp schema

利用可能なツールとスキーマとともにbrazeサーバーが一覧表示されるはずです。

ステップ 5: テストプロンプトを送信する

Braze MCPサーバーを設定したら、MCPクライアントにテストプロンプトを送信してみましょう。その他の例やベストプラクティスについては、Braze MCPサーバーの使い方を参照してください。

Claudeで「利用可能なBraze機能は何ですか？」と質問し、回答が表示されている様子。

Cursorで「利用可能なBraze機能は何ですか」と質問し、回答が表示されている様子。

Gemini CLIで「利用可能なBraze機能は何ですか？」と質問し、回答が表示されている様子。

トラブルシューティング

ターミナルエラー

uvxコマンドが見つからない

uvxコマンドが見つからないというエラーが表示された場合は、uvを再インストールしてターミナルを再起動してください。

1

curl -LsSf https://astral.sh/uv/install.sh | sh

spawn uvx ENOENTエラー

spawn uvx ENOENTエラーが発生した場合は、クライアントの設定ファイル内のファイルパスを更新する必要があるかもしれません。まず、ターミナルを開いて以下のコマンドを実行します。

1

which uvx

コマンドは以下のようなメッセージを返すはずです。

1

/Users/alex-lee/.local/bin/uvx

メッセージをクリップボードにコピーし、クライアントの設定ファイルを開きます。"command": "uvx"をコピーしたパスで置き換え、クライアントを再起動します。例：

1

"command": "/Users/alex-lee/.local/bin/uvx"

パッケージのインストールに失敗する

パッケージのインストールに失敗した場合は、特定のPythonバージョンを指定してインストールしてみてください。

1

uvx --python 3.12 braze-mcp-server@latest

クライアント設定

MCPクライアントがBrazeサーバーを見つけられない

  1. MCPクライアントの設定構文が正しいことを確認してください。
  2. 設定変更後にMCPクライアントを再起動してください。
  3. uvxがシステムのPATHに含まれていることを確認してください。

認証エラー

  1. BRAZE_API_KEYが正しく、アクティブであることを確認してください。
  2. BRAZE_BASE_URLがBrazeインスタンスと一致していることを確認してください。
  3. APIキーに正しい権限が設定されていることを確認してください。

接続タイムアウトまたはネットワークエラー

  1. BRAZE_BASE_URLがインスタンスに対して正しいことを確認してください。
  2. ネットワーク接続とファイアウォールの設定を確認してください。
  3. ベースURLでHTTPSを使用していることを確認してください。

免責事項

モデルコンテキストプロトコル（MCP）は新たに導入されたオープンソースプロトコルであり、現時点ではセキュリティ上の問題や脆弱性の影響を受けやすい可能性があります。

Braze MCPサーバーの設定コードと手順は、Brazeが「現状のまま」かつ一切の保証なしに提供するものであり、顧客は自己責任で使用するものとします。Brazeは、MCPの不適切な設定、誤用、または発生する可能性のあるセキュリティ上の問題に起因するいかなる結果についても責任を負いません。Brazeは、顧客に対し、設定を慎重に確認し、提示されたガイドラインに従うことで、Braze環境の完全性とセキュリティに関連するリスクを低減することを強く推奨します。

サポートが必要な場合や不明点がある場合は、Brazeサポートまでお問い合わせください。
New Stuff!