Braze MCP サーバーのセットアップ

Braze MCP サーバーを設定する方法について説明します。この方法では、クロードやカーソルなどのツールを使用して、自然言語でBrazeデータを操作できます。詳しくは、Braze MCP サーバを参照してください。

前提条件

開始する前に、次のものが必要になります。

Braze MCP サーバーのセットアップ

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

まず、uv-a コマンドラインツールを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 ユーザープロファイルs からデータを返さない38 個の読み取り専用エンドポイントs をサポートします。Settings > APIs and Identifiers > API Keysに移動し、以下の一部またはすべての権限を持つ新しいキーを作成します。

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

MCP クライアントを設定するには、API キーの識別子とワークスペースのREST エンドポイントが必要です。これらの詳細を取得するには、ダッシュボード-keep this page 開封の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

トラブルシューティング

端子エラーs

uvx コマンドが見つかりません

uvx コマンドが見つからないというエラーが表示された場合は、uv を再インストールし、端末を再起動します。

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

spawn uvx ENOENT エラー

spawn uvx ENOENT エラーs を受け取った場合は、クライアントの設定ファイルのファイルパスを更新する必要があります。まず、端末を開封し、次のコマンドを実行します。

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 を使用していることを確認します。

免責事項

Model Context Protocol (MCP)は、新たに導入された開封ソースプロトコルであり、セキュリティーの問題や脆弱性の影響を受ける可能性があります。

Braze MCP サーバーの設定コードおよび手順は、「現状のまま」で提供され、保証は一切ありません。顧客は自らの責任でこれを使用します。Braze は、不適切な設定、MCP の誤使用、または発生する可能性のある潜在的なセキュリティ問題から生じる結果については責任を負いません。Brazeは、Braze環境の完全性とセキュリティーに関連するリスクを低減するために、顧客がその構成を慎重に見直し、概略の指針に従うことを強く奨励する。

サポートまたは説明については、support@braze.comまでお問い合わせください。