Vai al contenuto principale

Creazione di Estensioni Desktop con MCPB

Aggiornato oltre un mese fa

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:

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 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 della CLI e specifiche

  • MCPB Examples - Implementazioni di riferimento funzionanti incluso "Hello World"

  • MCP SDK - Implementazione del protocollo core

Per una guida completa su sviluppo, test e best practice, vedi la sezione "For Bundle Developers" del MCPB README.

Importante: Prima di distribuire il tuo MCPB, rivedi la guida ai test e alle best practice nel MCPB README 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.

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 MCPB Manifest Spec - Icons 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 MCPB Manifest Spec - User Configuration 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-select

Come installano gli utenti il mio MCPB?

Ci sono tre diversi metodi di installazione:

  1. Doppio clic - Scarica il file .mcpb e fai doppio clic per aprire

  2. Trascinamento - Trascina il file .mcpb nella finestra di Claude Desktop

  3. Menu File - Developer → Extensions → Install Extension → 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:

4. Risorse

Documentazione Ufficiale

Framework MCPB:

Protocollo MCP:

Claude Desktop:

Ottenere Aiuto

Canali di supporto:

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 Anthropic Directory per una distribuzione più ampia e una migliore scopribilità, vedi la nostra guida complementare: Submitting to Anthropic Directory.

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 presentazione completo e cronologia della revisione

Articoli correlati
Iniziare con i Server MCP Locali su Claude Desktop
FAQ Directory Connettori Anthropic
Abilitazione e utilizzo della lista di autorizzazione delle estensioni desktop
Distribuzione di server MCP di livello enterprise con estensioni desktop
Guida all'invio di Local MCP Server
Hai ricevuto la risposta alla tua domanda?