Braze MCPサーバーの設定

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

前提条件

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

Braze MCPサーバーの設定

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

まず、Astralが提供する依存関係管理とPythonパッケージ処理のためのコマンドラインツールをuvインストールする。

• 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ユーザープロファイルからデータを返さない読み取り専用エンドポイントを38個サポートしている。設定＞APIと識別子＞API キーに移動し、以下の権限の一部または全てを持つ新しいキーを作成する。

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

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

ステップ 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. システムに が含まれているuvxPATHか確認しろ。

認証エラー

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環境の完全性とセキュリティに関連するリスクを低減できる。

サポートが必要な場合や不明点がある場合は、support@ まで連絡braze.comすること。