Il Model Context Protocol (MCP) è un protocollo aperto che consente l'integrazione senza interruzioni tra applicazioni LLM e fonti dati e strumenti esterni. Con l'introduzione delle estensioni desktop, l'installazione e la gestione dei server MCP locali è diventata significativamente più facile.
Estensioni desktop
Le estensioni desktop forniscono un modo semplificato per installare e gestire i server MCP locali tramite pacchetti installabili con un solo clic. Invece di configurare manualmente i file JSON e gestire le dipendenze, puoi ora installare i server MCP locali sul tuo computer con la stessa facilità dei componenti aggiuntivi del browser.
Nota: Stiamo creando una directory di estensioni desktop – se sei uno sviluppatore che spera di aggiungere un'estensione che hai creato alla directory, completa il nostro modulo di interesse per le estensioni desktop per condividere ulteriori informazioni con noi.
Installazione delle estensioni desktop dalla directory
Vai a Impostazioni > Estensioni su Claude Desktop.
Fai clic su "Sfoglia estensioni" per visualizzare la nostra directory e fai clic su uno qualsiasi degli strumenti revisionati da Anthropic che desideri utilizzare. Fai clic su "Installa" sull'estensione desiderata.
Configura le impostazioni richieste (come le chiavi API) tramite l'interfaccia intuitiva.
L'estensione sarà automaticamente disponibile nelle tue conversazioni.
Installazione di estensioni desktop personalizzate
Vai a Impostazioni > Estensioni su Claude Desktop.
Fai clic su "Impostazioni avanzate" e trova la sezione Sviluppatore di estensioni.
Fai clic su "Installa estensione…"
Seleziona il file .mcpb e segui le istruzioni per installare.
Controlli amministrativi per le estensioni desktop
I proprietari e i proprietari principali dei piani Team ed Enterprise possono gestire l'accesso del team alle estensioni desktop utilizzando due controlli:
Abilita o disabilita le estensioni desktop pubbliche in base agli standard di sicurezza della tua organizzazione.
Carica estensioni desktop personalizzate e rendile disponibili al tuo team per l'installazione con un clic.
Questi controlli consentono alle organizzazioni di personalizzare completamente i loro registri aggiungendo solo le estensioni a cui il team ha bisogno di accedere e rimuovendo tutte le altre.
Abilitazione/disabilitazione di estensioni specifiche sui piani Team ed Enterprise
I proprietari e i proprietari principali delle organizzazioni Team ed Enterprise possono gestire quali estensioni desktop sono abilitate per la tua organizzazione e accessibili agli altri membri tramite Claude Desktop. Vedi Abilitazione e utilizzo della lista di autorizzazione delle estensioni desktop
per istruzioni specifiche.
Crea e carica estensioni personalizzate per la tua organizzazione
I caricamenti di estensioni desktop personalizzate consentono ai piani Team ed Enterprise di sfruttare flussi di lavoro specifici dell'organizzazione che non sono disponibili nella directory pubblica. Dopo aver creato un'estensione desktop personalizzata, i proprietari e i proprietari principali possono navigare verso Impostazioni > Estensioni all'interno di Claude Desktop e fare clic su "Impostazioni avanzate" per accedere alla sezione Sviluppatore di estensioni:
Fai clic su "Installa estensione…" e seleziona il file .mcpb. Segui le istruzioni per installare e configurare la tua estensione desktop personalizzata. Per informazioni più dettagliate, consulta la nostra documentazione per sviluppatori di estensioni desktop.
Controlli dei criteri aziendali
Nota: I controlli dei criteri aziendali a livello di macchina utente sostituiranno qualsiasi controllo in-app (blocklist e allowlist). Se desideri utilizzare un controllo in-app, assicurati che isDesktopExtensionEnabled e isDesktopExtensionDirectoryEnabled non siano impostati su "false" in modo che la lista di autorizzazione possa popolare il registro disponibile.
Per controllare le estensioni desktop tramite i criteri di sistema, consulta la nostra documentazione sulla configurazione aziendale di desktop.
Risoluzione dei problemi di installazione dell'estensione desktop
L'estensione non si installa
Assicurati di eseguire la versione più recente di Claude Desktop.
Verifica che il file dell'estensione non sia corrotto scaricandolo di nuovo.
Verifica di avere spazio su disco sufficiente per l'installazione.
L'estensione appare installata ma gli strumenti non sono disponibili
Riavvia Claude Desktop per aggiornare il registro delle estensioni.
Controlla le impostazioni di configurazione dell'estensione per i campi obbligatori mancanti.
Verifica che le chiavi API o le credenziali di autenticazione siano inserite correttamente.
Problemi di configurazione dell'estensione
Vai a Impostazioni > Estensioni e fai clic sull'estensione per rivedere le sue impostazioni.
Assicurati che tutti i campi di configurazione richiesti siano completati.
Verifica che i percorsi dei file (se applicabile) puntino a directory esistenti a cui hai accesso.
Errori di autorizzazione o sicurezza
Su macOS, controlla Preferenze di sistema > Sicurezza e privacy se ricevi avvisi di sicurezza.
Su Windows e Linux, assicurati che Claude Desktop abbia i permessi necessari per accedere alle directory richieste.
Per gli ambienti aziendali, verifica che le estensioni desktop siano abilitate tramite i criteri della tua organizzazione.
Domande frequenti per sviluppatori
Come posso verificare se i miei server MCP sono correttamente connessi in Claude Desktop?
Fai clic sul pulsante "+" in basso nella casella di chat all'interno di Claude Desktop, quindi seleziona "Connettori." Questo ti mostrerà i server MCP connessi e i loro strumenti. In alternativa, puoi visitare le impostazioni dello sviluppatore (in App desktop) per visualizzare lo stato della connessione e controllare i registri per eventuali server MCP.
Come posso convertire il mio server MCP esistente in un'estensione desktop?
Aggiungi un file manifest.json alla directory del tuo server MCP con i metadati richiesti.
Pacchettizzalo utilizzando il comando
mcpb pack.Vedi la documentazione MCPB per istruzioni dettagliate.
Quali linguaggi di programmazione sono supportati per le estensioni desktop?
Le estensioni desktop supportano server MCP Node.js, Python e binari. Claude Desktop include un ambiente Node.js integrato, quindi l'installazione di Node.js non è necessaria.
Come gestisco la configurazione sensibile come le chiavi API?
Contrassegna i campi di configurazione come "sensitive": true nel tuo manifest.json. Claude Desktop crittograferà automaticamente questi valori utilizzando l'archiviazione sicura del sistema operativo (Keychain su macOS, Credential Manager su Windows e il gestore delle chiavi della tua distribuzione su Linux).
Posso distribuire la mia estensione desktop personalizzata privatamente?
Sì, puoi condividere i file .mcpb direttamente con utenti o team specifici. Per una distribuzione più ampia, puoi inviare estensioni alla directory ufficiale.
Come posso eseguire il debug dei problemi con la mia estensione desktop?
Abilita la registrazione del debug nelle impostazioni di Claude Desktop, controlla i registri dell'estensione nel pannello delle impostazioni delle estensioni e consulta la guida al debug di MCP per la risoluzione dei problemi specifici del protocollo.
Cosa succede quando la mia estensione ha bisogno di aggiornamenti?
Le estensioni dalla directory ufficiale si aggiornano automaticamente per impostazione predefinita. Per le estensioni distribuite privatamente, gli utenti dovranno installare manualmente i file .mcpb aggiornati.
Interessato a saperne di più su MCP?
Per informazioni più dettagliate sulla creazione dei tuoi client e server MCP, ti consigliamo di consultare le seguenti risorse:
Guida di avvio rapido MCP - Un tutorial passo dopo passo perfetto per iniziare con l'integrazione MCP di base.
Github del Model Context Protocol - Contiene la documentazione tecnica completa, esempi di codice e guide di implementazione.
Guida al debug delle integrazioni MCP - Suggerimenti per la risoluzione dei problemi e soluzioni per le sfide di implementazione comuni.
Se hai bisogno di ulteriori indicazioni, visita la nostra guida su Come ottenere supporto per ulteriori opzioni di supporto.