Connecter Claude au serveur MCP DAZZM

Introduction

Le serveur MCP (Model Context Protocol) de DAZZM permet de connecter Claude directement à une application DAZZM. Une fois la connexion établie, Claude peut agir dans deux domaines :

• Modifier l’application en manipulant ses définitions (modèles, pages, workflows, scripts, etc.) ;
• Lire et modifier les données contenues dans l’application.

Il existe deux façons de connecter Claude à une application DAZZM :

• Depuis l’interface de Claude. Vous ajoutez le serveur DAZZM comme connecteur personnalisé directement depuis les paramètres de Claude. Rien à installer, aucun fichier à éditer. Cela fonctionne de la même façon dans l’application Claude Desktop et dans le navigateur (claude.ai), et le connecteur est rattaché à votre compte Claude : il vous suit si vous changez d’ordinateur ;
• Via le fichier de configuration (claude_desktop_config.json). Une approche plus technique, utile si vous préférez gérer vos connecteurs comme du code ou si vous maintenez déjà ce fichier. Cette méthode est locale à l’installation de Claude Desktop sur une machine donnée.

Les deux méthodes sont couvertes ci-dessous, ainsi que Claude Code CLI, la version en ligne de commande. Les étapes de préparation — génération de la clé API, choix de l’environnement, conseils d’utilisation — sont identiques dans tous les cas.

N.B : Le serveur MCP a été conçu pour être branché à un environnement de développement, dans lequel la modification des définitions est permise. Voir la section Choisir le bon environnement avant de vous connecter à tout autre environnement.

Prérequis

• Un accès à l’application Account de votre organisation DAZZM ;
• Une application DAZZM avec un environnement de développement ;
• Claude (application web ou de bureau) ou Claude Code CLI ;
• Node.js installé — uniquement si vous utilisez la méthode du fichier de configuration (elle repose sur npx).

Étapes à suivre

1. Générer une clé API (Account)

1. Ouvrez l’application Account ;
2. Accédez à l’application que vous souhaitez connecter ;
3. Accédez à un environnement de développement de cette application ;
4. Créez une clé API. Vous pouvez la nommer, par exemple, « Claude » ;
5. Copiez la valeur de la clé.

2. Ajouter le connecteur depuis l’interface de Claude

Avec cette méthode, le connecteur est ajouté à votre compte Claude, il devient donc, une fois configuré, disponible partout où vous utilisez Claude — application de bureau ou navigateur, Claude Chat, Claude Cowork et Claude Code — et sur tout ordinateur où vous êtes connecté.

1. Dans Claude, ouvrez les Paramètres, puis la section Connecteurs ;

2. Cliquez sur Ajouter un connecteur personnalisé (Add custom connector) ;

3. Remplissez les deux champs :

   • Nom : le nom que le connecteur aura dans votre liste de connecteurs. Nous suggérons DAZZM suivi du nom de votre application — particulièrement utile si vous contrôlez plusieurs applications via Claude ;
   • URL : https://<nom-app>-<nom-env>.apps.dazzm.com/api/prod/mcp, où <nom-app> est le nom de votre application et <nom-env> le nom de l’environnement auquel vous vous connectez — le même segment d’URL que vous utilisez pour accéder à votre application.

   N.B : Le segment prod dans /api/prod/mcp est fixe : il désigne la version de la plateforme DAZZM, et non l’environnement de votre application. Ne le remplacez pas.

4. Cliquez sur Continuer. Claude essaie de vérifier le serveur et affiche le message « This URL can’t be checked automatically. You can still configure it manually. » C’est normal : le serveur DAZZM requiert une clé API, donc Claude ne peut pas encore l’atteindre avant qu’elle soit configurée. Cliquez sur Continue anyway ;

5. Sur l’écran suivant, dans la section Authentication, sélectionnez No sign-in ;

6. Toujours dans cette section, ajoutez un en-tête de requête (request header) :

   • Nom de l’en-tête : api-key
   • Valeur : la valeur de la clé copiée à l’étape 1.

7. Cliquez sur Connect.

Le connecteur apparaît maintenant dans votre liste de connecteurs, prêt à être utilisé. Passez à la section Vérifier la connexion.

3. Configurer Claude via le fichier de configuration (alternative)

Cette méthode est une alternative à l’étape 2 — les deux ne sont pas nécessaires. Elle s’applique à tout Claude Desktop : Claude Chat, Claude Cowork et Claude Code y auront tous accès. (Pour la version en ligne de commande de Claude Code, voir l’étape 4.)

Éditez le fichier de configuration de Claude Desktop :

