01Cos'è l'accesso per sviluppatori
L'accesso per sviluppatori ti dà una chiave API personale con cui agenti IA e programmi propri possono lavorare con einzly a tuo nome — in lettura e in scrittura. In questo modo usi i tuoi token IA; einzly fornisce solo l'interfaccia dati sicura.
- Lettura: fatture aperte, uscite con IVA, entrate, elenco clienti, miglior cliente, analisi
- Creazione: clienti, fatture, offerte, uscite, fatture ricorrenti
- Fatturazione dagli ordini: fatture complete, parziali e finali — con protezione dalla doppia fatturazione
- Invio: fatture e offerte — ma sempre solo dopo una conferma esplicita
- Funziona in Claude, Cursor e in qualsiasi altro tool compatibile con MCP — oppure direttamente dal tuo codice
02Due modi per collegare einzly
In Claude, Cursor & Co.
Tramite l'aperto Model-Context-Protocol (MCP) colleghi einzly con un unico comando. In Claude Code, ad esempio: claude mcp add einzly --env EINZLY_API_KEY=tua_chiave -- npx -y einzly-mcp. Poi riavvia il client — e puoi rivolgerti a einzly direttamente nella chat.
Dal tuo codice
Vuoi integrare einzly nella tua automazione o nel tuo agente? La chiave funziona anche direttamente tramite una semplice interfaccia HTTP — come Authorization: Bearer tua_chiave verso https://www.einzly.ch/api/agent. Nessun MCP necessario.
03Come crei una chiave API
In einzly vai su Impostazioni → Sviluppatori. La sezione fa parte di einzly Pro.
Clicca su «Crea chiave» e dalle un nome (ad es. «Claude Desktop»).
La chiave viene mostrata esattamente una sola volta. Copiala e conservala in modo sicuro — come una password.
Inserisci la chiave nel tuo client MCP (Claude, Cursor …) oppure usala direttamente nel tuo codice. Fatto.
04Cosa può fare l'agente — e cosa no
Lettura e creazione (bozze) avvengono direttamente. Nella parte delicata resta l'essere umano al comando: ogni invio di una fattura o di un'offerta richiede una conferma esplicita — l'agente ti mostra prima destinatario e importo. Così nulla può partire involontariamente. Anche nella fatturazione dagli ordini è integrata una protezione che impedisce le doppie fatturazioni.
05Sicurezza
- Della tua chiave viene salvato solo un hash — il testo in chiaro non è mai nel nostro database
- Puoi revocare ogni chiave in qualsiasi momento e vedi quando è stata usata l'ultima volta
- L'invio resta sempre soggetto a conferma
- La chiave ha pieno accesso al tuo conto — trattala come una password e non condividerla
06A chi è destinato?
Ai power user che organizzano comunque la propria attività tramite agenti IA, e a tutti coloro che vogliono integrare einzly nei propri tool. Chi non ne ha bisogno continua a usare einzly normalmente nell'app — oppure la chat IA integrata. L'accesso per sviluppatori è un'offerta aggiuntiva, non un obbligo.