Braze MCPサーバーの設定

BrazeのMCPサーバーの設定方法を学習し、ClaudeやCursorのようなツールを使って自然言語でBrazeのデータと対話できるようにする。より一般的な情報については、Braze MCP server.

前提条件

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

Braze MCPサーバーの設定

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

まず、依存関係管理とPythonパッケージ・ハンドリングのためのAstral社のコマンドライン・ツール、uvをインストールする。

• macosとlinux
• ウィンドウズ

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

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

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

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

事前に提供された設定ファイルを使用して、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": "key-identifier",
        "BRAZE_BASE_URL": "rest-endpoint"
      }
    }
  }
}

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

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

Braze MCPサーバーの設定が完了したら、MCPクライアントにテストプロンプトを送信してみる。その他の例やベストプラクティスについては、[Braze MCPサーバーの使用]](/docs/ja/user_guide/brazeai/mcp_server/usage/).

• クロード
• カーソル

トラブルシューティング

端末エラー

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環境の完全性とセキュリティに関連するリスクを軽減するために、構成を注意深く見直し、概説されたガイドラインに従うことを強く推奨する。

サポートや説明については、[email protected] までご連絡いただきたい。