Passer au contenu principal

Création d'extensions de bureau avec MCPB

Mis à jour il y a plus de 2 semaines

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 :

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édez 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 publiques 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 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. Démarrage

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'installation de runtime séparée

  • Meilleure compatibilité et fiabilité avec Claude Desktop

  • Support SDK MCP étendu

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 de démarrage complet, utilisation de la CLI et spécifications

  • Exemples MCPB - Implémentations de référence fonctionnelles incluant « Hello World »

  • SDK MCP - Implémentation du protocole principal

Pour des conseils complets sur le développement, les tests et les meilleures pratiques, consultez la section « Pour les développeurs de bundles » du README MCPB.

Important : Avant de distribuer votre MCPB, consultez les conseils de test et les meilleures pratiques dans le README MCPB pour assurer la qualité.

3. Configuration

Qu'est-ce que manifest.json ?

Le fichier manifest.json est une métadonnée requise qui décrit votre MCPB - ce qu'il fait, comment l'exécuter, quels outils il fournit et quelle configuration il nécessite.

Pour les informations les plus à jour, consultez la spécification MCPB officielle.

Comment ajouter une icône ?

Les icônes sont optionnelles mais recommandées pour une apparence professionnelle.

Approche de base : Incluez le fichier icon.png dans le répertoire racine de votre bundle et référencez-le dans manifest.json.

Exigences :

  • Nom du fichier : icon.png (ou chemin personnalisé)

  • Taille : 512×512px recommandé (minimum 256×256px)

  • Format : PNG avec support de la transparence

  • Emplacement : Racine du bundle ou chemin spécifié

Options avancées : Variantes d'icônes multiples pour différentes tailles et thèmes (support du mode clair/sombre).

Détails d'implémentation : Consultez Spécification du manifeste MCPB - Icônes pour :

  • Configuration du champ icône

  • Syntaxe des variantes d'icônes multiples

  • Spécifications de taille et de thème

  • Meilleures pratiques et exigences

Comment les utilisateurs configurent-ils mon MCPB ?

Définissez la section user_config dans manifest.json. Claude Desktop crée automatiquement une interface de paramètres où les utilisateurs peuvent configurer votre extension.

Consultez Spécification du manifeste MCPB - Configuration utilisateur pour l'implémentation complète :

  • Schéma complet et exemples

  • Tous les types et propriétés de configuration

  • Contraintes de validation

  • Gestion des données sensibles

  • Modèles de sélection multiple

Comment les utilisateurs installent-ils mon MCPB ?

Il existe trois méthodes d'installation différentes :

  1. Double-clic - Téléchargez le fichier .mcpb et double-cliquez pour ouvrir

  2. Glisser-déposer - Faites glisser le fichier .mcpb dans la fenêtre Claude Desktop

  3. Menu Fichier - Développeur → Extensions → Installer l'extension → sélectionnez le fichier .mcpb

Toutes les méthodes ouvrent l'interface d'installation où les utilisateurs peuvent :

  • Examiner les détails et les autorisations de l'extension

  • Configurer les paramètres requis

  • Accorder les autorisations nécessaires

  • Terminer l'installation

Portée d'installation : Installation par utilisateur - chaque utilisateur doit installer séparément sur son propre système.

Expérience utilisateur et contrôles administrateur : Pour des informations détaillées sur l'expérience d'installation de l'utilisateur final et les contrôles administrateur en entreprise (y compris la gestion des organisations Team/Enterprise et la configuration des politiques), consultez :

4. Ressources

Documentation officielle

Framework MCPB :

Protocole MCP :

Claude Desktop :

Obtenir de l'aide

Canaux de support :

Ressources communautaires :

  • Consultez les discussions du référentiel pour les Q&R communautaires

  • Suivez les notes de version pour les dernières mises à jour

  • Examinez les exemples pour les modèles d'implémentation

Prêt pour la distribution publique ?

Si vous avez créé un MCPB fonctionnel et souhaitez le soumettre au répertoire Anthropic pour une distribution et une découverte plus larges, consultez notre guide complémentaire : Soumission au répertoire Anthropic.

Le guide du répertoire couvre les exigences supplémentaires, notamment :

  • Annotations d'outils obligatoires pour tous les outils

  • Exigences de politique de confidentialité

  • Minimum de trois exemples fonctionnels

  • Identifiants de test (le cas échéant)

  • Processus de soumission complet et calendrier d'examen

Articles connexes
Démarrage avec les serveurs MCP locaux sur Claude Desktop
Création de connecteurs personnalisés via des serveurs MCP distants
FAQ du Répertoire des Connecteurs Anthropic
Activation et utilisation de la liste d'autorisation des extensions de bureau
Guide de soumission du serveur MCP local
Avez-vous trouvé la réponse à votre question ?