Guida all'installazione dei plugin MCP

Scopri come installare e configurare i server MCP (Model Context Protocol) per estendere le capacita di Claude con strumenti esterni, fonti di dati e integrazioni.

Il Model Context Protocol (MCP) e uno standard aperto creato da Anthropic che definisce come i modelli di intelligenza artificiale si connettono a fonti di dati e strumenti esterni. Spesso descritto come "l'USB-C dell'IA", MCP fornisce un'interfaccia universale che permette a Claude di interagire con i tuoi file locali, database, API e strumenti di sviluppo.

Dal 2026, MCP e supportato da Anthropic, OpenAI, Google e Microsoft, affermandosi come lo standard di integrazione di riferimento per gli agenti IA. Nell'ecosistema sono attualmente disponibili oltre 593 server MCP, dai pacchetti ufficiali Anthropic alle integrazioni sviluppate dalla community.

Prerequisiti

terminal

Node.js (LTS)

Necessario per eseguire la maggior parte dei server MCP tramite npx. Scaricabile da nodejs.org.

code

Python / uv (Opzionale)

Alcuni server MCP sono basati su Python e utilizzano uvx al posto di npx.

desktop_mac

Claude Desktop

L'app Claude Desktop deve essere installata. Disponibile per macOS e Windows.

info

Nessun abbonamento richiesto

I server MCP funzionano con qualsiasi piano Claude, incluso quello gratuito.

Posizione del file di configurazione

I server MCP vengono configurati nel file claude_desktop_config.json. La posizione del file dipende dal tuo sistema operativo:

desktop_mac macOS

~/Library/Application Support/Claude/claude_desktop_config.json

desktop_windows Windows

%APPDATA%\Claude\claude_desktop_config.json

lightbulb

Suggerimento

Non e necessario creare questo file manualmente. Claude Desktop puo generarlo automaticamente: consulta i passaggi di installazione qui sotto.

Installazione passo passo

Avvia Claude Desktop

Apri l'applicazione Claude Desktop sul tuo computer.

Apri le Impostazioni

Clicca sul menu hamburger → File → Impostazioni (oppure usa la scorciatoia da tastiera).

Vai alla scheda Sviluppatore

Nel pannello Impostazioni, clicca sulla scheda "Developer" nella barra laterale sinistra.

Clicca su "Edit Config"

Questo apre (o crea) il file claude_desktop_config.json nel tuo editor di testo predefinito.

Aggiungi la configurazione del server MCP

Aggiungi i server MCP desiderati sotto la chiave mcpServers (vedi il formato di configurazione qui sotto).

Salva e riavvia

Salva il file di configurazione e riavvia completamente Claude Desktop affinche le modifiche abbiano effetto.

Verifica l'installazione

Cerca l'icona del martello 🔨 nell'interfaccia di Claude Desktop. Cliccandola vedrai tutti gli strumenti MCP disponibili.

Formato di configurazione

Il file di configurazione utilizza una semplice struttura JSON. Ogni server MCP viene definito sotto la chiave mcpServers:

data_object Struttura base

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@package/server-name"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

folder Esempio server Filesystem

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

stacks Esempio con piu server

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    }
  }
}

Server MCP piu diffusi

Ecco i server MCP piu utilizzati nell'ecosistema:

Server	Pacchetto	Funzione
Filesystem	`@modelcontextprotocol/server-filesystem`	Lettura/scrittura di file locali, creazione documenti, organizzazione cartelle
GitHub	`@modelcontextprotocol/server-github`	Lettura di codebase, ispezione PR, monitoraggio workflow
PostgreSQL	`@modelcontextprotocol/server-postgres`	Accesso al database in sola lettura con ispezione dello schema
Brave Search	`@modelcontextprotocol/server-brave-search`	Funzionalita di ricerca web
Puppeteer	`@modelcontextprotocol/server-puppeteer`	Automazione del browser e web scraping
Sequential Thinking	`@modelcontextprotocol/server-sequential-thinking`	Ragionamento dinamico e risoluzione dei problemi passo passo
Slack	`@anthropic/mcp-server-slack`	Integrazione con workspace Slack
Google Drive	`@anthropic/mcp-server-gdrive`	Integrazione con Google Docs, Sheets e Drive
Docker	`@anthropic/mcp-server-docker`	Gestione e orchestrazione dei container
Memory	`@modelcontextprotocol/server-memory`	Memoria persistente tra le sessioni

