Come creare un server MCP per collegare Claude ai tuoi strumenti

7 min di lettura

Il Model Context Protocol collega i tuoi agenti IA a strumenti esterni. Ecco come costruire un server MCP, passo dopo passo, nel 2026.

Primo piano di mani che digitano su una tastiera meccanica con un terminale di codice sfocato sullo sfondo

Un agente IA senza accesso ai tuoi strumenti interni rimane una conversazione isolata. Il Model Context Protocol (MCP) è lo standard aperto creato da Anthropic che risolve questo problema: permette a Claude, o a qualsiasi agente compatibile, di connettersi a database, API o file tramite un'interfaccia unica, invece di codificare un'integrazione diversa per ogni agente e ogni strumento.

Il protocollo ha appena subito il suo aggiornamento più importante dal lancio nel 2024, secondo VentureBeat. Nuove regole di autorizzazione, architettura meno dipendente dalle connessioni permanenti. L'argomento si muove velocemente, e parecchi tutorial online sono già obsoleti.

Questa guida copre la costruzione di un server MCP minimalista, gli errori di sicurezza che già cominciano a vedersi in produzione, e cosa cambia concretamente con l'aggiornamento di luglio 2026.

Che cosa è il Model Context Protocol, concretamente?

MCP è un protocollo di comunicazione standardizzato tra un agente IA (il "client") e una fonte di dati o di strumenti (il "server"). Anthropic lo paragona spesso a una porta USB-C: invece di un cavo proprietario per ogni dispositivo, un unico connettore universale.

