MCP spiegato: connettere il tuo agente a tutto

Panoramica

MCP e un connettore universale per gli agenti. Invece che ogni strumento inventi la sua integrazione su misura, un server MCP espone le sue capacita in un modo standard che ogni agente compatibile puo usare. Collegane uno, e il tuo agente puo d'improvviso interrogare un database, leggere un file di design, pilotare un browser o frugare nei tuoi doc - e usa queste azioni come qualsiasi altro strumento. Il protocollo e la ragione dell'esplosione delle capacita d'agente: costruisci un server una volta, e ogni agente compatibile MCP puo usarlo.

Cosa imparerai

Imparerai cos'e MCP e perche un protocollo condiviso conta, la differenza tra un server e un client, come aggiungere un server a Claude Code con una vera configurazione .mcp.json, e il giudizio piu importante e piu trascurato di tutto questo ambito: quando un server MCP e davvero lo strumento giusto contro quando un semplice strumento da riga di comando descritto nel tuo CLAUDE.md fa il lavoro con meno overhead.

Prerequisiti

Un setup d'agente funzionante e le lezioni sul contesto del Corso 1, perche ogni server connesso consuma contesto - le sue definizioni di strumenti occupano la finestra - e il performance cliff si applica sempre. Le lezioni su CLAUDE.md e gli hook aiutano anche, perche la decisione CLI contro MCP si riduce spesso a una regola o uno script che sai gia scrivere.

Il problema

Il tuo agente e brillante dentro i tuoi file e cieco ovunque altrove. Non puo vedere il tuo database di produzione, i tuoi file di design, lo stato dal vivo di una pagina web o il contenuto di un servizio esterno. Cosi diventi tu gli appunti umani: copi dati da uno strumento, li incolli nell'agente, ricopi l'output dell'agente. Questa navetta manuale e lenta, soggetta a errori e mette un tetto alla quantita di vero lavoro che puoi delegare. Prima di MCP, l'unico modo di correggere questo era un'integrazione su misura per strumento, che quasi nessuno ha costruito.

Il problema che MCP risolve

MCP definisce un connettore standard. Un server parla MCP per esporre una capacita - un database, uno storage di file, un browser, una API. Un client (il tuo agent harness) parla MCP per usare qualsiasi server. Poiche il protocollo e condiviso, l'integrazione si scrive una volta per strumento e funziona su ogni agente che supporta MCP, proprio come l'USB significava che non ti serviva piu un cavo diverso per apparecchio. Questa sola decisione spiega perche il supporto si e diffuso cosi in fretta e perche esiste ormai un server MCP per quasi tutto cio che vorresti connettere.

• Server: espone una capacita tramite MCP (un database, uno strumento di design, un browser, un indice di ricerca).
• Client: il tuo agent harness, che puo usare ogni server MCP che colleghi.
• Connettore standard: un'integrazione per strumento funziona su ogni agente compatibile MCP, invece di N integrazioni su misura.
• Un server puo offrire tool (azioni che l'agente esegue) e resource (dati che l'agente legge).

Aggiungere un server

In Claude Code, registri i server MCP in un file .mcp.json alla radice del tuo progetto (committato, perche il team condivida le stesse connessioni) o nella tua configurazione utente per quelli personali. Ogni voce nomina un server e come avviarlo. Ecco un vero .mcp.json che collega due server comuni: un server filesystem ristretto a una cartella, e un server Playwright che lascia l'agente pilotare un vero browser. Collegali una volta, e queste azioni diventano disponibili per l'agente come qualsiasi altro strumento.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./data"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

I server che hanno bisogno di credenziali (un database, una API ospitata) le prendono tramite variabili d'ambiente piuttosto che chiavi in chiaro, quindi la stessa disciplina .env del Corso 1 si applica: i segreti restano fuori dalla configurazione committata. Dopo aver aggiunto un server, il tuo agente puo elencare e chiamare i suoi strumenti direttamente. Consulta la documentazione propria di ogni server per il suo comando di avvio esatto e le variabili d'ambiente richieste.

MCP contro un semplice strumento CLI