Claude\claude_desktop_config.json

Repérez la section mcpServers. Elle n’existe peut-être pas par défaut ; dans ce cas, créez-la :

{
  "mcpServers": {}
}

Ajoutez ensuite une entrée pour votre application. Voici un exemple complet :

{
  "mcpServers": {
    "dazzm-<nom-app>": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<nom-app>-<nom-env>.apps.dazzm.com/api/prod/mcp",
        "--header",
        "api-key:<VOTRE_CLE_API>"
      ]
    }
  }
}

Quelques précisions sur cet exemple :

• dazzm-<nom-app> est le nom du serveur MCP tel que Claude le verra. Nous recommandons de le nommer dazzm- suivi du nom de votre application. C’est particulièrement utile si vous contrôlez plusieurs applications via Claude ;
• L’URL suit le format https://<nom-app>-<nom-env>.apps.dazzm.com/api/prod/mcp, où <nom-app> est le nom de votre application et <nom-env> le nom de l’environnement auquel vous vous connectez — le même segment d’URL que vous utilisez pour accéder à votre application ;
• Le segment prod dans /api/prod/mcp est fixe : il désigne la version de la plateforme DAZZM, et non l’environnement de votre application. Ne le remplacez pas ;
• api-key: est suivi directement de la valeur de la clé copiée à l’étape 1, sans espace.

Sauvegardez le fichier, puis quittez Claude et relancez-le.

N.B : Sur Windows, il faut quitter Claude à partir du system tray (zone de notification), et non pas simplement fermer sa fenêtre.

4. Configurer Claude Code CLI

À venir : la procédure de configuration pour Claude Code CLI. La préparation (clé API, URL) est identique à celle de Claude Desktop ; seul l’endroit où la configuration est enregistrée diffère.

5. Vérifier la connexion

Démarrez une conversation dans Claude Chat, Claude Cowork ou Claude Code et appuyez sur le bouton + : la liste des connecteurs actifs devrait inclure votre serveur DAZZM.

Si vous avez utilisé le fichier de configuration, Claude se connecte aux serveurs MCP configurés à son lancement. Si l’un d’entre eux ne fonctionne pas, une erreur s’affiche immédiatement. S’il n’y a aucune erreur, le chargement du serveur MCP s’est probablement fait avec succès.

Astuces

Si vous connectez Claude à une application toute neuve, il a peu d’exemples sur lesquels se fier pour trouver les bonnes solutions. Les deux premières astuces l’aident à en trouver :

Connecter une application de référence. Enregistrez une seconde connexion MCP, cette fois vers une de vos applications complètes et bien construites. Choisissez l’application de votre choix, créez-y aussi une clé API (étape 1), puis ajoutez-la de la même façon en nommant ce connecteur dazzm-examples. Le nom compte : c’est lui qui indique à Claude qu’il s’agit d’un registre d’exemples, et il l’utilisera intuitivement pour y puiser de bonnes pratiques DAZZM.

Pointer Claude vers la documentation. En début de conversation, vous pouvez simplement dire à Claude de visiter doc.dazzm.com pour y trouver plus d’exemples et de guides sur la plateforme.

Laisser Claude tester dans l’application. Pour vous assurer que Claude comprend et teste ce qu’il fait, il est vraiment utile de lui donner accès à l’application sur laquelle il travaille. C’est facile : ouvrez votre navigateur déjà connecté à l’application et dites à Claude d’utiliser le MCP Chrome pour effectuer des tests sur l’application qu’il modifie. Une bonne pratique est de lui demander de faire des tests end-to-end chaque fois qu’il a complété une tâche.

Choisir le bon environnement

Le serveur MCP est capable d’agir sur n’importe quel environnement, mais tous les usages ne se valent pas :

1. Cas nominal — environnement de développement. C’est l’usage pour lequel le serveur MCP a été conçu : Claude peut y manipuler les définitions et les données de test en toute liberté.
2. Cas acceptable — environnement de production, en lecture seule. Il est possible de brancher le serveur MCP à un environnement de production si l’objectif est d’employer ses capacités de lecture de données pour faire de l’analyse.
3. Cas fortement déconseillé — écrire des données hors d’un environnement de test.

Modification de données via le serveur MCP

Le serveur MCP est capable de modifier les données dans un environnement autre que de test, mais c’est fortement déconseillé. L’écriture via le serveur MCP contourne toutes les contraintes et toutes les règles d’affaires de l’application : les données sont écrites directement dans la base de données, ce qui peut mener à des erreurs d’intégrité faisant planter l’application.