Passer au contenu principal

Commencer avec le protocole de contexte de modèle (MCP) sur Claude for Desktop

Mis à jour aujourd’hui

MCP dans Claude for Desktop est actuellement une fonctionnalité en version bêta.

Le Model Context Protocol (MCP) est un protocole ouvert qui permet une intégration transparente entre les applications LLM et les sources de données et outils externes. Avec l'introduction des extensions de bureau (DXT), 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 grâce à des packages installables en un clic. Au lieu de configurer manuellement les fichiers JSON et de gérer les dépendances, vous pouvez maintenant installer des serveurs MCP locaux sur votre ordinateur aussi facilement que des extensions de navigateur.

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

Installation des Extensions de Bureau

  1. Naviguez vers Paramètres > Extensions dans Claude Desktop

  2. Parcourez le répertoire d'extensions ou installez à partir d'un fichier .dxt

  3. Cliquez sur "Installer" sur l'extension souhaitée

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

  5. L'extension sera automatiquement disponible dans vos conversations

Dépannage de l'Installation des Extensions de Bureau

L'extension ne s'installe pas

  • Assurez-vous d'exécuter 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 avez suffisamment d'espace disque 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 requis manquants

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

Problèmes de configuration d'extension

  • Naviguez vers Paramètres > Extensions et cliquez sur l'extension pour examiner ses paramètres

  • Assurez-vous que tous les champs de configuration requis sont complétés

  • Vérifiez que les chemins de 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 a les permissions 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 politiques de votre organisation

FAQ Développeur

Comment convertir mon serveur MCP existant en extension DXT ?

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

  2. Empaquetez-le en utilisant la commande dxt pack

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

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

Les extensions DXT 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 la configuration sensible comme les clés API ?

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

Puis-je distribuer mon extension DXT de manière privée ?

Oui, vous pouvez partager des fichiers .dxt directement avec des utilisateurs ou é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 DXT ?

Activez la journalisation de débogage dans les paramètres de Claude Desktop, vérifiez les journaux d'extension dans le panneau des paramètres Extensions, et référez-vous au 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 de manière privée, les utilisateurs devront installer manuellement les fichiers .dxt mis à jour.

Contrôles de Politique d'Entreprise

Les administrateurs d'entreprise peuvent contrôler les extensions de bureau via les politiques système :

Configuration d'Entreprise macOS

Configurez les extensions de bureau via un fichier de liste de propriétés à

~/Library/Preferences/com.anthropic.Claude.plist :

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict>    <key>isDxtEnabled</key>    <true/>    <key>isDxtDirectoryEnabled</key>    <false/>    <key>isDxtSignatureRequired</key>    <true/>    <key>dxtRegistry</key>    <string>https://registry.example.com</string></dict></plist>
Avez-vous trouvé la réponse à votre question ?