Il Model Context Protocol (MCP) è un protocollo aperto che consente l'integrazione senza soluzione di continuità tra le applicazioni LLM e le fonti di dati e gli 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 attraverso pacchetti installabili con un solo clic. Invece di configurare manualmente i file JSON e gestire le dipendenze, è ora possibile installare i server MCP locali sul tuo computer con la stessa facilità delle estensioni 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
Accedi a Impostazioni > Estensioni su Claude Desktop.
Fai clic su "Sfoglia estensioni" per visualizzare la nostra directory e fai clic su qualsiasi strumento revisionato 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
Accedi a Impostazioni > Estensioni su Claude Desktop.
Fai clic su "Impostazioni avanzate" e trova la sezione Extension Developer.
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 primari dei piani Team e 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 e Enterprise
I proprietari e i proprietari primari delle organizzazioni Team e 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 e Enterprise di sfruttare i 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 primari possono accedere a Impostazioni > Estensioni all'interno di Claude Desktop e fare clic su "Impostazioni avanzate" per accedere alla sezione Extension Developer:
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ù approfondite, consulta la nostra documentazione per sviluppatori di estensioni desktop.
Controlli dei criteri Enterprise
Nota: I controlli dei criteri Enterprise a livello di utente-macchina sostituiranno qualsiasi controllo in-app (lista nera e lista bianca). Se desideri utilizzare un controllo in-app, assicurati che isDesktopExtensionEnabled e isDesktopExtensionDirectoryEnabled non siano impostati su "false" in modo che la lista bianca possa popolare il registro disponibile.
Per controllare le estensioni desktop tramite i criteri di sistema, consulta la nostra documentazione sulla configurazione enterprise desktop.
Risoluzione dei problemi di installazione delle estensioni desktop
L'estensione non si installa
Assicurati di eseguire l'ultima versione 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
Accedi 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, assicurati che Claude Desktop abbia i permessi necessari per accedere alle directory richieste.
Per gli ambienti enterprise, verifica che le estensioni desktop siano abilitate tramite i criteri della tua organizzazione.
Domande frequenti per sviluppatori
Come verifico se i miei server MCP sono correttamente connessi in Claude Desktop?
Fai clic sul pulsante "+" in fondo alla 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 (sotto Desktop app) per visualizzare lo stato della connessione e consultare i log per eventuali server MCP.
Come converto 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 è richiesta.
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).
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 eseguo il debug dei problemi con la mia estensione desktop?
Abilita la registrazione del debug nelle impostazioni di Claude Desktop, controlla i log 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ù approfondite 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 ulteriore assistenza, visita la nostra guida su Come ottenere supporto per ulteriori opzioni di supporto.