Passer au contenu principal

Démarrage avec les serveurs MCP locaux sur Claude Desktop

Mis à jour il y a plus de 2 semaines

Le Model Context Protocol (MCP) est un protocole ouvert qui permet l'intégration transparente entre les applications LLM et les sources de données et outils externes. Avec l'introduction des extensions de bureau, l'installation et la gestion des serveurs MCP locaux sont devenues considérablement plus faciles.

Extensions de bureau

Les extensions de bureau offrent un moyen rationalisé d'installer et de gérer les serveurs MCP locaux via des packages installables en un clic. Au lieu de configurer manuellement les fichiers JSON et de gérer les dépendances, vous pouvez désormais installer les serveurs MCP locaux sur votre ordinateur aussi facilement que les extensions de navigateur.

Remarque : Nous construisons un répertoire d'extensions de bureau – si vous êtes un développeur qui souhaite ajouter une extension que vous avez créée au répertoire, remplissez notre formulaire d'intérêt pour les extensions de bureau pour partager plus d'informations avec nous.

Installation des extensions de bureau à partir du répertoire

  1. Accédez à Paramètres > Extensions sur Claude Desktop.

  2. Cliquez sur « Parcourir les extensions » pour consulter notre répertoire et cliquez sur les outils examinés par Anthropic que vous souhaitez utiliser. Cliquez sur « Installer » sur l'extension souhaitée.

  3. Configurez les paramètres requis (comme les clés API) via l'interface conviviale.

  4. L'extension sera automatiquement disponible dans vos conversations.

Installation des extensions de bureau personnalisées

  1. Accédez à Paramètres > Extensions sur Claude Desktop.

  2. Cliquez sur « Paramètres avancés » et trouvez la section Extension Developer.

  3. Cliquez sur « Installer l'extension… »

  4. Sélectionnez le fichier .mcpb et suivez les invites pour installer.

Contrôles d'administration pour les extensions de bureau

Les propriétaires et propriétaires principaux des plans Team et Enterprise peuvent gérer l'accès de l'équipe aux extensions de bureau à l'aide de deux contrôles :

  1. Activez ou désactivez les extensions de bureau publiques en fonction des normes de sécurité de votre organisation.

  2. Téléchargez les extensions de bureau personnalisées et mettez-les à disposition de votre équipe pour une installation en un clic.

Ces contrôles permettent aux organisations de personnaliser entièrement leurs registres en ajoutant uniquement les extensions auxquelles l'équipe doit accéder et en supprimant les autres.

Activation/désactivation d'extensions spécifiques sur les plans Team et Enterprise

Les propriétaires et propriétaires principaux des organisations Team et Enterprise peuvent gérer les extensions de bureau activées pour votre organisation et accessibles aux autres membres via Claude Desktop. Consultez Activation et utilisation de la liste d'autorisation des extensions de bureau

pour les instructions spécifiques.

Créer et télécharger des extensions personnalisées pour votre organisation

Les téléchargements d'extensions de bureau personnalisées permettent aux plans Team et Enterprise de tirer parti des flux de travail spécifiques à l'organisation qui ne sont pas disponibles dans le répertoire public. Après avoir créé une extension de bureau personnalisée, les propriétaires et propriétaires principaux peuvent accéder à Paramètres > Extensions dans Claude Desktop et cliquer sur « Paramètres avancés » pour accéder à la section Extension Developer :

Cliquez sur « Installer l'extension… » et sélectionnez le fichier .mcpb. Suivez les invites pour installer et configurer votre extension de bureau personnalisée. Pour des informations plus détaillées, veuillez consulter notre documentation pour les développeurs d'extensions de bureau.

Contrôles de politique d'entreprise

