Sin dall'introduzione pubblica di Anthropic Protocollo del contesto modello (MCP) on 25 Novembre 2024, MCP si è rapidamente evoluto da un concetto a un ecosistema pratico: sono disponibili una specifica aperta e più server di riferimento, le implementazioni della comunità (server di memoria, accesso al file system, web fetcher) sono su GitHub e NPM e MCP è già supportato in client come Claude per Desktop e strumenti di terze parti. Il protocollo si è evoluto (le specifiche e gli esempi di server sono stati aggiornati fino al 2025) e fornitori e ingegneri stanno pubblicando modelli per integrazioni più sicure ed efficienti in termini di token.
Questo articolo ti guida attraverso la creazione di un server MCP, collegandolo a Claude Desktope suggerimenti pratici/sulla sicurezza/sulla memoria di cui avrai bisogno in produzione.
Che cos'è il Model Context Protocol (MCP)?
Una definizione semplice in inglese
Il protocollo di contesto del modello (MCP) è un protocollo aperto e standardizzato che rende semplice per gli host LLM (le app che eseguono il modello, ad esempio Claude Desktop) chiamare servizi esterni che espongono risorse (file, righe DB), strumenti (funzioni che il modello può invocare) e istruzioni (modelli che il modello può utilizzare). Invece di implementare integrazioni N×M (ogni modello per ogni strumento), MCP fornisce uno schema client-server coerente e un contratto di runtime in modo che qualsiasi host di modello compatibile con MCP possa utilizzare qualsiasi server compatibile con MCP, in modo che gli sviluppatori possano creare servizi una sola volta e consentire a qualsiasi modello o interfaccia utente compatibile con MCP (ad esempio, Claude Desktop) di utilizzarli.
Perché MCP è importante adesso
Da quando Anthropic ha reso open source MCP alla fine del 2024, il protocollo è rapidamente diventato un livello di interoperabilità de facto per l'integrazione di strumenti (Claude, estensioni VS Code e altri ambienti di agenti). MCP riduce il lavoro duplicato, velocizza lo sviluppo di connettori (Google Drive, GitHub, Slack, ecc.) e semplifica l'associazione di archivi di memoria persistenti a un assistente.
Cos'è l'architettura MCP e come funziona?
Ad alto livello, MCP definisce tre gruppi di ruoli e diversi modelli di interazione.
Componenti principali: client, server e registro
- Client MCP (host): L'host o l'applicazione LLM che richiede dati contestuali: Claude Desktop, un agente VS Code o un'app web. Il client rileva e si connette a uno o più server MCP.
- Server MCP (fornitore di risorse): Un servizio di rete che espone risorse (file, memorie, database, azioni) tramite lo schema MCP. I server dichiarano le proprie capacità e forniscono endpoint che il client può chiamare.
- Registro/Scoperta: Componenti opzionali o file di configurazione che aiutano il client a scoprire i server MCP disponibili, elencare le capacità e gestire le autorizzazioni o l'installazione (le "estensioni" del desktop sono un livello UX per questo).
Flussi di messaggi e negoziazione delle capacità
Le interazioni MCP seguono in genere questo schema:
- Scoperta / registrazione: Il client viene a conoscenza dei server disponibili (registri locali, di rete o curati).
- Annuncio di capacità: Il server condivide un manifesto che descrive risorse, metodi e requisiti di autorizzazione.
- Richiesta/risposta: Il client invia richieste strutturate (ad esempio, "leggi il file X", "cerca Y nelle memorie" o "crea PR con questi file") e il server risponde con dati contestuali tipizzati.
- Risultati dell'azione e streaming: I server possono trasmettere i risultati in streaming o fornire endpoint operativi di lunga durata. La specifica definisce gli schemi per i descrittori di risorse tipizzati e le risposte.
Modello di sicurezza e limiti di fiducia
MCP standardizza intenzionalmente le superfici di controllo in modo che gli LLM possano agire sui dati utente ed eseguire azioni. Questa capacità richiede accurati controlli di sicurezza:
- Consenso esplicito dell'utente / richieste sono consigliati quando i server possono accedere a dati privati o eseguire azioni privilegiate (ad esempio, scrivere nei repository).
- Il privilegio minimo si manifesta: I server dovrebbero dichiarare gli ambiti minimi e i client dovrebbero richiedere solo le funzionalità necessarie.
- Trasporto e autorizzazione: Utilizzare TLS, credenziali tokenizzate ed endpoint solo locali per integrazioni sensibili. La community e i fornitori di piattaforme (ad esempio, Microsoft in Windows) stanno sperimentando registri e affordance dell'interfaccia utente per ridurre i rischi.
Perché integrare Claude con i server MCP?
L'integrazione di Claude con i server MCP sblocca tre classi pratiche di funzionalità:
Contesto fruibile in tempo reale
Invece di copiare e incorporare snapshot obsoleti nei prompt, Claude può richiedere un contesto aggiornato (file, cronologia delle conversazioni, righe del database) al momento della query. Ciò significa meno recuperi approssimativi e output più recenti. Le demo di Anthropic mostrano Claude impegnato in attività come la creazione di PR GitHub o la lettura di file locali tramite MCP.
Piccoli strumenti componibili anziché un unico adattatore gigante
È possibile scrivere server MCP mirati (uno per il calendario, uno per il file system, uno per un archivio di memoria vettoriale) e riutilizzarli su diverse istanze o client Claude (desktop, IDE, web). Questa modularità è più scalabile rispetto alle integrazioni personalizzate.
Memoria persistente e standardizzata
MCP abilita i servizi di memoria: archivi persistenti che codificano la cronologia delle conversazioni, le preferenze personali e lo stato utente strutturato. Poiché MCP standardizza il modello di risorse, più client possono riutilizzare lo stesso server di memoria e mantenere un contesto utente coerente tra le app. Esistono già diversi servizi di memoria e modelli di estensione della community.
Migliore UX e controllo locale (Claude Desktop)
Sui client desktop, MCP consente ai server locali di accedere direttamente al file system di un utente (con il consenso dell'utente), rendendo possibili integrazioni sensibili alla privacy senza API cloud. Le estensioni desktop di Anthropic sono un esempio di semplificazione dell'installazione e dell'individuazione dei server MCP sui computer locali.
Come creare un server MCP
Cosa ti serve prima di iniziare
- Claude Desktop: Installa l'ultima versione di Claude Desktop per il tuo sistema operativo e assicurati che il supporto MCP/Estensioni sia abilitato nelle impostazioni. Alcune funzionalità potrebbero richiedere un piano a pagamento (Claude Pro o equivalente).
- Macchina di sviluppo: Node.js (>=16/18 consigliato), o Python 3.10+, più ngrok o una soluzione di tunneling locale se si desidera esporre un server locale a Internet per i test. Utilizzare TLS in produzione.
- Il progetto MCP fornisce SDK e modelli nella documentazione principale e nel repository GitHub; installare l'SDK Python o Node seguendo le istruzioni ufficiali nella documentazione/repo.
Opzione A: installare un server MCP esistente (esempio)
Anthropic fornisce esempi di server, tra cui memoria, file system e strumenti.
Clonare i server di riferimento:
git clone https://github.com/modelcontextprotocol/servers.git
cd servers
All'interno troverai cartelle come:
filesystem/
fetch/
memory/
weather/
Per installare un server di esempio:
cd memory
npm install
npm run dev
In questo modo viene avviato il server MCP, solitamente all'indirizzo:
http://localhost:3000
Verificare che l'endpoint del manifesto funzioni e che la chiamata a uno strumento restituisca un JSON correttamente tipizzato.
Opzione B: crea il tuo server MCP (consigliato per l'apprendimento)
1) Creare una cartella di progetto
mkdir my-mcp-server
cd my-mcp-server
npm init -y
2) Installare l'SDK del server MCP
npm install @modelcontextprotocol/server
3) Creare un file server di base
Crea
server.js:
touch server.js
Incolla l'implementazione minima del server MCP:
import { createServer } from "@modelcontextprotocol/server";
const server = createServer({
name: "my-custom-server",
version: "0.1.0",
tools: [
{
name: "hello_world",
description: "Returns a simple greeting",
input_schema: {
type: "object",
properties: {
name: { type: "string" }
},
required:
},
output_schema: {
type: "object",
properties: {
message: { type: "string" }
}
},
handler: async ({ name }) => {
return { message: `Hello, ${name}!` };
}
}
]
});
server.listen(3000);
console.log("MCP server running on http://localhost:3000");
Questo è server MCP completo esponendo un singolo strumento: hello_world.
Come connettere Claude Desktop a un server MCP?
Di seguito è riportata una guida pratica per creare un semplice server MCP e registrarlo con Claude Desktop. Questa sezione è pratica: illustra la configurazione dell'ambiente, la creazione del manifesto del server, l'esposizione degli endpoint attesi dal client e la configurazione di Claude Desktop per l'utilizzo del server.
1) Aprire l'area di connessione dello sviluppatore di Claude Desktop
Nel desktop di Claude: Impostazioni → Sviluppatore (o Impostazioni → Connettori (a seconda della build del client). È disponibile un'opzione per aggiungere un server MCP remoto/locale o "Aggiungi connettore". L'interfaccia utente esatta potrebbe cambiare tra le versioni: se non la vedi, controlla il menu "Sviluppatore" del desktop o le note di versione più recenti.
2) Se si sta configurando un server locale: creare o individuare il file di configurazione
Dopo aver avviato l'applicazione desktop Claude, tutti i server MCP rilevati vengono automaticamente configurati in un file denominato ClaudeDesktopConfig.json. Il primo passo è individuare e aprire questo file, oppure crearlo se non esiste già:
Per gli utenti Windows, il file si trova in “%APPDATA%\Claude\claude_desktop_config.json”.
Per gli utenti Mac, il file si trova in “~/Library/Application Support/Claude/claude_desktop_config.json”.
3) Aggiungi il server a Claude Desktop
Esistono due modelli UX per far sapere a Claude Desktop del tuo server MCP:
Estensioni desktop / Programmi di installazione con un clic: Anthropic ha documentato "Estensioni Desktop" che impacchettano manifesti e programmi di installazione in modo che gli utenti possano aggiungere server tramite un flusso con un solo clic (consigliato per una distribuzione più ampia). È possibile impacchettare il manifesto e i metadati del server per una facile installazione.
Registrazione del server locale (modalità sviluppatore): Per test locali:
- Posizionare il manifesto in un percorso locale ben noto o servirlo a
https://localhost:PORT/.well-known/mcp-manifest.json. - Nelle impostazioni di Claude Desktop, apri il pannello MCP/Estensioni e scegli "Aggiungi server locale" o "Aggiungi server tramite URL", quindi incolla l'URL o il token del manifest.
- Concedi le autorizzazioni necessarie quando il client lo richiede. Claude enumererà le risorse del server e le presenterà come strumenti/memorie disponibili.
Ora scegliamo di installare l'MCP locale:Aggiungi un mcpServers pagina che elenca il nome del server e un percorso/comando assoluto per avviarlo. Salva e riavvia Claude Desktop.
Dopo il riavvio, l'interfaccia utente di Claude presenterà gli strumenti MCP (icona Cerca e Strumenti) e ti consentirà di testare le operazioni esposte (ad esempio, "Che tempo fa a Sacramento?"). Se l'host non rileva il tuo server, consulta mcp.log file e mcp-server-<name>.log per l'output STDERR.
4) Testare l'integrazione
Nella chat di Claude, digita:
Call the hello_world tool with name="Alice"
Claude richiamerà il tuo server MCP e risponderà utilizzando l'output dello strumento.
Come posso implementare un servizio di memoria su MCP (suggerimenti avanzati)?
I servizi di memoria sono tra i server MCP più potenti perché persistono e rendono visibile il contesto utente tra le sessioni. Le seguenti best practice e suggerimenti per l'implementazione riflettono le specifiche, la documentazione di Claude e i modelli della community.
Modello e progettazione dei dati di memoria
- Strutturato vs. non strutturato: Memorizza sia dati strutturati (ad esempio, nome, flag di preferenza) sia frammenti di conversazione non strutturati. Utilizza metadati tipizzati per un filtraggio rapido.
- Chunking e incorporamenti: Suddividere documenti o conversazioni lunghi in blocchi semanticamente coesi e memorizzare incorporamenti vettoriali per supportare la ricerca di similarità. Ciò migliora la capacità di richiamo e riduce l'utilizzo di token durante il recupero.
- Segnali di recency e salienza: Registra timestamp e punteggi di salienza; consenti query che privilegiano ricordi recenti o di elevata salienza.
- Tag sulla privacy: Etichettare gli elementi con etichette di riservatezza (privato, condiviso, temporaneo) in modo che il cliente possa richiedere il consenso.
Modelli API per le operazioni di memoria
Implementare almeno tre operazioni:
write: Accetta un elemento di memoria con metadati, restituisce la conferma e l'ID di archiviazione.query: Accetta una query in linguaggio naturale o un filtro strutturato e restituisce le prime k memorie corrispondenti (facoltativamente con metadati di spiegazione).delete/update: Supporta le operazioni del ciclo di vita e le richieste esplicite degli utenti di dimenticare.
Progettare le risposte in modo da includere la provenienza (da dove proviene il ricordo) e un punteggio di affidabilità/somiglianza, in modo che il cliente e il modello possano decidere quanto aggressivamente utilizzare il ricordo.
Strategie di aumento del recupero per Claude
- Brevi finestre di contesto: Restituisci frammenti di memoria concisi anziché documenti completi; lascia che Claude richieda il contesto completo, se necessario.
- Livello di riepilogo: Facoltativamente, memorizza un breve riepilogo di ogni memoria per ridurre i token. Utilizza il riepilogo incrementale durante le scritture.
- Iniezione controllata: Fornire la memoria come un "pacchetto di contesto" collegabile che il client può iniettare selettivamente nei prompt anziché inondare il modello con ogni cosa.
Sicurezza e governance per MCP di memoria
- Consenso e traccia di controllo: Registra quando è stato creato un ricordo e se l'utente ha acconsentito a condividerlo con il modello. Presenta chiare affordance dell'interfaccia utente in Claude Desktop per la revisione e la revoca dei ricordi.
- Limitazione della velocità e convalida: Difenditi dall'iniezione di prompt o dall'esfiltrazione convalidando i tipi e non consentendo richieste di esecuzione di codice inaspettate dai server.
- Crittografia a riposo e in transito: Utilizzare una crittografia avanzata per gli elementi archiviati e TLS per tutti gli endpoint MCP. Per gli archivi basati su cloud, utilizzare la crittografia envelope o le chiavi gestite dal cliente, se disponibili.
Conclusione: come creare un server MCP in Claude Desktop
L'articolo è una ricetta compatta e pragmatica per passare da zero → a un server di memoria Claude + funzionante sul tuo laptop:
- Testare un flusso di lavoro: Chiedi a Claude di "ricordare" un breve fatto e di verificare che il server lo abbia memorizzato; poi chiedi a Claude di richiamare quel fatto in un prompt successivo. Osserva i log e ottimizza la classificazione del recupero.
- Prerequisiti di installazione: Node.js >= 18, Git, Claude Desktop (più recente).
- Clona un server di riferimento: forchetta il
modelcontextprotocol/serversesempi o un server di memoria della comunità su GitHub. - Installa ed esegui:
npm install→npm run dev(o seguire il README del repository). Confermare l'endpoint del manifesto (ad esempio,http://localhost:3000/manifest) restituisce JSON. () - Registra il connettore in Claude Desktop: Impostazioni → Sviluppatore / Connettori → Aggiungi connettore → punta a
http://localhost:3000e approvare gli ambiti.
L'integrazione di Claude (o di qualsiasi host) con i server MCP consente di creare un connettore una sola volta e di renderlo disponibile su tutti i client MCP (Claude Desktop, IDE o altri framework di agenti), riducendo drasticamente la manutenzione e velocizzando la parità delle funzionalità tra gli strumenti.
Gli sviluppatori possono accedere all'ultima API di Claude AI (alla data di pubblicazione di questo articolo) come Claude Sonetto 4.5 API e al API di Claude Opus 4.1 tramite CometAPI, l'ultima versione del modello è sempre aggiornato con il sito ufficiale. Per iniziare, esplora le capacità del modello nel Parco giochi e consultare il Guida API per istruzioni dettagliate. Prima di accedere, assicurati di aver effettuato l'accesso a CometAPI e di aver ottenuto la chiave API. CometaAPI offrire un prezzo molto più basso rispetto al prezzo ufficiale per aiutarti a integrarti.
Pronti a partire? → Iscriviti oggi a CometAPI !
Se vuoi conoscere altri suggerimenti, guide e novità sull'IA seguici su VK, X e al Discordia!