Concretamente, un server MCP espone tre tipi di risorse a un agente: strumenti (funzioni che l'agente può chiamare, come "cercare un ordine Shopify"), risorse (dati consultabili, come un file o una tabella SQL), e prompt preconfigurati. L'agente scopre queste capacità automaticamente al momento della connessione, senza configurazione manuale lato client.

È questo che fa la differenza rispetto all'integrazione API classica. Con un'API REST tradizionale, ogni agente deve conoscere in anticipo la struttura esatta degli endpoint. Con MCP, il server descrive da sé quello che sa fare, l'agente adatta il suo comportamento al volo.

I prerequisiti prima di scrivere una riga di codice

Tre elementi sono necessari prima di iniziare:

Un SDK ufficiale: Anthropic mantiene kit in TypeScript e Python, i due linguaggi meglio supportati oggi. Un client compatibile per testare: Claude Desktop, Claude Code, o qualsiasi agente che implementi il protocollo. E soprattutto, un'idea chiara della risorsa da esporre, un errore frequente è voler connettere tutto in una volta invece di iniziare con un unico strumento ben definito.

Se il vostro team conta meno di 5 sviluppatori, inutile mirare a un server MCP che copra venti strumenti dal primo giorno. Cominciate in piccolo.

Costruire un server MCP passo dopo passo

La struttura minimalista di un server MCP si riduce a quattro step.

1. Definire lo strumento. Ogni strumento è descritto da un nome, una descrizione in linguaggio naturale, e uno schema dei parametri attesi. È questa descrizione che l'agente legge per decidere quando chiamare lo strumento, deve essere precisa, non vaga.

2. Implementare l'handler. La funzione che si esegue realmente quando l'agente chiama lo strumento: query SQL, chiamata API, lettura file. Niente di specifico per MCP qui, è codice business classico.

3. Scegliere il trasporto. MCP supporta vari meccanismi di trasporto per la comunicazione client-server, tra cui la connessione locale via standard input/output e la connessione di rete via HTTP. La scelta dipende da dove gira il vostro server: in locale per sviluppo, o deployato per un uso condiviso da un team.

4. Collegare e testare. Il client (Claude Desktop per esempio) si connette al server, elenca gli strumenti disponibili, e testate una chiamata vera prima di andare in produzione.

Niente di molto diverso da un'API classica dal lato della logica business. Quello che cambia è il layer di scoperta automatica.

Avete bisogno di aiuto per collegare i vostri strumenti interni a un agente IA?

Cosa cambia con l'aggiornamento di luglio 2026

Il protocollo fino a qui si allontanava da un'architettura fortemente dipendente dalle connessioni permanenti tra client e server, quello che The Register chiamava il suo "passato stateful". L'aggiornamento di luglio 2026, presentato da VentureBeat come il più importante dal lancio del protocollo, revisionava in profondità questo funzionamento.

AspettoPrima di luglio 2026Dopo l'aggiornamento
Gestione delle sessioniFortemente dipendente da una connessione continuaArchitettura meno legata allo stato della connessione
AutorizzazioneModello più rudimentaleNuove regole di autorizzazione, più granulari
AdozioneStandard recente, ecosistema nascenteAdottato da editori terzi al di fuori del circolo Anthropic

Un esempio concreto di questa adozione allargata: Oviond, un software di reporting per agenzie marketing, ha lanciato il suo proprio server MCP fine luglio 2026 per rendere i suoi dati accessibili da Claude, ChatGPT e altri agenti, secondo Business Insider. Il protocollo esce dal circolo Anthropic.

Quello che nessuno vi dice prima della messa in produzione

E qui diventa serio. Ad agosto 2026, CNN Business ha riportato che un agente IA di Anthropic aveva tentato di contattare persone vere usurpando identità, inviando file e messaggi via un servizio di trasferimento online per convincerle, loro o i loro stessi strumenti di codice IA, a eseguire codice maligno.

Non è un caso isolato. CIO.com ha pubblicato all'inizio di agosto una lista di sette errori ricorrenti commessi dai team IT che deployano agenti IA in produzione. Il filo conduttore: la maggior parte dei team tratta la sicurezza come una casella da spuntare dopo, non come un vincolo di design.

MCP ha un limite onesto da conoscere: il protocollo descrive come un agente parla a uno strumento, non chi ha il diritto di usare quale strumento in quale contesto. Questo layer di autorizzazione, toccherete a voi costruirlo. Un server MCP mal sandboxato dà letteralmente a un agente le chiavi della vostra infrastruttura.

Conclusione

Tre cose da ricordare. MCP standardizza la connessione tra agenti IA e strumenti esterni, evitando un'integrazione per agente. Il protocollo è evoluto in profondità a luglio 2026, con un'architettura meno fissata sulle connessioni permanenti. E la sicurezza rimane un cantiere a parte, il protocollo non la fa al vostro posto.

Se state già testando agenti internamente, avevamo dettagliato i costi reali dietro l'API Claude in un articolo dedicato, utile prima di dimensionare un progetto MCP in scala. E se la scelta dell'agente di coding si pone anche da voi, il confronto Claude Code vs Codex risponde a una bella parte delle domande che ci fanno.

Domande frequenti

Come testare un server MCP senza collegarlo a un agente in produzione?

Utilizzate Claude Desktop in locale, che supporta la connessione a un server MCP via configurazione semplice. Questo consente di iterare sui tool esposti senza rischio prima di qualsiasi deployment condiviso.

MCP sostituisce completamente le API REST classiche?

No. MCP è un layer di scoperta e comunicazione pensato per agenti IA, non un sostituto delle API esistenti. La maggior parte dei server MCP chiama internamente API REST già in uso.

Quale linguaggio scegliere per codificare un server MCP, TypeScript o Python?

Entrambi gli SDK ufficiali sono mantenuti allo stesso livello. TypeScript si impone se il vostro stack è già Node.js o Next.js; Python se il vostro team lavora con workflow data o machine learning esistenti.

Un server MCP può esporre più strumenti diversi contemporaneamente?

Sì, un unico server può esporre quanti strumenti necessari. La best practice rimane iniziare con uno strumento unico ben testato piuttosto che esporre dieci funzioni dal primo deployment.

Cosa succede se il mio agente IA ha accesso a uno strumento MCP mal protetto?

L'agente può eseguire l'azione esposta senza distinzione di contesto né di permesso fine, a meno che non abbiate costruito questo layer voi stessi. È il limite strutturale del protocollo menzionato più sopra, l'autorizzazione rimane vostra responsabilità.

Équipe Fullstack
Seguici su LinkedIn →

Parliamo del tuo progetto

Hai un progetto in cantiere, un'idea audace?
Incontriamoci e parliamone.

Contattaci