Ce guide vous aidera à créer un MCP Bundle (.mcpb) pour créer une extension de bureau pour un usage interne, une distribution privée, ou comme base pour une soumission au Répertoire des connecteurs d'Anthropic.
1. Introduction
Qu'est-ce qu'un MCPB ?
Les fichiers MCPB (.mcpb) sont des archives zip contenant un serveur MCP local et un manifest.json. Ils permettent une installation en un clic dans Claude Desktop, similaire aux extensions de navigateur.
Caractéristiques clés :
S'exécute localement sur la machine de l'utilisateur
Communique via le transport stdio
Regroupe toutes les dépendances
Fonctionne hors ligne
Aucun OAuth requis
En savoir plus :
Référentiel MCPB - Spécification complète et architecture
Article de blog sur les extensions de bureau - Aperçu et cas d'usage
Quand dois-je utiliser un serveur local (MCPB) par rapport à un serveur distant ?
Choisissez un serveur local (MCPB) pour :
Systèmes internes et sécurité
Accéder aux systèmes derrière votre pare-feu (JIRA, Confluence, wikis internes, bases de données privées)
Authentification transparente - Utilise automatiquement les sessions SSO et navigateur existantes, aucune gestion de jetons
Conformité zéro confiance - Fonctionne dans les limites de votre réseau d'entreprise sans exposer les ressources internes publiquement
Ressources locales
Accès direct au système de fichiers pour l'édition de code et les opérations Git
Intégration avec les outils installés localement (Docker, IDE, bases de données)
Intégration matérielle et contrôle des applications de bureau
Opérations sensibles à la confidentialité qui ne doivent pas quitter la machine de l'utilisateur
Déploiement en entreprise
Installation en un clic avec runtime Node.js intégré (aucune dépendance à gérer)
Aucune infrastructure cloud, configuration VPN ou règles de pare-feu requises
Contrôles au niveau de l'organisation - Les administrateurs peuvent télécharger des extensions personnalisées et gérer l'accès via des listes d'autorisation
Contrôle complet sur l'authentification, l'autorisation et les journaux d'audit
Choisissez un connecteur distant pour :
Les services cloud et les API publiques nécessitant une infrastructure centralisée
La distribution sur Claude sur le web, mobile et bureau
Les services nécessitant des mises à jour centralisées pour tous les utilisateurs
Les flux OAuth nécessitant une gestion des jetons côté serveur
Les intégrations accessibles au public utilisées par plusieurs organisations
Différence clé : Les MCPB s'exécutent sur la machine de l'utilisateur via le transport stdio avec accès aux ressources locales et internes. Les connecteurs distants s'exécutent sur vos serveurs via HTTPS et sont accessibles via l'infrastructure d'Anthropic.
Utilisation réelle : Les organisations construisent des MCPB comme des proxies sécurisés vers les serveurs MCP internes, pour l'accès à la documentation interne, et pour connecter les outils de développement tout en maintenant leur architecture de sécurité.
Pour les conseils sur les connecteurs distants : Consultez la FAQ des partenaires MCP pour la documentation complète des connecteurs distants.
2. Premiers pas
Quel langage de programmation dois-je utiliser ?
Node.js est fortement recommandé car :
Livré avec Claude pour macOS et Windows (zéro friction d'installation pour les utilisateurs)
Les utilisateurs n'ont pas besoin d'installer un runtime séparé
Meilleure compatibilité et fiabilité avec Claude Desktop
Support étendu du SDK MCP
Quelles plates-formes dois-je supporter ?
Claude Desktop s'exécute sur :
macOS (darwin)
Windows (win32)
Spécifiez les plates-formes supportées dans la section compatibilité de votre manifest.json.
Bonne pratique : Testez sur les deux plates-formes même si vous développez principalement sur l'une d'elles.
Détails de compatibilité des plates-formes : Consultez Spécification du manifeste MCPB - Compatibilité pour la spécification des plates-formes et les exigences de runtime.
Comment créer mon premier MCPB ?
Suivez ce processus en cinq étapes :
1. Installez MCPB CLI : npm install -g @anthropic-ai/mcpb
2. Créez votre serveur MCP (voir SDK MCP)
3. Exécutez mcpb init pour créer manifest.json
4. Exécutez mcpb pack pour regrouper
5. Installez et testez dans Claude Desktop
Pour des conseils d'implémentation détaillés :
Référentiel MCPB - Guide