Vai al contenuto principale

Iniziare con Model Context Protocol (MCP) su Claude for Desktop

Aggiornato oggi

MCP in Claude for Desktop è attualmente una funzionalità beta.

Il Model Context Protocol (MCP) è un protocollo aperto che consente l'integrazione senza soluzione di continuità tra applicazioni LLM e fonti di dati e strumenti esterni. Con l'introduzione delle estensioni desktop (DXT), l'installazione e la gestione dei server MCP locali è diventata significativamente più semplice.

Estensioni Desktop

Le estensioni desktop forniscono un modo semplificato per installare e gestire server MCP locali attraverso pacchetti installabili con un singolo clic. Invece di configurare manualmente file JSON e gestire dipendenze, ora puoi installare server MCP locali sul tuo computer con la stessa facilità delle estensioni del browser.

Nota: Stiamo costruendo 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 maggiori informazioni con noi.

Installazione delle Estensioni Desktop

  1. Naviga su Impostazioni > Estensioni all'interno di Claude Desktop

  2. Sfoglia la directory delle estensioni o installa da un file .dxt

  3. Clicca "Installa" sull'estensione desiderata

  4. Configura eventuali impostazioni richieste (come chiavi API) attraverso l'interfaccia user-friendly

  5. L'estensione sarà automaticamente disponibile nelle tue conversazioni

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 nuovamente

  • 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 campi obbligatori mancanti

  • Verifica che eventuali chiavi API o credenziali di autenticazione siano inserite correttamente

Problemi di configurazione dell'estensione

  • Naviga su Impostazioni > Estensioni e clicca sull'estensione per rivedere le sue impostazioni

  • Assicurati che tutti i campi di configurazione richiesti siano completati

  • Verifica che i percorsi dei file (se applicabili) puntino a directory esistenti a cui hai accesso

Errori di permessi 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 ambienti aziendali, verifica che le estensioni desktop siano abilitate attraverso le politiche della tua organizzazione

FAQ per Sviluppatori

Come converto il mio server MCP esistente in un'estensione DXT?

  1. Aggiungi un file manifest.json alla directory del tuo server MCP con i metadati richiesti

  2. Impacchettalo usando il comando dxt pack

  3. Vedi la documentazione DXT per istruzioni dettagliate

Quali linguaggi di programmazione sono supportati per le estensioni DXT?

Le estensioni DXT supportano Node.js, Python e server MCP binari. Claude Desktop include un ambiente Node.js integrato, quindi l'installazione di Node.js non è richiesta.

Come gestisco configurazioni sensibili 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 DXT privatamente?

Sì, puoi condividere file .dxt direttamente con utenti o team specifici. Per una distribuzione più ampia, puoi inviare estensioni alla directory ufficiale.

Come risolvo i problemi con la mia estensione DXT?

Abilita il logging di debug nelle impostazioni di Claude Desktop, controlla i log dell'estensione nel pannello delle impostazioni Estensioni e fai riferimento alla guida di debugging 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 .dxt aggiornati.

Controlli delle Politiche Aziendali

Gli amministratori aziendali possono controllare le estensioni desktop attraverso politiche di sistema:

Configurazione Aziendale macOS

Configura le estensioni desktop attraverso un file property list in

~/Library/Preferences/com.anthropic.Claude.plist:

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict>    <key>isDxtEnabled</key>    <true/>    <key>isDxtDirectoryEnabled</key>    <false/>    <key>isDxtSignatureRequired</key>    <true/>    <key>dxtRegistry</key>    <string>https://registry.example.com</string></dict></plist>

Configurazione Azien

Hai ricevuto la risposta alla tua domanda?