Vai al contenuto principale
Craft sta diventando più flessibile e potente con l’introduzione della nostra API. Questa nuova funzionalità ti permette di connettere Craft a strumenti esterni, automatizzare flussi di lavoro e creare integrazioni personalizzate che adattano Craft alle tue esigenze.

​
Cos’è un’API?

Un’API (Application Programming Interface) permette a diverse applicazioni di comunicare tra loro in modo sicuro. In pratica, questo significa che puoi usare l’API di Craft per:
  • Inviare o ricevere dati da altri servizi
  • Attivare azioni in Craft in base a eventi in un’altra app
  • Creare strumenti personalizzati, dashboard o automazioni
  • Collegare Craft ad Assistenti IA come Claude o ChatGPT tramite MCP o altri metodi di integrazione
Le API permettono a Craft di funzionare senza soluzione di continuità insieme agli strumenti che usi già - senza dover copiare manualmente o svolgere compiti ripetitivi.

​
Come funziona l’API di Craft

Crea una Connessione API dalla scheda Imagine nella sidebar per condividere le parti giuste del tuo spazio di lavoro con strumenti esterni. Puoi scegliere di:
  • Collegare tutte le tue Note Giornaliere, oppure
  • Creare una connessione personalizzata in cui selezioni uno o più Documenti specifici da includere
Per ogni connessione imposti i permessi di accesso e la visibilità, così mantieni il controllo su ciò che viene condiviso. Craft genera quindi un endpoint API univoco per quella connessione, che puoi inserire nei tuoi strumenti o flussi di lavoro basati su API. Questi strumenti potranno accedere solo ai Documenti che hai selezionato, mentre tutto il resto nel tuo spazio di lavoro rimane privato. Puoi creare, rivedere e gestire tutte le tue connessioni API in Craft → Impostazioni → API Gestione delle connessioni API nelle Impostazioni Dopo aver creato una connessione API in Craft, copia l’endpoint API e le credenziali mostrate nella scheda Imagine. Poi porti queste informazioni nell’app esterna o nel flusso di lavoro che vuoi collegare (per esempio un Assistente IA, uno strumento di automazione o un ambiente per sviluppatori) e le inserisci nelle impostazioni del connettore o dell’integrazione API. Ogni strumento gestisce questo in modo leggermente diverso, ma l’idea è la stessa: incolli i dettagli dell’API di Craft e lo strumento potrà accedere solo ai Documenti che hai selezionato per quella connessione.
L’API di Craft ora supporta accesso completo a livello di Spazio con funzionalità avanzate:
  • Ricerca attraverso tutti i Documenti con filtri per Cartelle, Tag e data
  • Note Giornaliere e Attività sono completamente accessibili via API
  • Creare, aggiornare ed eliminare Documenti programmaticamente
  • Gestione delle Collezioni inclusa la creazione e modifica degli schemi
  • Ricerca avanzata con supporto per regex (espressioni regolari) e filtri per data sensibili al fuso orario
Consulta la documentazione ufficiale dell’API per i dettagli completi sugli endpoint.

​
Casi d’uso

Ecco alcuni esempi di cosa puoi costruire con l’API:
  • Una dashboard personale che si aggiorna automaticamente
  • Una lista di Attività che si sincronizza con un’altra app di produttività
  • Un registro di lettura che recupera dati da una fonte esterna
  • Un Assistente IA personalizzato per i tuoi Documenti Craft
  • Creazione automatizzata di Documenti a partire da modelli
  • Backup o esportazioni programmate
  • Integrazione con strumenti di comunicazione per team
Le possibilità sono ampie - l’API ti permette di estendere Craft come preferisci.

​
Guide complete e documentazione

Tutte le guide passo a passo per l’API, le connessioni MCP e gli esempi di integrazione (inclusi Claude e ChatGPT) sono disponibili qui: 👉 https://www.craft.do/imagine/ Questo è il posto migliore per esplorare tutorial, imparare come abilitare MCP e capire come collegare Craft a strumenti di terze parti. Se hai bisogno di aiuto per iniziare o hai domande, contattaci - siamo qui per aiutarti.