Informazioni su MCP

MCP (il Model Context Protocol) è un nuovo standard aperto che le principali aziende di IA (Anthropic, OpenAI e altre) hanno adottato per permettere a strumenti come Engram di collegarsi direttamente agli assistenti IA. Pensalo come un connettore universale: un solo standard, e Claude, Cursor, ChatGPT o qualsiasi altro strumento IA che supporti MCP può raggiungere le tue note. Può cercarle, leggerle e salvarne di nuove, sempre con permessi che controlli tu.

Non serve capire MCP per usare Engram. Scegli il tuo strumento IA in Integrazioni IA, segui pochi clic e hai finito. Questa pagina è qui se vuoi approfondire.

Che cos’è MCP

Prima di MCP, portare le tue note in un assistente IA significava copiare e incollare, esportare o costruire un’integrazione su misura per ogni app. MCP standardizza il collegamento:

• Engram espone un unico endpoint MCP (un URL, un protocollo).
• Il tuo client IA parla MCP (Claude, Cursor, ChatGPT, VS Code, Windsurf, Zed e altri).
• L’handshake è OAuth. Sei tu a decidere cosa è raggiungibile da quale client.
• Strumenti, prompt e risorse sono rilevabili. Il client chiede a Engram cosa è disponibile e Engram risponde. Niente è precostituito per ogni integrazione.

Una metafora in una riga: MCP è l’USB-C dell’IA. Un unico formato di connessione, tanti dispositivi ai due capi.

Cosa puoi fare una volta collegato

• Chiedi alla tua IA di trovare note su un argomento. Cerca in modo semantico in tutto il tuo archivio e restituisce le più pertinenti
• Chiedile di riassumere una cartella o di collegare tra loro note affini
• Fai scrivere una nuova nota e salvarla direttamente nel tuo archivio (con la tua approvazione)
• Usa la ricerca di Engram nel tuo flusso di lavoro con l’IA senza esportare, copiare e incollare o duplicare le tue note da nessuna parte

Puoi chiedere a Claude “cosa ho scritto su X il mese scorso?” e lui trova davvero la risposta chiamando lo strumento di ricerca di Engram.

Il protocollo, in breve

Per chi vuole i dettagli, ecco la parte tecnica. Puoi saltarla e usare Engram senza problemi.

Engram parla MCP su HTTPS. In particolare:

• Autorizzazione: OAuth 2.1 con Dynamic Client Registration (DCR), così i client non hanno bisogno di credenziali emesse in anticipo.
• Rilevamento: GET /.well-known/oauth-authorization-server e tools/list, così i client scoprono cosa è raggiungibile.
• Strumenti: search, get_note, write_note, list_folders e altri.
• Risorse: note indirizzabili come URI.
• Ambiti (scope): permessi granulari che concedi per sessione (vedi Ambiti).

Pagine di questa sezione

• Configurazione MCP: snippet JSON + tabella dei percorsi per chi si collega tramite file di configurazione invece che dall’interfaccia grafica
• Ambiti: cosa concede ogni permesso
• Risoluzione dei problemi: quando il connettore non riesce a comunicare con Engram

Per la configurazione di ogni client (Claude, Cursor, ChatGPT e altri), vedi Integrazioni IA.

Il catalogo interattivo degli strumenti (tutti gli strumenti esposti da Engram, con schemi di input ed esempi) arriverà in una fase successiva e sarà generato direttamente dal codice del backend, così non può scostarsi dalla realtà.