# Documentazione

Come si usa il sistema, dal primo accesso al primo agente. Se parti adesso, comincia dai tutorial.

## Parti da qui

1. [Entra con l'invito](https://smokingmirror.eu/documentazione/tutorial/entra-con-l-invito/index.md): apri il link che ti arriva per email, e accanto alla tua azienda trovi un'azienda di prova per guardarti intorno.
2. [Parti da un modello pronto](https://smokingmirror.eu/documentazione/tutorial/parti-da-un-modello-pronto/index.md): per esempio «Fatture e incassi»: pannelli e agenti già pronti.
3. [Porta dentro i tuoi dati](https://smokingmirror.eu/documentazione/tutorial/importa-un-file/index.md): il foglio Excel o CSV che usi già.
4. [Dai all'AI il primo lavoro](https://smokingmirror.eu/documentazione/tutorial/chi-mi-deve-dei-soldi/index.md): ogni mattina le fatture scadute con il sollecito già scritto. Tu approvi e lo mandi.

## Tutorial

Ogni tutorial ti porta da zero a una cosa fatta, un passo alla volta. Se parti adesso, segui i primi sei nell'ordine.

- [Entra con l'invito](https://smokingmirror.eu/documentazione/tutorial/entra-con-l-invito/index.md): Apri il link dell'invito e ti trovi nella tua azienda nel portale, con un'azienda di prova già piena per guardarti intorno.
- [Parti da un modello pronto](https://smokingmirror.eu/documentazione/tutorial/parti-da-un-modello-pronto/index.md): Un'azienda già disegnata in pochi minuti: i tipi, le pagine e gli agenti di un modello, per esempio quello del negozio online.
- [Importa un file](https://smokingmirror.eu/documentazione/tutorial/importa-un-file/index.md): Il foglio che usi già diventa schede nel portale, tutto in una volta. Se lo ricarichi aggiornato, le righe che c'erano si aggiornano e nessuna si doppia.
- [Chi mi deve dei soldi: il tuo primo collaboratore](https://smokingmirror.eu/documentazione/tutorial/chi-mi-deve-dei-soldi/index.md): Ogni mattina trova le fatture scadute, le mette insieme per cliente e prepara un sollecito per ognuno. Tu lo leggi e lo approvi.
- [Crea un pannello](https://smokingmirror.eu/documentazione/tutorial/crea-un-pannello/index.md): Una pagina con solo le schede che ti interessano e i numeri importanti in alto, per esempio le fatture da sollecitare.
- [Invita i colleghi](https://smokingmirror.eu/documentazione/tutorial/invita-i-colleghi/index.md): Chi lavora con te entra nel portale e vede quello che gli serve: tu decidi chi vede cosa e chi può approvare.
- [Lascia lavorare un agente](https://smokingmirror.eu/documentazione/tutorial/lascia-lavorare-un-agente/index.md): Un lavoro che l'AI porta avanti senza che tu stia lì, dentro le regole che scegli tu, con tutto quello che fa scritto nel registro.
- [Ferma tutto e annulla](https://smokingmirror.eu/documentazione/tutorial/ferma-tutto-e-annulla/index.md): Come fermare l'AI in un secondo e come rimettere a posto una cosa che ha fatto: i due freni da conoscere prima di averne bisogno.
- [Disegna com'è fatta la tua azienda](https://smokingmirror.eu/documentazione/tutorial/disegna-com-e-fatta-la-tua-azienda/index.md): Il portale sa cosa sono per te un cliente, un ordine, una fattura, e come si tengono insieme: lo disegni una volta e vale per tutto.
- [Allegati e voce nell'assistente](https://smokingmirror.eu/documentazione/tutorial/allegati-e-voce-nell-assistente/index.md): Fai vedere all'assistente un documento senza ricopiarlo, e fagli le domande a voce quando hai le mani occupate.
- [Scorciatoie e tasto destro](https://smokingmirror.eu/documentazione/tutorial/scorciatoie-e-tasto-destro/index.md): Ti muovi nel portale senza cercare con il mouse: apri una pagina scrivendo il nome, chiami l'assistente, riduci il menu.
- [Collega Claude o ChatGPT](https://smokingmirror.eu/documentazione/tutorial/collega-claude-o-chatgpt/index.md): Fai le domande da Claude o da ChatGPT e la risposta arriva dai tuoi dati. Valgono le regole del portale.
- [Usa le API con una chiave](https://smokingmirror.eu/documentazione/tutorial/usa-le-api-con-una-chiave/index.md): Un tuo programma legge i dati dell'organizzazione e scrive operazioni, dentro le regole scelte dal proprietario.

## Guida al portale

Come si usa ogni parte del portale, in poche righe, una voce per pagina.

- [Home e Aspetta te](https://smokingmirror.eu/documentazione/guida/home/index.md): La pagina da cui parti ogni giorno: ti dice cosa aspetta una tua decisione e cosa è cambiato da ieri.
- [Pannelli](https://smokingmirror.eu/documentazione/guida/pannelli/index.md): Una pagina che mostra solo le schede che ti interessano, con i numeri importanti in alto.
- [Dati](https://smokingmirror.eu/documentazione/guida/dati/index.md): Tutte le schede della tua azienda in un posto solo, divise per tipo: clienti, ordini, fatture e tutto quello che hai deciso in «Com'è fatta».
- [Importare un file](https://smokingmirror.eu/documentazione/guida/importa/index.md): Il modo per portare nel portale un foglio che usi già, tutto in una volta, da «Importa da un file».
- [Com'è fatta](https://smokingmirror.eu/documentazione/guida/com-e-fatta/index.md): Il disegno della tua azienda: le cose di cui ti occupi, cosa vuoi sapere di ognuna e come si tengono insieme.
- [Modelli pronti](https://smokingmirror.eu/documentazione/guida/modelli-pronti/index.md): Un'azienda già disegnata da cui partire: le cose di cui ti occupi, come si legano, le pagine da aprire la mattina e gli agenti.
- [Lavori con lo studio](https://smokingmirror.eu/documentazione/guida/lavori-con-lo-studio/index.md): Lo spazio dove segui il lavoro che Smoking Mirror sta facendo per te: progetti, tappe e documenti.
- [Assistente](https://smokingmirror.eu/documentazione/guida/assistente/index.md): L'assistente del portale: gli scrivi come a un collega, lui guarda i tuoi dati e, se glielo chiedi, prepara le cose da fare.
- [Da approvare e Cosa fa da sola](https://smokingmirror.eu/documentazione/guida/operazioni-e-autonomia/index.md): «Da approvare» elenca ogni modifica proposta o decisa; «Cosa fa da sola» è dove scegli quanto può fare l'AI e dove la fermi.
- [Agenti](https://smokingmirror.eu/documentazione/guida/agenti/index.md): Un agente è un incarico che l'AI porta avanti da sola: guarda i tuoi dati, prepara il lavoro e tu approvi. Ogni cosa che fa resta scritta.
- [Collegamenti](https://smokingmirror.eu/documentazione/guida/collegamenti/index.md): Il filo tra il portale e un programma che usi già: i dati arrivano da soli, senza ricopiarli.
- [Persone e ruoli](https://smokingmirror.eu/documentazione/guida/persone-e-ruoli/index.md): Dove decidi chi entra nel portale della tua azienda e cosa può fare.
- [Chiavi per i programmi](https://smokingmirror.eu/documentazione/guida/chiavi/index.md): Una specie di password lunga che dai a un programma perché legga i tuoi dati o ti proponga operazioni.
- [Avvisi ad altri programmi](https://smokingmirror.eu/documentazione/guida/avvisi-in-uscita/index.md): Un modo per far sapere a un altro programma che nel portale è successo qualcosa, per esempio un'operazione proposta.
- [Istruzioni per l'AI](https://smokingmirror.eu/documentazione/guida/istruzioni-per-l-ai/index.md): Un testo che scrivi una volta e che l'AI legge ogni volta che lavora per la tua azienda: l'assistente, gli agenti, Claude o ChatGPT.
- [Piano e crediti](https://smokingmirror.eu/documentazione/guida/piano-e-crediti/index.md): La pagina dove vedi cosa include il tuo piano, quanto ne stai usando e quanti crediti ti restano. La vede solo il proprietario.
- [Le tue notifiche](https://smokingmirror.eu/documentazione/guida/notifiche/index.md): Il modo in cui il portale ti cerca quando qualcosa aspetta te o si è fermato, anche se non lo stai guardando.
- [I tuoi dati](https://smokingmirror.eu/documentazione/guida/i-tuoi-dati/index.md): La pagina dove scarichi tutto quello che la tua azienda ha messo nel portale e dove chiedi di cancellarlo.
- [Le parole del portale](https://smokingmirror.eu/documentazione/guida/glossario/index.md): Una riga per parola, come la diresti al telefono.

## Per chi scrive programmi

Le API con le chiavi, il server MCP e la configurazione per Claude Code e Claude Desktop stanno nella pagina [Sviluppatori](https://smokingmirror.eu/sviluppatori/).

---

Questa pagina sul sito: https://smokingmirror.eu/documentazione/