Configuration du serveur MCP LaunchDarkly (onboarding)

Configure le serveur MCP hébergé par LaunchDarkly afin que les skills de gestion des flags et l'onboarding puissent utiliser les outils MCP. Utilise OAuth pour l'authentification — aucune clé API requise pour le serveur hébergé.

Ce skill est imbriqué dans l'onboarding LaunchDarkly ; l'Étape 4 du skill parent renvoie vers ici. MCP hébergé est la configuration par défaut. Pour les instances fédérales/EU ou d'autres cas où l'hébergement n'est pas disponible, utilisez la section Serveur local via npx dans MCP Config Templates et la documentation du serveur MCP local.

Prérequis

• Un compte LaunchDarkly (inscrivez-vous sur https://app.launchdarkly.com/signup?source=agent)
• Un agent de codage compatible MCP

Serveurs MCP hébergés

LaunchDarkly fournit deux serveurs MCP hébergés. Pour l'onboarding, seul le serveur de gestion des features est requis.

Workflow

Étape 1 : Identifier l'agent

Si le skill d'onboarding parent a déjà identifié l'agent, utilisez ce contexte. Sinon, déduisez-le à partir des répertoires spécifiques à l'agent, des fichiers de configuration et des outils disponibles au runtime. Ne demandez pas à l'utilisateur — choisissez la correspondance la plus pertinente.

Étape 2 : Essayer l'installation rapide

Le chemin le plus rapide est le lien d'installation rapide. Présentez-le à l'utilisateur :

Gestion des features : https://mcp.launchdarkly.com/mcp/fm/install

AI Configs (optionnel) : https://mcp.launchdarkly.com/mcp/aiconfigs/install

Important : dites à l'utilisateur à quoi s'attendre après avoir cliqué sur le lien. Le lien d'installation peut s'ouvrir dans le navigateur, mais l'autorisation ou le message « ajouter un serveur » apparaît généralement dans l'environnement de codage (l'éditeur ou l'application hôte où l'agent s'exécute), pas dans le navigateur. Immédiatement après avoir présenté le lien, incluez des instructions comme :

• Après avoir cliqué sur le lien, surveillez votre environnement de codage (l'éditeur où cette conversation s'exécute) pour un dialogue d'approbation, un message « ajouter un serveur MCP » ou une notification du panneau outils/intégrations.
• Le navigateur peut démarrer le flux OAuth, mais vous devrez probablement confirmer ou approuver le serveur dans l'éditeur lui-même.
• Si aucun message n'apparaît : vérifiez la zone des paramètres MCP, intégrations ou outils de l'éditeur pour voir si le serveur a été ajouté mais doit être activé. S'il ne s'y trouve pas du tout, passez à la configuration manuelle (Étape 3 ci-dessous).

Si le lien d'installation rapide ne fonctionne pas (l'agent ne le supporte pas, ou l'utilisateur préfère la configuration manuelle), procédez à l'Étape 3.

Étape 3 : Configuration manuelle

Localisez le fichier de configuration MCP pour l'agent détecté et ajoutez l'entrée du serveur hébergé. Consultez MCP Config Templates pour le JSON exact par agent.

Ajoutez uniquement le serveur de gestion des features pour l'onboarding. Ajoutez le serveur AI Configs uniquement si l'utilisateur en a explicitement besoin.

Étape 4 : Autorisation spécifique à l'agent

Après avoir écrit la configuration, certains agents nécessitent des étapes supplémentaires. N'envoyez pas les utilisateurs à travers de longs chemins de menu manuels — utilisez MCP UI links (docs HTTPS + raccourcis command: pour VS Code / Cursor).

Cursor :

1. Ouvrez MCP dans Cursor en utilisant le lien de documentation Cursor MCP et les raccourcis intégrés (ex. recherche Paramètres via lien command: si cliquable).
2. Activez LaunchDarkly feature management (ou le nom de votre configuration).
3. Cliquez sur Connect pour vous autoriser avec le compte LaunchDarkly.

VS Code (le cas échéant) :

• Utilisez la doc VS Code MCP + liens mcp.json / Paramètres ; faites confiance au serveur ou démarrez-le si demandé.

Claude Code :

• L'autorisation se fait automatiquement au premier appel d'outil MCP via un message OAuth. Configuration basée sur les fichiers : documentation Claude Code MCP.

GitHub Copilot :

• Cliquez sur Save après avoir ajouté la configuration MCP dans les paramètres du référentiel. Utilisez la documentation GitHub Copilot MCP pour le chemin Paramètres exact sur github.com.

Étape 5 : Redémarrer et vérifier automatiquement

Les outils MCP ne sont disponibles pour l'agent qu'après un redémarrage ou une actualisation — les serveurs MCP nouvellement ajoutés n'apparaissent pas en cours de session.

1. Dites à l'utilisateur d'activer le serveur et de redémarrer. Avant de redémarrer, il doit s'assurer que le serveur MCP est activé et autorisé dans les paramètres MCP de son éditeur (par ex. dans Cursor : activez le serveur LaunchDarkly et cliquez sur Connect). Ensuite, redémarrez ou actualisez l'agent — soyez précis sur la façon de le faire : « Redémarrer Cursor » / « recharger Claude Code » / « actualiser l'agent Copilot » selon ce que vous avez détecté à l'Étape 1. Après le redémarrage de l'utilisateur, la conversation reprendra dans un nouveau tour.
2. Au tour suivant, sondez discrètement. Appelez un outil MCP léger (par ex. list-feature-flags avec la clé de projet de l'utilisateur). Ne demandez pas à l'utilisateur si MCP fonctionne — essayez simplement.
   • Succès (réponse normale, même une liste de flags vide) : MCP est en ligne. Notez-le dans le journal d'onboarding et continuez.
   • Échec (outil non trouvé, erreur d'authentification, timeout) : revenez à ldcli/API. Notez le retour dans le journal d'onboarding. Ne bloquez pas le reste de l'onboarding — les Étapes 5-6 doivent toujours être complétables sans MCP.
3. Si le sondage échoue, dites brièvement à l'utilisateur que MCP n'est pas encore disponible et que vous utiliserez ldcli/API à la place. Proposez une ligne qu'il peut essayer plus tard pour réactiver MCP (par ex. « Vous pouvez configurer MCP à tout moment en cliquant sur [lien d'installation rapide] et en redémarrant »).
4. Si l'échec semble être un problème de configuration (mauvais chemin de fichier, OAuth manquant, serveur non activé), mentionnez la cause probable pour que l'utilisateur puisse le corriger à son aise — mais ne bloquez pas la progression.

Pour la vérification du serveur npx local, voir MCP Config Templates — Verify (local server).

MCP local : configuration du token d'accès

Quand l'utilisateur a besoin du serveur npx local (instance fédérale/EU ou d'autres cas où MCP hébergé n'est pas disponible), le serveur requiert un LAUNCHDARKLY_ACCESS_TOKEN. C'est une donnée d'identification sensible.

Commencez par dire à l'utilisateur comment créer un token s'il n'en a pas déjà un :

Créez un token d'accès API sur app.launchdarkly.com/settings/authorization/tokens/new. Donnez-lui un nom descriptif (par ex. « serveur MCP ») et au minimum le rôle Reader. Copiez le token — vous ne pourrez plus le voir après avoir quitté la page.

Ensuite, demandez-leur comment ils souhaitent ajouter le token à la configuration MCP :

D4-LOCAL -- BLOCKING : Appelez votre outil de question structurée maintenant.

• question: « Le serveur MCP local a besoin d'un token d'accès API pour s'authentifier auprès de LaunchDarkly. Vous pouvez en créer un sur app.launchdarkly.com/settings/authorization/tokens/new. Une fois que vous avez le token, comment souhaiteriez-vous l'ajouter à votre configuration MCP ? Nous recommandons de l'ajouter vous-même — il existe un risque non nul lorsqu'un agent IA gère des secrets, car les tokens peuvent persister dans l'historique des conversations, les journaux ou le contexte du modèle. »
• options:
  • « J'ajouterai le token à la configuration moi-même — dites-moi juste quel fichier et quelle variable »
  • « J'ai le token prêt — aidez-moi à configurer »
• STOP. N'écrivez pas la question en texte. N'écrivez aucune valeur de token dans un fichier de configuration avant que l'utilisateur sélectionne une option.

Si l'utilisateur ajoute le token lui-même :

1. Dites-lui le chemin du fichier de configuration pour son agent (voir MCP Config Templates)
2. Dites-lui de définir LAUNCHDARKLY_ACCESS_TOKEN comme valeur — soit comme variable d'environnement, soit directement dans le fichier de configuration
3. Rappelez-lui d'ajouter le fichier de configuration à .gitignore si le token est intégré
4. Attendez sa confirmation, puis procédez à l'Étape 5 (Redémarrer et vérifier automatiquement)

Si l'utilisateur veut une configuration assistée par l'agent :

1. Assurez-vous que le fichier de configuration est dans .gitignore avant d'écrire
2. Écrivez la configuration par MCP Config Templates
3. Rappelez à l'utilisateur que le token sera visible dans le fichier de configuration et l'historique des conversations
4. Procédez à l'Étape 5 (Redémarrer et vérifier automatiquement)

Cas limites

• L'utilisateur a déjà MCP configuré : Vérifiez en cherchant les entrées MCP LD existantes dans la configuration. Si elles existent et fonctionnent, ignorez la configuration.
• L'utilisateur a l'ancien serveur local basé sur npx : Migrez-le. Supprimez l'ancienne entrée npx @launchdarkly/mcp-server et les variables d'environnement LD_ACCESS_TOKEN. Remplacez par la configuration du serveur hébergé.
• Instances fédérales ou EU : Le serveur MCP hébergé n'est pas disponible pour les environnements fédéraux ou EU. Utilisez la documentation du serveur MCP local et la section Serveur local via npx dans MCP Config Templates. Suivez le flux Local MCP: Access Token Setup pour la gestion des tokens.
• Agent non dans la liste connue : Fournissez le modèle générique : l'utilisateur doit ajouter une entrée de serveur MCP pointant vers https://mcp.launchdarkly.com/mcp/fm en utilisant le format que son agent attend.
• L'utilisateur refuse MCP lors de l'onboarding : Documentez ce choix et continuez avec les retours ldcli/API du skill parent pour les environnements et les flags ; ne bloquez pas le travail SDK.

Ce qu'il NE FAUT PAS faire

• Ne configurez pas l'ancien serveur local basé sur npx par défaut. Préférez le serveur hébergé pour les régions standard.
• Ne demandez pas ou ne stockez pas les clés API pour le serveur hébergé. Le serveur hébergé utilise OAuth.
• N'ajoutez pas les deux serveurs par défaut. Ajoutez uniquement AI Configs si l'utilisateur le demande.
• Ne gérez pas le token d'accès pour MCP local sans demander à l'utilisateur d'abord via le point de décision D4-LOCAL.

Références

• MCP UI links — liens HTTPS + command: pour ouvrir les paramètres MCP (Cursor, VS Code, Claude Code, Windsurf, GitHub)
• MCP Config Templates — JSON OAuth hébergé par agent ; retour Serveur local via npx ; migration depuis l'ancien serveur local
• Documentation MCP officielle — guide complet de configuration hébergée