E il giudizio che separa le persone che capiscono gli agenti da quelle che collezionano integrazioni. Un server MCP non e automaticamente migliore di uno strumento da riga di comando. Claude Code puo gia eseguire ogni CLI che hai installato, e un'istruzione di una riga nel tuo CLAUDE.md - "usa la CLI gh per GitHub, la CLI stripe per Stripe" - e spesso piu semplice, piu leggera e piu trasparente di un server MCP dedicato. Gli strumenti CLI brillano quando un'interfaccia da riga di comando matura esiste gia, quando vuoi vedere esattamente quale comando ha girato, e quando vuoi zero overhead di contesto supplementare. MCP merita il suo posto quando non c'e un buon CLI, quando hai bisogno di dati strutturati e resource piuttosto che output testuale, o quando l'interazione e davvero interattiva, come pilotare un browser o interrogare un database dal vivo tramite un'interfaccia tipizzata. Afferra prima il CLI; afferra MCP quando il CLI non puo davvero fare bene il lavoro.

• Preferisci un CLI quando: un buon strumento da riga di comando esiste gia, vuoi una trasparenza totale e un costo di contesto minimo.
• Preferisci MCP quando: non c'e un CLI corretto, hai bisogno di tool e resource strutturati, o il compito e interattivo (browser, database dal vivo).
• Ogni server connesso aggiunge definizioni di strumenti al tuo context window, quindi ognuno ha un costo reale e continuo.
• Connetti deliberatamente. Tre server che usi battono quindici che gonfiano il tuo contesto.

Errori frequenti

Gli errori comuni: collegare ogni server MCP che trovi e annegare il tuo context window sotto definizioni di strumenti che non usi mai; afferrare un server MCP quando uno strumento CLI che hai gia farebbe il lavoro piu semplicemente; mettere credenziali in chiaro in .mcp.json invece di usare variabili d'ambiente; e dimenticare che un server MCP e codice di terzi con accesso alle tue cose, quindi dovresti esaminare cio che colleghi come esamineresti una dipendenza. Connetti poco, connetti deliberatamente, connetti cose di cui ti fidi.

ROI business

MCP e cio che trasforma un agente di codice in un operatore polivalente per il tuo business. Connetti i server giusti, e l'agente non ha piu bisogno di te come appunti: puo leggere il tuo database, ispezionare una pagina dal vivo, tirare da un servizio e reagire a veri dati dall'inizio alla fine. E la differenza tra un agente che abbozza codice e un agente che pilota un workflow. La disciplina di connettere deliberatamente - e di scegliere un CLI quando un CLI basta - tiene questa potenza economica e il tuo contesto affilato, cosicche ottieni la portata senza pagare la tassa del cliff.

Checklist

Sei pronto ad andare avanti quando ognuno di questi punti e vero. La prossima lezione passa da un agente ben equipaggiato a piu agenti.

• Sai spiegare MCP come un connettore standard e nominare i ruoli server e client.
• Hai aggiunto almeno un server MCP tramite .mcp.json a un vero progetto.
• Sai nominare un caso chiaro in cui uno strumento CLI batte un server MCP, e viceversa.
• Capisci che ogni server connesso costa contesto e superficie d'attacco.

Risorse

Tieni nei preferiti la pagina ufficiale del Model Context Protocol e la documentazione MCP di Claude Code per il formato di configurazione aggiornato e la directory dei server disponibili. I server filesystem, Playwright e database sono buone prime connessioni. Associa MCP a una regola nel tuo CLAUDE.md che dice all'agente quale CLI preferire per quale job, perche afferri un server solo se il CLI non puo davvero aiutare.

La tua missione

Collega un server MCP tramite .mcp.json su un vero progetto - il server filesystem o Playwright e un inizio leggero. Poi fai deliberatamente l'inverso: scegli un compito per cui avresti forse afferrato un server, e aggiungi invece una regola di una riga nel tuo CLAUDE.md che dice all'agente di usare uno strumento CLI esistente. Nota quale e sembrato piu facile. Questo istinto e la vera abilita qui.

Prossima lezione

Un unico agente ben equipaggiato e potente, ma puo tenere solo tanta roba nel contesto. La prossima lezione passa a piu agenti: sub-agent, squadre d'agenti, la motivazione del context cliff dietro e come impedire a una squadra di moltiplicare in silenzio i tuoi costi.