Tutti gli articoli
AFFiNE
Toeverything·Pubblicato 19 ago 2026 · Aggiornato 20 ago 2026
Documenti e lavagne collegati a un assistente IA tramite una porta MCP

Server MCP: cos'è, come funziona e come provarlo in 5 minuti

L'essenziale in 30 secondi

  • MCP (Model Context Protocol) è uno standard aperto che collega gli assistenti IA a strumenti e dati esterni. Anthropic lo ha pubblicato a novembre 2024 e oggi lo supportano Claude, ChatGPT, Cursor e quasi tutte le principali applicazioni IA.
  • Un server MCP è un piccolo programma che espone uno strumento o una fonte di dati tramite quello standard: lo configuri una volta e funziona con qualsiasi client compatibile.
  • MCP non sostituisce le API né il RAG: standardizza il modo in cui il modello scopre gli strumenti disponibili e li chiama in sicurezza, quasi sempre sopra API esistenti.
  • Per provarlo non serve programmare: il server MCP integrato di AFFiNE rende ricercabili documenti e lavagne in pochi minuti, senza un costo MCP aggiuntivo quando le funzioni IA sono attive.

Gli assistenti IA hanno tutti lo stesso limite: ragionano benissimo, ma non arrivano dove sta davvero il tuo lavoro — appunti, codice, strumenti di progetto. Il server MCP colma esattamente questo divario. In questa guida vediamo che cos'è MCP, come funziona il protocollo, in che cosa differisce da API e RAG e come collegare il tuo primo server in pochi minuti.

Che cos'è MCP e da dove arriva

MCP sta per Model Context Protocol: uno standard aperto con cui i modelli IA si collegano a strumenti e dati esterni. Anthropic lo ha pubblicato a novembre 2024, open source dal primo giorno. L'adozione è stata insolitamente rapida: OpenAI ha annunciato il supporto a marzo 2025, Google poche settimane dopo; nel 2026 il supporto MCP è di serie in Claude, ChatGPT, Cursor, Cline e negli agenti di VS Code.

Il problema che MCP risolve è vecchio e costoso: l'integrazione N×M. Collegare cinque applicazioni IA a sei strumenti significava trenta integrazioni su misura — ognuna con la propria autenticazione, il proprio formato dati, i propri errori. Con un protocollo comune, ogni applicazione implementa MCP una volta, ogni strumento espone un server MCP una volta, e ogni combinazione funziona.

Da qui la metafora ormai universale: MCP è la porta USB-C dell'IA. Un solo connettore, qualunque cosa colleghi. Il protocollo in sé è volutamente sobrio: messaggi JSON-RPC su due trasporti — stdio per i server locali, Streamable HTTP per quelli remoti.

Che cos'è un server MCP, di preciso

Un server MCP è un programma che mette a disposizione delle applicazioni IA tre tipi di capacità:

  • Strumenti (tools): azioni che il modello può invocare — cercare documenti, creare una issue, interrogare un database. Ogni strumento dichiara input e output tipizzati.
  • Risorse (resources): dati che l'applicazione può leggere come contesto — file, documenti, schemi.
  • Prompt: template riutilizzabili che il server offre per i flussi più comuni.

Le dimensioni variano molto: c'è il server di cento righe costruito attorno a un'API interna e c'è quello di GitHub, con decine di strumenti per repository, issue e pull request. Alcuni girano in locale accanto all'editor; altri li ospita il prodotto stesso — come il server MCP integrato di AFFiNE, dove non c'è nulla da installare né da aggiornare.

Più che un plugin da chatbot, un server MCP è infrastruttura: un contratto stabile e tipizzato tra l'applicazione IA che usi oggi e il sistema che custodisce i tuoi dati. Cambi assistente l'anno prossimo? Il server continua a funzionare.

Come funziona: host, client e server

Ogni interazione segue gli stessi quattro passaggi:

  1. L'applicazione host apre una sessione. L'host è l'app che usi tu — Claude Desktop, Claude Code, Cursor — e avvia un client MCP per ogni server configurato.
  2. Il client scopre le capacità. Alla connessione chiede al server quali strumenti, risorse e prompt offre: il modello vede un catalogo vivo, non un'integrazione congelata nel codice.
  3. Il modello chiama uno strumento. Quando la richiesta ha bisogno di contesto esterno («trova la checklist di lancio»), sceglie lo strumento adatto e invia argomenti tipizzati. La ricerca o l'interrogazione vera e propria la esegue il server.
  4. I risultati alimentano la risposta. Il server restituisce contenuto strutturato e il modello risponde con dati reali, non con supposizioni.
