Se connecter au MCP Sinch Engage (AU) – Sinch Engage

Ce guide explique comment vous connecter au serveur MCP Sinch Engage pour la région AU : générer les identifiants API et ajouter le serveur dans Claude Code via le terminal.

Point de terminaison

Ce guide utilise le point de terminaison de la région AU :

https://au.app.api.sinch.com/mcp

Utilisez le point de terminaison qui correspond à la région dans laquelle votre compte Engage est provisionné. Si votre compte se trouve dans la région de l'UE, suivez plutôt le guide de l'UE. Si vous n'êtes pas sûr de votre région, confirmez-la auprès de l'administrateur de votre compte. Les identifiants et les points de terminaison sont spécifiques à la région.

Étape 1 : Générer des identifiants API (authentification de base)

Prérequis

Vous devez être un Administrateur du compte. Les utilisateurs disposant d'autorisations de base ou avancées ne peuvent pas créer ni gérer de clés API.
Les identifiants ne peuvent être créés que sur un compte vérifié. Si votre compte n'est pas vérifié, demandez d'abord sa vérification.

Étapes

Connectez-vous à votre compte Sinch Engage
Accédez à Paramètres > Paramètres de l'API, faites défiler jusqu'à Authentification de base et cliquez sur Créer une nouvelle clé.
Saisissez un nom descriptif et cliquez sur Créer la clé.
Dans la fenêtre de confirmation, copiez l'identifiant encodé en Base64, puis cliquez sur OK. C'est la valeur que vous collez directement après Basic dans l'en-tête Authorization.

L'identifiant s'affiche une seule fois. Enregistrez-le immédiatement dans un endroit sûr. Si vous le perdez, vous devez créer une nouvelle clé.

Consultez le guide complet sur la Création de nouveaux identifiants API pour plus d'informations.

Étape 2 : Installer et démarrer Claude Code

Claude Code est l'assistant d'Anthropic qui s'exécute dans le terminal de votre ordinateur. Le terminal est une application intégrée qui vous permet de saisir des instructions pour votre ordinateur. Vous n'avez besoin d'effectuer cette configuration qu'une seule fois.

Prérequis

Vous avez besoin d'un abonnement Claude payant (Pro, Max, Team ou Enterprise). L'abonnement gratuit n'inclut pas Claude Code.
Vous avez besoin d'une connexion Internet.

Étapes

Ouvrez le terminal.
- Mac : Appuyez sur Cmd + Espace, tapez Terminal, et appuyez sur Entrée.
- Windows : Cliquez sur le menu Démarrer, tapez PowerShell, et ouvrez-le.
Installez Claude Code. Copiez la ligne qui correspond à votre ordinateur, collez-la dans le terminal, et appuyez sur Entrée. L'installation prend quelques minutes et ne nécessite l'installation d'aucun autre élément au préalable.
- Mac :
  
  bash
- ```
curl -fsSL https://claude.ai/install.sh | bash
```
- Windows (PowerShell) :
  
  powershell
- ```
irm https://claude.ai/install.ps1 | iex
```
- Si une commande ne fonctionne pas, obtenez la commande d'installation actuelle depuis la page de configuration officielle (lien ci-dessus), car celles-ci peuvent changer.
Se connecter. Tapez le mot ci-dessous et appuyez sur Entrée :
- bash
```
claude
```
- La première fois, une fenêtre de navigateur s'ouvre pour vous demander de vous connecter à votre compte Claude. Connectez-vous, puis retournez au terminal.
Retournez au terminal normal.
- Une fois connecté, tapez /exit et appuyez sur Entrée pour quitter Claude Code et retourner à l'invite de commande normale du terminal. Vous êtes maintenant prêt à connecter le serveur Engage à l'Étape 3.
  - Astuce : si vous voyez un jour claude: command not found, fermez la fenêtre du terminal, ouvrez-en une nouvelle, et réessayez.
- Vous pouvez consulter des instructions détaillées sur Claude Code dans le terminal ici : https://docs.claude.com/en/docs/claude-code/setup

Étape 3 : Se connecter à l'aide de Claude Code dans le terminal

Utilisez la commande claude mcp add dans votre interface de ligne de commande.

Remplacez <your-credential> par les identifiants en Base64 de l'Étape 1. Tous les indicateurs doivent venir avant le nom du serveur.

claude mcp add --transport http sinch-engage-au https://au.app.api.sinch.com/mcp \
  --header "Authorization: Basic <votre-identifiant>"

Ajoutez --scope user pour rendre le serveur disponible pour tous les projets, ou --scope project pour le partager avec une équipe via un .mcp.json validé. La portée par défaut (local) vous est réservée dans le projet en cours.

L'interface en ligne de commande (CLI) masque l'en-tête dans sa sortie de confirmation, de sorte que les identifiants ne se retrouvent pas dans l'historique de votre shell.

Alternative : add-json

claude mcp add-json sinch-engage-au '{"type":"http","url":"https://au.app.api.sinch.com/mcp","headers":{"Authorization":"Basic <votre-identifiant>"}}'

Pour ne pas inclure les identifiants dans un fichier validé, faites référence à une variable d'environnement au lieu de les coder en dur :

"headers": {
  "Authorization": "Basic ${SINCH_ENGAGE_CREDENTIAL}"
}

Vérifiez avec claude mcp list dans le terminal, ou /mcp à l'intérieur d'une session Claude Code.

Pour plus d'informations sur la connexion de MCP à Claude Code, vous pouvez consulter l'article ici : https://code.claude.com/docs/en/mcp

Dépannage

La connexion échoue immédiatement dans Claude Code : si vous avez configuré un en-tête Authorization statique et que le serveur le rejette, Claude Code signale la connexion comme échouée au lieu de basculer sur OAuth. Vérifiez à nouveau que l'identifiant a été collé dans son intégralité (sans espace au début ou à la fin) et qu'il s'agit d'un identifiant de la région AU.
error: missing required argument 'name' : un indicateur (par ex. --header) a été placé après le nom du serveur. Toutes les options doivent venir avant le nom.
Mauvaise région : ce guide utilise le point de terminaison de la région AU. Les identifiants de l'UE ne permettront pas de s'y authentifier. Les clients de l'UE doivent utiliser le guide de l'UE.
Identifiants perdus : les identifiants ne sont affichés qu'une seule fois. Créez une nouvelle clé si elle n'a pas été enregistrée.

Notes de sécurité

Traitez les identifiants comme un mot de passe. Ne les validez pas dans le contrôle de code source. Utilisez l'expansion de variables d'environnement dans les fichiers de configuration partagés.
Renouvelez les identifiants s'ils ont pu être exposés (par exemple, collés dans un dépôt partagé ou un journal).