Configurer le serveur Braze MCP

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

Important

Le serveur Braze MCP est en version bêta. Vous n’avez pas besoin de demander un accès pour l’utiliser. Suivez les instructions de configuration pour commencer. En utilisant le serveur Braze MCP, vous acceptez les conditions bêta de Braze. Pour nous aider à l’améliorer, envoyez vos commentaires à [email protected].

Conditions préalables

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

Configuration du serveur Braze MCP

Étape 1 : Installer uv

Commencez par installer uv—un outil en ligne de commande développé par 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 Braze MCP comprend des endpoints en lecture seule et des endpoints en écriture. Ils ne renvoient pas de données issues des profils utilisateurs Braze. Les endpoints en écriture permettent aux agents de créer ou de mettre à jour du contenu dans votre espace de travail.

Pour créer votre clé API :

1. Rendez-vous dans Settings > APIs and Identifiers > API Keys.
2. Créez une nouvelle clé.
3. Attribuez certaines ou toutes les autorisations suivantes à votre clé.

Important

N’attribuez que les autorisations que vous souhaitez que votre agent utilise. Pour empêcher votre agent d’effectuer des modifications dans Braze, ne cochez aucune autorisation d’écriture lors de la création de votre clé API.

Avertissement

Ne réutilisez pas une clé API existante. Créez-en une spécifiquement pour votre client MCP. N’attribuez que les autorisations dont votre agent a besoin. Les agents peuvent tenter d’utiliser toute autorisation que vous leur accordez : ne cochez donc pas les autorisations d’écriture si vous ne souhaitez pas que votre agent effectue des modifications dans Braze.

Étape 3 : Obtenir votre identifiant et votre endpoint

Lorsque vous configurez votre client MCP, vous aurez besoin de l’identifiant de votre clé API et de l’endpoint REST de votre espace de travail. Pour obtenir ces informations, retournez à la page API Keys dans le tableau de bord—gardez cette page ouverte afin de pouvoir vous y référer lors de l’étape suivante.

Étape 4 : Configurer 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 un prompt de test

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

• claude
• cursor
• gemini cli

Résolution des problèmes

Erreurs de terminal

Commande uvx introuvable

Si vous recevez une erreur indiquant que la commande uvx est introuvable, réinstallez uv et redémarrez votre terminal.

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

Erreur spawn uvx ENOENT

Si vous rencontrez des erreurs spawn uvx ENOENT, il peut être nécessaire de mettre à jour le chemin d’accès dans le fichier de configuration de votre client. Commencez par ouvrir votre terminal et exécutez la commande suivante :

1
which uvx

La commande devrait renvoyer un message similaire à ce qui suit :

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 parvient pas à trouver le serveur Braze

1. Vérifiez que la syntaxe de configuration de votre client MCP est correcte.
2. Redémarrez votre client MCP après avoir modifié la configuration.
3. Vérifiez que uvx est présent dans le PATH de votre système.

Erreurs d’authentification

1. Vérifiez que votre BRAZE_API_KEY est correcte et active.
2. Assurez-vous que votre BRAZE_BASE_URL correspond à votre instance Braze.
3. Vérifiez que votre clé API dispose des autorisations appropriées.

Délais d’attente de connexion ou erreurs réseau

1. Vérifiez que votre BRAZE_BASE_URL est correcte pour votre instance.
2. Vérifiez votre connexion réseau et les paramètres de votre pare-feu.
3. Assurez-vous que vous utilisez le protocole HTTPS dans votre URL de base.

Clause de non-responsabilité

Le protocole MCP (Model Context Protocol) est un protocole open source récemment introduit qui pourrait 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 « tels quels » et sans aucune garantie. Les clients les utilisent à leurs propres risques. Braze ne saurait être tenu responsable des conséquences résultant d’une configuration incorrecte, d’une mauvaise utilisation du MCP ou de tout problème de sécurité potentiel pouvant survenir. Braze recommande vivement à ses clients de vérifier attentivement leurs configurations et de suivre les directives fournies 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 l’Assistance Braze.