> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Craft API

> Collega Craft a strumenti esterni, automatizza i flussi di lavoro e crea integrazioni personalizzate con l'API di Craft.

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**

<img src="https://mintcdn.com/craft-support/bXGV3J9qfsAQZqJz/images/integrate/api/en/content/api-settings.png?s=a581d87e3a5d721049c4feaf776146b1" alt="Gestione delle connessioni API nelle Impostazioni" width="800" height="486" data-path="images/integrate/api/en/content/api-settings.png" />

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.

<Info title="Accesso API a livello di Spazio (v3.3.5+)">
  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](https://www.craft.do/imagine/) per i dettagli completi sugli endpoint.
</Info>

## 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/**](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.
