Braze MCPサーバーの設定

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

重要

Braze MCPサーバーはベータ版です。使用するためにアクセスをリクエストする必要はありません。セットアップ手順に従って開始してください。Braze MCPサーバーを使用することにより、Brazeベータ利用規約に同意したものとみなされます。改善にご協力いただける場合は、[email protected]までフィードバックをお送りください。

前提条件

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

Braze MCPサーバーの設定

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

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

• macos and linux
• windows

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!

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ユーザープロファイルからデータを返しません。書き込みエンドポイントを使用すると、エージェントがワークスペース内のコンテンツを作成または更新できます。

APIキーを作成するには：

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

重要

エージェントに使用させたい権限のみを割り当ててください。エージェントがBraze内で変更を行うことを防ぐには、APIキーを作成する際に書き込み権限を外しておいてください。

警告

既存のAPIキーを再利用しないでください。MCPクライアント専用に新しいキーを作成してください。エージェントに必要な権限のみを割り当ててください。エージェントは付与された権限を使用しようとする可能性があるため、Braze内で変更を行わせたくない場合は、書き込み権限を外しておいてください。

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

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

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

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

• claude
• cursor
• gemini cli

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"
      }
    }
  }
}

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"
      }
    }
  }
}

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

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"
      }
    }
  }
}

1
2
3
4
gemini
/mcp
/mcp desc
/mcp schema

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

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

• claude
• cursor
• gemini cli

トラブルシューティング

ターミナルエラー

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サポートまでお問い合わせください。