Flusso dall’host IA, attraverso un client e un server MCP, verso endpoint distinti per strumenti e dati
MCP offre una connessione standard mantenendo separati strumenti e dati di ciascun server.

A cosa serve un server MCP

  • Programmare con il contesto reale del progetto: i server di GitHub, Playwright e Chrome DevTools permettono agli agenti di leggere le issue, pilotare un browser vero nei test e ispezionare pagine reali.
  • Cercare nella propria base di conoscenza: il server MCP di AFFiNE indicizza anche il testo delle lavagne e sa indicare l'elemento o il frame esatto — l'assistente ritrova lo schema di architettura disegnato in riunione, non solo il verbale che lo cita.
  • Dal design al codice: il server di Figma dà agli agenti accesso strutturato ai file di design.
  • Operazioni e dati: Slack, Sentry e i server di database recuperano il thread, l'avviso o la riga che spiega cosa sta succedendo.
  • Automazione: uno strumento come n8n espone centinaia di applicazioni dietro un'unica connessione MCP.

Un test semplice per capire se ti serve: conta quante volte copi e incolli contenuti in una chat IA. Ogni copia-incolla ricorrente è un server MCP che manca.

I server MCP più usati

ServerCollegaUso tipico
GitHubRepository, issue, PR«Riassumi i bug aperti»
PlaywrightUn browser realeTest E2E guidati dagli agenti
Chrome DevToolsL'interno del browserAnalisi delle prestazioni
FigmaFile di designCodice fedele al mockup
SlackCanali, thread«Cosa abbiamo deciso a marzo?»
NotionPagine, databaseInterrogare il workspace (server solo hosted)
Obsidian (community)Vault localeCercare negli appunti Markdown (serve l'app desktop aperta)
AFFiNEDocumenti + lavagneRicerca semantica; nessun costo MCP aggiuntivo con funzioni IA attive

A questi si aggiungono il registro ufficiale (in anteprima da fine 2025) e le directory della community, con migliaia di altri server.

MCP vs API vs RAG

Sono tre cose diverse che finiscono spesso nella stessa frase:

Che cos'èA chi si rivolgeQuando ti serve
APIL'interfaccia propria di un servizioSviluppatori che scrivono codiceCostruire software per quel servizio
MCPLo strato standard per le applicazioni IAAssistenti IAFar usare uno strumento a qualsiasi assistente
RAGUna tecnica di recupero dei contenutiUna singola applicazioneAncorare le risposte ai tuoi documenti

MCP non sostituisce le API: la maggior parte dei server MCP è uno strato sottile sopra API esistenti. La differenza è il destinatario: le API sono pensate per chi scrive codice; MCP, perché sia un modello a scoprire le capacità e a chiamarle in sicurezza. E non sostituisce il RAG: il RAG descrive come un'applicazione recupera i passaggi rilevanti prima di rispondere, MCP come qualunque applicazione raggiunge i sistemi esterni. Le due cose si combinano: la ricerca di AFFiNE unisce parole chiave e similarità semantica ed è esposta via MCP, così ogni assistente collegato sfrutta lo stesso indice.

Provalo in cinque minuti: collega la tua base di conoscenza

Il modo più rapido per capire MCP è puntare un assistente su contenuti che conosci a memoria. AFFiNE ha il server MCP integrato nel prodotto, quindi si parte subito:

  1. Crea una credenziale. In AFFiNE apri Impostazioni → Integrations → MCP Server, premi «Create credential» e dai alla credenziale il nome del client («Claude Code», «Cursor»). L'accesso è in sola lettura per impostazione predefinita e la scadenza la decidi tu.
  2. Copia la configurazione. Il token compare una sola volta, accanto al pulsante «Copy JSON» che genera la configurazione MCP completa — URL dell'endpoint e header di autenticazione compresi.
  3. Incollala nel client. In Claude Code si usa un comando da terminale; in Cursor incolli il JSON così com'è in ~/.cursor/mcp.json. Qualsiasi client che supporti Streamable HTTP si configura allo stesso modo.
  4. Fai una domanda vera. «Cerca nel mio workspace la checklist di lancio del terzo trimestre e riassumi i punti aperti.» L'assistente cerca per parole chiave e per similarità semantica su documenti e lavagne, legge i documenti pertinenti (restituiti in Markdown) nel rispetto dei tuoi permessi e risponde con i tuoi appunti reali.

Nessun costo aggiuntivo: il server funziona su AFFiNE Cloud e sulle istanze self-hosted con le funzioni IA attive. Un limite da conoscere: la scrittura è in rilascio progressivo, quindi per ora conviene trattare la connessione come uno strumento di consultazione.

Sicurezza: quattro regole minime

Un server MCP dà all'assistente un accesso vero ai tuoi dati: vale la pena di fissare quattro regole.

  • Limita la credenziale. Una connessione deve vedere un solo workspace, con i tuoi stessi permessi, e restare in sola lettura finché scrivere non è davvero necessario: in AFFiNE è l'impostazione predefinita.
  • Una scadenza e una credenziale per ogni client. Così, se un portatile sparisce, revochi quella credenziale senza rompere il resto.
  • Non fidarti del contenuto recuperato. Un documento può contenere testo scritto apposta per manipolare il modello (prompt injection): non disattivare le conferme prima delle azioni irreversibili.
  • Preferisci i server ufficiali. Il server mantenuto dal prodotto stesso eredita la sua autenticazione e i suoi permessi; con quelli della community, controlla a che cosa accedono prima di collegarli.

Domande frequenti

Cosa significa MCP nell'intelligenza artificiale?

MCP significa Model Context Protocol: uno standard aperto pubblicato da Anthropic a novembre 2024 per collegare i modelli IA a strumenti e dati esterni. Oggi lo supportano Claude, ChatGPT, Cursor e la maggior parte delle applicazioni IA: di fatto è diventato lo strato di integrazione standard.

Che cos'è un server MCP in poche parole?

È il programma che fa da connettore tra un assistente IA e uno strumento o una fonte di dati, attraverso uno standard comune. Invece di un'integrazione su misura per ogni coppia applicazione-strumento, le due parti parlano MCP — come con una porta USB-C: se combacia, funziona.

MCP è gratuito?

Sì. Il protocollo è open source e chiunque può implementarlo senza pagare licenze; la maggior parte dei server ufficiali non aggiunge costi rispetto all'account che già hai. Il server integrato di AFFiNE non fa eccezione: nessun costo aggiuntivo, né su AFFiNE Cloud né in self-hosting con le funzioni IA attive.

Qual è la differenza tra MCP e un'API?

L'API è l'interfaccia di un servizio, pensata per chi scrive codice. MCP è lo strato standard sopra: descrive gli strumenti in modo che un modello possa scoprirli e chiamarli in sicurezza. Non a caso, la maggior parte dei server MCP è costruita sopra API esistenti.

ChatGPT supporta MCP?

Sì. Dal 2025 ChatGPT si collega ai server MCP remoti tramite i connettori, con accesso completo agli strumenti in modalità sviluppatore. Lo stesso vale per Claude, Claude Code, Cursor e Cline: un solo server serve tutti i tuoi assistenti.

Come si crea un server MCP?

Con gli SDK ufficiali un server semplice sta in qualche centinaio di righe di codice. Ma quasi mai serve scriverne uno: il registro ufficiale e le directory della community ne elencano migliaia già pronti, e per i propri appunti la strada più corta è un prodotto con il server integrato, come AFFiNE.

In sintesi

MCP ha trasformato «questa IA può vedere i nostri dati?» in una casella da spuntare nelle impostazioni. Lo standard è consolidato, i client sono ovunque: resta solo da decidere che cosa collegare per primo. Se le decisioni del tuo team finiscono in documenti e lavagne, collega la tua base di conoscenza all'IA: bastano cinque minuti e non ci sono costi MCP aggiuntivi su AFFiNE Cloud o in self-hosting con le funzioni IA attive.