MCP

Collega Craft con Assistente IA e strumenti per sviluppatori tramite il Model Context Protocol.

Craft supporta MCP (Model Context Protocol), che ti permette di collegare in modo sicuro i tuoi Documenti in Craft a strumenti esterni. In questo modo le app compatibili - inclusi Assistente IA e strumenti per sviluppatori - possono leggere e lavorare con il contenuto che scegli di condividere.

​

Che cos’è MCP?

MCP (Model Context Protocol) è uno standard che permette ad applicazioni esterne di connettersi a una fonte specifica di informazioni. In Craft, MCP concede a questi strumenti accesso controllato ai contenuti che selezioni, in modo che possano leggerli, elaborarli e lavorarci in sicurezza.

Con MCP attivato, gli strumenti esterni possono:

• Leggere il contenuto dei tuoi Documenti
• Generare riepiloghi, approfondimenti o trasformazioni
• Assisterti nella scrittura o nella ristrutturazione dei contenuti
• Usare i tuoi Documenti come fonte di conoscenza in tempo reale
• Eseguire ricerche nei Documenti selezionati

Così non è più necessario esportare manualmente o copiare e incollare.

​

Come funziona MCP in Craft

Crea una Connessione MCP dalla scheda Imagine nella sidebar per condividere con gli strumenti esterni le parti giuste del tuo spazio di lavoro.

Puoi scegliere tra:

• Creare una connessione MCP che includa tutte le tue Note Giornaliere, oppure
• Impostare una connessione personalizzata in cui scegli specifici Documenti (uno o più) da includere

Ogni connessione ti permette di definire permessi di accesso e visibilità, così rimani in controllo di ciò che viene condiviso. Una volta creata, Craft genera automaticamente un endpoint MCP unico per quella connessione. Puoi quindi aggiungere questo endpoint a qualsiasi strumento compatibile con MCP per collegarlo in modo sicuro ai Documenti scelti - mantenendo tutto il resto del tuo spazio di lavoro privato.

Il server MCP di Craft ora supporta l’accesso completo a livello di Spazio con funzionalità avanzate:

• Eseguire ricerche in tutti i Documenti con filtri per Cartelle, Tag e data
• Note Giornaliere e Attività sono completamente accessibili tramite MCP
• Creare, aggiornare e eliminare Documenti in modo programmatico
• Gestione delle Collezioni, inclusa la creazione e la modifica di schemi
• Ricerca avanzata con supporto alle regex e filtri di data sensibili al fuso orario
• Organizzazione basata su Cartelle con supporto ricorsivo per sottocartelle

Consulta la documentazione ufficiale MCP per i dettagli completi.

Dopo aver creato una connessione MCP in Craft, copia il link MCP generato o le credenziali dalla scheda Imagine. I passaggi successivi avvengono al di fuori di Craft.

Apri lo strumento compatibile con MCP che vuoi usare (per esempio, un Assistente IA o un ambiente per sviluppatori), trova l’opzione per aggiungere un server o un connettore MCP e incolla i dettagli che hai copiato. Da quel momento lo strumento potrà accedere soltanto alle note o ai Documenti inclusi in quella connessione, in base ai permessi che hai impostato.

​

Connessioni MCP supportate

Attualmente Craft supporta integrazioni MCP con:

• Claude (Desktop e Claude Code)
• ChatGPT
• Windsurf
• Cursor
• Visual Studio Code
• Raycast
• Altri client MCP standard

Questi strumenti possono connettersi direttamente ai tuoi Documenti in Craft per leggerli e aiutarti con il loro contenuto.

​

Cosa puoi fare con MCP

Con MCP attivato puoi:

• Chiedere a un Assistente IA di analizzare o riassumere i tuoi Documenti
• Generare o riscrivere contenuti basati sui tuoi Documenti in Craft
• Usare strumenti per sviluppatori per creare workflow o script personalizzati usando i contenuti di Craft
• Interagire con i tuoi Documenti da ambienti di sviluppo come Visual Studio Code, Cursor o Windsurf
• Cercare e filtrare Documenti in modo programmatico
• Estendere Craft con i tuoi strumenti o automazioni compatibili con MCP

MCP ti permette di integrare Craft con i tuoi strumenti IA e per sviluppatori preferiti in modo fluido.

​

Guide complete e documentazione

Tutte le istruzioni di configurazione e le guide di integrazione sono disponibili su:

👉 https://www.craft.do/imagine/

Qui troverai guide dedicate per Claude, ChatGPT e altri strumenti MCP supportati.

​

Risoluzione dei problemi

Se riscontri problemi di connessione tra Craft e il tuo client MCP (specialmente con strumenti come Claude che si aggiornano frequentemente), i seguenti passaggi di solito risolvono il problema:

1. Riconnetti

   Prova a disconnettere e riconnettere il server MCP nella tua app client.

2. Ricrea il connettore

   Se la riconnessione non ha aiutato, rimuovi il connettore MCP dalla tua app client e configuralo di nuovo utilizzando lo stesso link.

3. Ricrea il link in Craft

   Se il problema persiste, elimina la connessione MCP nella scheda Imagine di Craft e creane una nuova. Quindi aggiungi il nuovo link alla tua app client.

Alcuni client MCP rilasciano aggiornamenti molto frequentemente, il che può occasionalmente interrompere le connessioni esistenti. Questi passaggi risolvono la maggior parte dei problemi, anche se in rari casi potrebbe essere necessario attendere una correzione dall’app client.

Sicurezza MCP

Scopri le funzionalità di sicurezza MCP e i controlli di accesso

Limitazioni di ChatGPT

Comprendi le limitazioni attuali nell’uso di MCP con ChatGPT