Come collegare il tuo agente di coding IA ai tuoi strumenti con MCP

Se hai passato del tempo con un agente di coding IA, probabilmente ti sei scontrato con quel muro in cui dice qualcosa come "Non riesco a vedere il tuo database" oppure "incolla qui i dettagli del problema." L'agente è intelligente, ma è chiuso in una scatola: conosce solo ciò che è nei tuoi file e ciò che digiti. Il Model Context Protocol (MCP) è il modo per abbattere quel muro e permettere all'agente di raggiungere i tuoi strumenti reali: un database, GitHub, una dashboard di monitoraggio, un file di design.

Questa guida spiega cos'è MCP e ti accompagna nel collegamento del tuo primo server a Claude Code, con le stesse idee valide anche per Cursor e Copilot.

Cos'è davvero MCP

MCP è uno standard aperto: pensalo come un adattatore universale tra gli agenti IA e i sistemi che già usi. Invece che ogni strumento inventi un proprio modo di parlare con ogni agente, uno strumento distribuisce un solo server MCP, e qualsiasi agente compatibile con MCP (Claude, Cursor, Copilot) può connettersi ad esso. Ecco perché nel 2026 hai visto "MCP" ovunque: è l'impianto idraulico che permette agli agenti di fare lavoro reale, invece di limitarsi a parlarne.

Una buona regola pratica: collega un server ogni volta che ti sorprendi a copiare dati dentro la chat da un altro strumento. Se continui a incollare log di errori da Sentry o dettagli di ticket da Jira, è il segnale che un server MCP ti farebbe risparmiare il giro.

I due tipi di server

Ci sono due varianti che incontrerai:

• Server remoti (HTTP) girano nel cloud e ti connetti tramite la rete: Notion, GitHub e la maggior parte degli strumenti SaaS funzionano così. Questa è l'opzione predefinita consigliata.
• Server locali (stdio) girano come processo sulla tua macchina: utili per cose che richiedono accesso diretto al sistema, come un driver di database locale.

Aggiungere il tuo primo server

Il comando centrale è claude mcp add. Ecco la forma base per un server HTTP remoto:

claude mcp add --transport http <name> <url>

Un esempio concreto: collegare Notion in modo che il tuo agente possa leggere e aggiornare le pagine:

claude mcp add --transport http notion https://mcp.notion.com/mcp

Se il server richiede l'autenticazione, passa un token come header:

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Per un server locale, tutto ciò che segue -- è il comando che lo avvia:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Quel -- è importante: separa i flag propri di Claude dal comando che avvia il server, così un --port destinato al server non viene interpretato come un'opzione di Claude.

Una volta aggiunto, controlla cosa hai collegato:

claude mcp list        # vedi tutti i server e il loro stato
claude mcp get notion  # dettagli di un singolo server

All'interno di una sessione di Claude Code, il comando /mcp mostra lo stato della connessione in tempo reale e, per i server che usano OAuth, ti permette di accedere.

Scegli lo scope giusto

Quando aggiungi un server, decidi chi dovrebbe vederlo con il flag --scope:

• local (l'impostazione predefinita): solo tu, solo questo progetto.
• project: condiviso con tutto il tuo team tramite un file .mcp.json versionato. Ottimo per l'onboarding: un nuovo collega clona il repository e l'agente conosce già gli strumenti del team.
• user: disponibile per te in ogni progetto sulla tua macchina.

Per un database di team o un tracker di issue, di solito quello che vuoi è lo scope project. Per una chiave API personale, mantieni local o user così non finisce mai nel repository.

Fallo in sicurezza

MCP è potente proprio perché dà all'agente una portata reale, quindi un po' di cautela ripaga:

• Fidati del server prima di collegarlo. Un server che recupera contenuti esterni può esporti al rischio di prompt injection, in cui testo malevolo nei dati recuperati cerca di pilotare il tuo agente. Attieniti a server ufficiali di fornitori che riconosci.
• Limita strettamente le credenziali. Dai al server una chiave in sola lettura o con privilegi minimi quando il compito richiede solo la lettura. È esattamente il principio che Microsoft ha integrato nel suo plugin Dataverse per le imprese: l'agente vede solo ciò che il ruolo che gli è stato concesso consente.
• Tieni i segreti fuori dalla configurazione condivisa. Metti i token in variabili d'ambiente o in uno scope local, mai in un file .mcp.json con scope project che viene committato.
• Rivedi cosa può fare. Dopo la connessione, apri /mcp e scorri gli strumenti che il server espone, così non ci sono sorprese.

Il vantaggio

Una volta collegato un server, il cambiamento nel modo in cui lavori è immediato. Invece di "ecco lo schema che ho incollato", puoi chiedere: "Trova i 10 iscritti più recenti nel nostro database Postgres e prepara una bozza di invito a una sessione di feedback per ciascuno." L'agente interroga il database, legge i risultati e prepara le email, tutto in un unico flusso, perché finalmente può raggiungere i sistemi in cui il tuo lavoro vive davvero.

Inizia con un solo server per lo strumento da cui incolli più spesso. Quella singola connessione di solito rende evidente il valore più velocemente di qualsiasi quantità di letture sull'argomento.