Configurer le MCP DAZZM dans Copilot

Introduction

Le serveur MCP (Model Context Protocol) de DAZZM permet de connecter l’application GitHub Copilot directement à une application DAZZM. Une fois la connexion établie, Copilot 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.

N.B : Ce guide couvre l’application GitHub Copilot autonome (l’application bureau/mobile basée sur Copilot cloud agent) — et non l’assistant intégré à VS Code. Ce sont deux produits distincts, avec des écrans de configuration distincts. Pour VS Code, voir Configurer le MCP DAZZM dans VS Code.

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 ;
• L’application GitHub Copilot installée (bureau ou mobile) ;
• Un forfait Copilot payant (Pro, Pro+, Max, Business ou Enterprise). L’application GitHub Copilot repose sur Copilot cloud agent, qui n’est pas disponible avec le forfait Copilot gratuit ;
• Node.js installé localement (la connexion utilise npx — requis pour l’application de bureau ; non applicable si vous n’utilisez que l’application mobile, puisque les sessions s’y exécutent dans le cloud).

É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, « Copilot » ;
5. Copiez la valeur de la clé.

2. Ajouter le serveur dans les paramètres de l’application

1. Ouvrez l’application GitHub Copilot ;
2. Ouvrez Settings, puis allez à MCP servers ;
3. Cliquez sur Add server ;
4. Remplissez le formulaire :
   • Server name : dazzm-<nom-app> — nous recommandons de le nommer dazzm- suivi du nom de votre application, particulièrement utile si vous connectez plusieurs applications ;
   • Type : Local ;
   • Command : npx ;
   • Arguments : collez ce qui suit, en remplaçant <nom-app>, <nom-env> et <VOTRE_CLE_API> :

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

5. Laissez Environment variables et Timeout à leurs valeurs par défaut, sauf raison particulière de les modifier ;
6. Cliquez sur Add server.

Quelques précisions sur cette configuration :

• 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 ;
• Ce sont les mêmes arguments que ceux utilisés dans la configuration mcp.json de VS Code — si vous avez déjà une configuration VS Code fonctionnelle, vous pouvez copier le tableau args directement depuis celle-ci.

3. Vérifier la connexion

Une fois ajouté, le serveur apparaît sous Configured servers, dans l’onglet On this device, avec une coche verte et son interrupteur activé — cela indique que Copilot s’y est connecté avec succès.

Pour confirmer que cela fonctionne en pratique, démarrez une conversation et demandez à Copilot d’effectuer une action simple, en lecture seule, sur votre application DAZZM (par exemple, lister ses pages ou ses modèles).

Dépannage

Si le serveur n’affiche pas de coche verte, ou que Copilot ne peut pas l’utiliser :

• Confirmez que l’URL est correcte ;
• Confirmez que la clé API est valide et qu’elle a été collée sans espace supplémentaire après api-key: ;
• Confirmez que les arguments ont été collés sous forme de tableau JSON valide (le champ accepte soit des arguments séparés par des espaces, soit un tableau JSON — utilisez la forme tableau JSON pour éviter les problèmes avec l’URL et l’en-tête) ;
• Confirmez que Node.js est installé sur la machine qui exécute l’application de bureau ;
• Supprimez et rajoutez le serveur si un paramètre a été mal saisi — il n’y a actuellement pas de modification en ligne pour les arguments d’un serveur déjà enregistré.

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 : Copilot 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.