Lezione gratuita

Contratto MCP di sola lettura

Contratto MCP di sola lettura — Creare un server MCP minimo in sola lettura. Host, client e server; Strumenti e risorse hanno ruoli diversi; Usare la linea SDK attuale. Esercitazione pratica: Pratica: Contratto MCP di sola lettura.

Versione demo. I materiali sono in fase di revisione editoriale.

Argomenti trattati

  • Host, client e server
  • Strumenti e risorse hanno ruoli diversi
  • Usare la linea SDK attuale

Host, client e server

MCP definisce la comunicazione tra applicazione AI e server di dati o strumenti. L'host gestisce utente e modello, un client si collega a un server specifico e il server espone capacità consentite. Il protocollo non concede automaticamente accesso al filesystem né paga inferenze. Il laboratorio restituisce solo due note operative fittizie in memoria. Non legge home, esegue shell o usa rete, mantenendo il confine interamente verificabile prima di aggiungere archivi.

Strumenti e risorse hanno ruoli diversi

Lo strumento lookup_note accetta noteId e restituisce una nota; lab://policy è una risorsa con URI fisso letta come contesto. Una URI non deve essere un indirizzo browser o file. ReadOnlyHint descrive l'intenzione, non impone permessi del sistema operativo. Servono codice e privilegi del processo. Anche sola lettura può divulgare testi privati all'host, quindi richiede autorizzazione. Il catalogo contiene soltanto note didattiche dichiarate, senza credenziali reali o dati personali.

Usare la linea SDK attuale

La documentazione verificata descrive MCP2026-07-28 e SDK TypeScript v2 stabile con pacchetti server e client separati. Il vecchio @modelcontextprotocol/sdk appartiene a v1: non mescolarne gli import con v2. Usa JavaScript ESM su Node supportato e Zod4, registrando dipendenze risolte nel lockfile. Installare la libreria non dimostra la negoziazione moderna con qualunque avvio. La factory serveStdio e la connessione legacy hanno comportamenti diversi, da verificare esplicitamente nei prossimi controlli.

npm init -y
npm pkg set type=module
npm install --save-exact @modelcontextprotocol/server @modelcontextprotocol/client zod@4
npm install --save-dev --save-exact @modelcontextprotocol/inspector

Esercitazione pratica

Pratica: Contratto MCP di sola lettura

Vai alla lezione

Programma del corso

  1. Contratto MCP di sola lettura
  2. Catalogo e schema degli argomenti
  3. Registrare strumento e risorsa reali
  4. Stdio, HTTP e negoziazione
  5. Test del protocollo senza modello
  6. Collegamento client e verifica