Configuration du serveur MCP de Braze

Apprenez à configurer le serveur MCP de Braze, afin de pouvoir interagir avec vos données Braze en langage naturel à l’aide d’outils tels que Claude et Cursor. Pour plus d’informations générales, voir Serveur MCP de Braze.

Conditions préalables

Avant de commencer, vous avez besoin des éléments suivants :

Configuration du serveur MCP de Braze

Étape 1 : Installer uv

Tout d’abord, installez uv- un outil en ligne de commande d’Astral pour la gestion des dépendances et des paquets 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!

Étape 2 : Créer une clé API

Le serveur MCP de Braze prend en charge 38 endpoints en lecture seule qui ne renvoient pas les données des profils utilisateurs de Braze. Allez dans Paramètres > API et identifiants > Clés API et créez une nouvelle clé avec certaines ou toutes les autorisations suivantes.

Étape 3 : Obtenez votre identifiant et votre endpoint

Lorsque vous configurez votre client MCP, vous avez besoin de l’identifiant de votre clé API et de l’endpoint REST de votre espace de travail. Pour obtenir ces détails, retournez à la page Clés API dans le tableau de bord. Gardez cette page ouverte pour pouvoir y faire référence à l’étape suivante.

Étape 4 : Configurez votre client MCP

Configurez votre client MCP à l’aide du fichier de configuration fourni.

• 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

Étape 5 : Envoyer une invite de test

Après avoir configuré le serveur MCP de Braze, essayez d’envoyer une invite de test à votre client MCP. Pour d’autres exemples et bonnes pratiques, consultez Utilisation du serveur MCP de Braze.

• claude
• cursor
• gemini cli

Résolution des problèmes

Erreurs de terminal

uvx commande non trouvée

Si vous recevez un message d’erreur indiquant que la commande uvx n’a pas été trouvée, réinstallez uv et redémarrez votre terminal.

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

spawn uvx ENOENT erreur

Si vous recevez une erreur spawn uvx ENOENT, il se peut que vous deviez mettre à jour le chemin d’accès dans le fichier de configuration de votre client. Tout d’abord, ouvrez votre terminal et exécutez la commande suivante :

1
which uvx

La commande doit renvoyer un message similaire au suivant :

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

Copiez le message dans votre presse-papiers et ouvrez le fichier de configuration de votre client. Remplacez "command": "uvx" par le chemin que vous avez copié, puis redémarrez votre client. Par exemple :

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

L’installation du paquet échoue

Si l’installation de votre paquet échoue, essayez d’installer une version spécifique de Python à la place.

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

Configuration du client

Le client MCP ne trouve pas le serveur Braze

1. Vérifiez que la syntaxe de la configuration de votre client MCP est correcte.
2. Redémarrez votre client MCP après les changements de configuration.
3. Vérifiez que uvx se trouve dans votre système PATH.

Erreurs d’authentification

1. Vérifiez que votre BRAZE_API_KEY est correct et actif.
2. Veillez à ce que votre site BRAZE_BASE_URL corresponde à votre instance Braze.
3. Vérifiez que votre clé API dispose des autorisations nécessaires.

Délais de connexion ou erreurs de réseau

1. Vérifiez que votre BRAZE_BASE_URL est correct pour votre instance.
2. Vérifiez votre connexion réseau et les paramètres de votre pare-feu.
3. Assurez-vous d’utiliser HTTPS dans votre URL de base.

Clause de non-responsabilité

Le Model Context Protocol (MCP) est un protocole open-source récemment introduit qui peut être susceptible de présenter des problèmes de sécurité ou des vulnérabilités à l’heure actuelle.

Le code et les instructions de configuration du serveur MCP de Braze sont fournis par Braze “en l’état” et sans aucune garantie, et les clients les utilisent à leurs propres risques. Braze n’est pas responsable des conséquences découlant d’une mauvaise configuration, d’une mauvaise utilisation du MCP ou de tout problème de sécurité potentiel pouvant survenir. Braze encourage vivement ses clients à examiner attentivement leurs configurations et à suivre les directives énoncées afin de réduire les risques liés à l’intégrité et à la sécurité de leur environnement Braze.

Pour toute assistance ou clarification, veuillez contacter [email protected].