Remarque : Les contrôles de politique d'entreprise au niveau de la machine utilisateur remplaceront tous les contrôles intégrés à l'application (liste de blocage et liste d'autorisation). Si vous souhaitez utiliser un contrôle intégré à l'application, assurez-vous que isDesktopExtensionEnabled et isDesktopExtensionDirectoryEnabled ne sont pas définis sur « false » afin que la liste d'autorisation puisse remplir le registre disponible.

Pour contrôler les extensions de bureau via les stratégies système, veuillez consulter notre documentation de configuration d'entreprise pour le bureau.

Dépannage des problèmes d'installation d'extensions de bureau

L'extension ne s'installe pas

  • Assurez-vous que vous exécutez la dernière version de Claude Desktop.

  • Vérifiez que le fichier d'extension n'est pas corrompu en le retéléchargeant.

  • Vérifiez que vous disposez d'un espace disque suffisant pour l'installation.

L'extension semble installée mais les outils ne sont pas disponibles

  • Redémarrez Claude Desktop pour actualiser le registre des extensions.

  • Vérifiez les paramètres de configuration de l'extension pour les champs obligatoires manquants.

  • Vérifiez que les clés API ou les identifiants d'authentification sont entrés correctement.

Problèmes de configuration d'extension

  • Accédez à Paramètres > Extensions et cliquez sur l'extension pour consulter ses paramètres.

  • Assurez-vous que tous les champs de configuration requis sont remplis.

  • Vérifiez que les chemins d'accès aux fichiers (le cas échéant) pointent vers des répertoires existants auxquels vous avez accès.

Erreurs de permission ou de sécurité

  • Sur macOS, vérifiez Préférences système > Sécurité et confidentialité si vous recevez des avertissements de sécurité.

  • Sur Windows, assurez-vous que Claude Desktop dispose des autorisations nécessaires pour accéder aux répertoires requis.

  • Pour les environnements d'entreprise, vérifiez que les extensions de bureau sont activées via les stratégies de votre organisation.

FAQ pour les développeurs

Comment convertir mon serveur MCP existant en extension de bureau ?

  1. Ajoutez un fichier manifest.json à votre répertoire de serveur MCP avec les métadonnées requises.

  2. Empaquetez-le à l'aide de la commande mcpb pack.

  3. Consultez la documentation MCPB pour des instructions détaillées.

Quels langages de programmation sont pris en charge pour les extensions de bureau ?

Les extensions de bureau prennent en charge Node.js, Python et les serveurs MCP binaires. Claude Desktop inclut un environnement Node.js intégré, donc l'installation de Node.js n'est pas requise.

Comment gérer les configurations sensibles comme les clés API ?

Marquez les champs de configuration comme « sensitive »: true dans votre manifest.json. Claude Desktop chiffrera automatiquement ces valeurs à l'aide du stockage sécurisé du système d'exploitation (Keychain sur macOS, Credential Manager sur Windows).

Puis-je distribuer mon extension de bureau personnalisée en privé ?

Oui, vous pouvez partager les fichiers .mcpb directement avec des utilisateurs ou des équipes spécifiques. Pour une distribution plus large, vous pouvez soumettre des extensions au répertoire officiel.

Comment déboguer les problèmes avec mon extension de bureau ?

Activez la journalisation du débogage dans les paramètres de Claude Desktop, vérifiez les journaux d'extension dans le panneau des paramètres Extensions, et consultez le guide de débogage MCP pour le dépannage spécifique au protocole.

Que se passe-t-il quand mon extension a besoin de mises à jour ?

Les extensions du répertoire officiel se mettent à jour automatiquement par défaut. Pour les extensions distribuées en privé, les utilisateurs devront installer manuellement les fichiers .mcpb mis à jour.

Vous souhaitez en savoir plus sur MCP ?

Pour des informations plus détaillées sur la création de vos propres clients et serveurs MCP, nous vous recommandons de consulter les ressources suivantes :

Si vous avez besoin d'aide supplémentaire, consultez notre guide sur Comment obtenir de l'aide pour des options de support supplémentaires.

Avez-vous trouvé la réponse à votre question ?