Protocolli di trasporto

MCP supporta diversi meccanismi di trasporto per la comunicazione tra Claude e i server MCP:

terminal

stdio (Standard I/O)

Il trasporto predefinito per Claude Desktop. Il client avvia il server MCP come processo locale e comunica tramite stdin/stdout. Questo e cio che i campi command e args nella configurazione definiscono.

check Consigliato per uso locale

cloud

StreamableHTTP

Il protocollo consigliato per l'accesso web e remoto. Supporta piu client simultanei ed e il successore del trasporto SSE, ormai deprecato.

language Per server remoti/web

do_not_disturb

SSE (Server-Sent Events)

Deprecato a favore di StreamableHTTP. Da evitare per le nuove integrazioni.

Considerazioni sulla sicurezza

warning

Importante

I server MCP vengono eseguiti localmente con accesso al tuo sistema. A gennaio 2026 sono state scoperte vulnerabilita critiche nel server MCP Git ufficiale di Anthropic. Segui sempre le best practice di sicurezza.

check_circle

Installa solo da fonti verificate — Utilizza i pacchetti ufficiali Anthropic o server della community ben noti e attivamente mantenuti.

check_circle

Mantieni i server aggiornati — Esegui regolarmente npx @package/server-name per ottenere le ultime patch di sicurezza.

check_circle

Usa variabili d'ambiente per i segreti — Non inserire mai le chiavi API direttamente nel file di configurazione. Utilizza il campo env o le variabili d'ambiente di sistema.

check_circle

Limita l'ambito del filesystem — Quando usi il server filesystem, concedi l'accesso solo alle directory specifiche di cui hai bisogno.

check_circle

Rimuovi i server inutilizzati — Ogni server MCP aumenta la superficie di attacco. Rimuovi quelli che non stai utilizzando attivamente.

arrow_forward Leggi la nostra guida completa sulla sicurezza contro il Prompt Injection

Risoluzione dei problemi

L'icona del martello non compare dopo il riavvio expand_more

Di solito significa che il file di configurazione contiene un errore di sintassi JSON. Problemi comuni:

Virgole mancanti o in eccesso tra le voci dei server
Parentesi quadre o graffe non corrispondenti
Uso di apici singoli al posto dei doppi apici

Verifica il tuo JSON su jsonlint.com oppure usa node -e "JSON.parse(require('fs').readFileSync('path/to/config.json'))"

Il server MCP non si avvia expand_more

Verifica i seguenti punti:

Assicurati che Node.js sia installato e che npx sia disponibile nel tuo PATH
Prova a eseguire il comando npx manualmente nel terminale per visualizzare eventuali errori
Controlla che il nome del pacchetto sia corretto (gli errori di battitura sono frequenti)
Per i server che richiedono chiavi API, verifica che la chiave sia valida e correttamente impostata nel campo env

Errori di permesso negato expand_more

I server MCP ereditano i permessi del processo Claude Desktop:

Su macOS, controlla Impostazioni di Sistema → Privacy e Sicurezza per i permessi pertinenti
Assicurati che le directory specificate nella configurazione siano accessibili dal tuo account utente
Per il server filesystem, verifica che i percorsi in args esistano e siano leggibili

extension

Esplora l'ecosistema MCP

Con oltre 593 server MCP disponibili, e molto probabile che esista un server adatto al tuo caso d'uso. Consulta la directory ufficiale dei server MCP su modelcontextprotocol.io oppure esplora le liste curate dalla community su GitHub per scoprire le ultime novita.