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 Anthropic Connectors Directory.
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:
MCPB Repository - Specifica completa e architettura
Desktop Extensions Blog Post - 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 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 attraverso 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 MCP Partner FAQ 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 MCPB Manifest Spec - Compatibility 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:
MCPB Repository - Guida completa per iniziare, utilizzo CLI e specifiche