Questa guida ti aiuterà a creare un MCP Bundle (.mcpb) per creare un'estensione desktop per uso interno, distribuzione privata, o come base per la presentazione alla Directory dei Connettori di Anthropic.
1. Introduzione
Cos'è un MCPB?
I file MCPB (.mcpb) sono archivi zip contenenti un server MCP locale e manifest.json. Consentono l'installazione con un solo clic in Claude Desktop, simile alle estensioni del browser.
Caratteristiche principali:
Viene eseguito localmente sulla macchina dell'utente
Comunica tramite trasporto stdio
Raggruppa tutte le dipendenze
Funziona offline
Non richiede OAuth
Ulteriori informazioni:
Repository MCPB - Specifica completa e architettura
Post del Blog sulle Estensioni Desktop - Panoramica e casi d'uso
Quando devo usare un server locale (MCPB) rispetto a un server remoto?
Scegli un server locale (MCPB) per:
Sistemi Interni e Sicurezza
Accedi ai sistemi dietro il tuo firewall (JIRA, Confluence, wiki interni, database privati)
Autenticazione senza interruzioni - Utilizza automaticamente le sessioni SSO e del browser esistenti, nessuna gestione dei token
Conformità zero-trust - Funziona all'interno dei confini della tua rete aziendale senza esporre pubblicamente le risorse interne
Risorse Locali
Accesso diretto al filesystem per la modifica del codice e le operazioni Git
Integrazione con strumenti installati localmente (Docker, IDE, database)
Integrazione hardware e controllo delle applicazioni desktop
Operazioni sensibili alla privacy che non dovrebbero lasciare la macchina dell'utente
Distribuzione Enterprise
Installazione con un solo clic con runtime Node.js integrato (nessuna dipendenza da gestire)
Nessuna infrastruttura cloud, configurazioni VPN o regole firewall richieste
Controlli a livello organizzativo - Gli amministratori possono caricare estensioni personalizzate e gestire l'accesso tramite allowlist
Controllo completo su autenticazione, autorizzazione e log di audit
Scegli un connettore remoto per:
Servizi cloud e API pubbliche che richiedono infrastruttura centralizzata
Distribuzione su claude sul web, mobile e desktop
Servizi che necessitano di aggiornamenti centralizzati per tutti gli utenti
Flussi OAuth che richiedono la gestione dei token lato server
Integrazioni pubbliche utilizzate da più organizzazioni
Differenza chiave: Gli MCPB vengono eseguiti sulla macchina dell'utente tramite trasporto stdio con accesso alle risorse locali e interne. I connettori remoti vengono eseguiti sui tuoi server tramite HTTPS e sono accessibili tramite l'infrastruttura di Anthropic.
Uso nel mondo reale: Le organizzazioni stanno costruendo MCPB come proxy sicuri per server MCP interni, per l'accesso alla documentazione interna e per connettere gli strumenti di sviluppo mantenendo la loro architettura di sicurezza.
Per la guida ai connettori remoti: Vedi FAQ Partner MCP per la documentazione completa sui connettori remoti.
2. Iniziare
Quale linguaggio di programmazione devo usare?
Node.js è fortemente consigliato perché:
Viene fornito con Claude per macOS e Windows (zero attrito di installazione per gli utenti)
Gli utenti non hanno bisogno di un'installazione runtime separata
Migliore compatibilità e affidabilità con Claude Desktop
Supporto esteso dell'SDK MCP
Quali piattaforme devo supportare?
Claude Desktop viene eseguito su:
macOS (darwin)
Windows (win32)
Specifica le piattaforme supportate nella sezione compatibilità del tuo manifest.json.
Best practice: Testa su entrambe le piattaforme anche se sviluppi principalmente su una.
Dettagli sulla compatibilità della piattaforma: Vedi Specifica Manifest MCPB - Compatibilità per la specifica della piattaforma e i requisiti di runtime.
Come creo il mio primo MCPB?
Segui questo processo in cinque fasi:
1. Installa MCPB CLI: npm install -g @anthropic-ai/mcpb
2. Crea il tuo server MCP (vedi MCP SDK)
3. Esegui mcpb init per creare manifest.json
4. Esegui mcpb pack per raggruppare
5. Installa e testa in Claude Desktop
Per una guida all'implementazione dettagliata:
Repository MCPB - Guida completa per iniziare, utilizzo CLI e specifiche
Esempi MCPB - Implementazioni di riferimento funzionanti incluso "Hello World"
SDK MCP - Implementazione del protocollo core
Per una guida completa su sviluppo, test e best practice, vedi la sezione "For Bundle Developers" del README MCPB.
Importante: Prima di distribuire il tuo MCPB, rivedi la guida ai test e alle best practice nel README MCPB per garantire la qualità.
3. Configurazione
Cos'è manifest.json?
Il file manifest.json è metadati obbligatori che descrivono il tuo MCPB - cosa fa, come eseguirlo, quali strumenti fornisce e quale configurazione necessita.
Per le informazioni più aggiornate, fai riferimento alla Specifica MCPB ufficiale.
Specifica Manifest MCPB - Schema completo con tutti i campi
Manifest di Esempio - Implementazioni nel mondo reale
Documentazione CLI - Riferimento dei comandi
Come aggiungo un'icona?
Le icone sono facoltative ma consigliate per un aspetto professionale.
Approccio di base: Includi il file icon.png nella directory root del tuo bundle e fai riferimento ad esso in manifest.json.
Requisiti:
Nome file: icon.png (o percorso personalizzato)
Dimensione: 512×512px consigliato (minimo 256×256px)
Formato: PNG con supporto della trasparenza
Posizione: Root del bundle o percorso specificato
Opzioni avanzate: Varianti di icone multiple per diverse dimensioni e temi (supporto modalità chiara/scura).
Dettagli di implementazione: Vedi Specifica Manifest MCPB - Icone per:
Configurazione del campo icona
Sintassi delle varianti di icone multiple
Specifiche di dimensione e tema
Best practice e requisiti
Come configurano gli utenti il mio MCPB?
Definisci la sezione user_config in manifest.json. Claude Desktop crea automaticamente un'interfaccia utente delle impostazioni in cui gli utenti possono configurare la tua estensione.
Vedi Specifica Manifest MCPB - Configurazione Utente per l'implementazione completa:
Schema completo ed esempi
Tutti i tipi di configurazione e le proprietà
Vincoli di convalida
Gestione dei dati sensibili
Modelli multi-selezione
Come installano gli utenti il mio MCPB?
Ci sono tre diversi metodi di installazione:
Doppio clic - Scarica il file .mcpb e fai doppio clic per aprire
Trascinamento - Trascina il file .mcpb nella finestra di Claude Desktop
Menu File - Sviluppatore → Estensioni → Installa Estensione → seleziona il file .mcpb
Tutti i metodi aprono l'interfaccia utente di installazione dove gli utenti possono:
Rivedere i dettagli dell'estensione e i permessi
Configurare le impostazioni richieste
Concedere i permessi necessari
Completare l'installazione
Ambito di installazione: Installazione per utente - ogni utente deve installare separatamente sul proprio sistema.
Esperienza utente e controlli amministrativi: Per informazioni dettagliate sull'esperienza di installazione dell'utente finale e sui controlli amministrativi aziendali (inclusa la gestione dell'organizzazione Team/Enterprise e la configurazione dei criteri), vedi:
Iniziare con i Server MCP Locali su Claude Desktop - Guida utente completa che copre la navigazione della directory, l'interfaccia utente di installazione, la risoluzione dei problemi e i controlli amministrativi.
4. Risorse
Documentazione Ufficiale
Framework MCPB:
Repository MCPB - Specifica completa e strumenti
Specifica Manifest MCPB - Schema manifest completo
Documentazione CLI MCPB - Riferimento dello strumento da riga di comando
Esempi MCPB - Implementazioni di riferimento
Protocollo MCP:
Specifica MCP - Documentazione del protocollo
Guida Rapida MCP - Guida per iniziare
SDK TypeScript - Implementazione Node.js
SDK Python - Implementazione Python
Claude Desktop:
Note di Rilascio - Aggiornamenti della versione
Blog Estensioni Desktop - Panoramica dell'architettura
Ottenere Aiuto
Canali di supporto:
Problemi GitHub MCPB - Segnalazioni di bug e richieste di funzionalità
Specifica MCP - Domande sul protocollo
Supporto Claude - Supporto generale di Claude Desktop
Risorse della comunità:
Controlla le discussioni del repository per le domande e risposte della comunità
Segui le note di rilascio per gli ultimi aggiornamenti
Rivedi gli esempi per i modelli di implementazione
Pronto per la Distribuzione Pubblica?
Se hai creato un MCPB funzionante e desideri inviarlo alla Directory di Anthropic per una distribuzione e una scoperta più ampia, vedi la nostra guida complementare: Invio alla Directory di Anthropic.
La guida della directory copre requisiti aggiuntivi inclusi:
Annotazioni di strumenti obbligatorie per tutti gli strumenti
Requisiti della politica sulla privacy
Minimo di tre esempi funzionanti
Credenziali di test (se applicabile)
Processo di invio completo e timeline di revisione