# Smoking Mirror

> Smoking Mirror è un sistema per le piccole aziende: i dati che oggi stanno in programmi che non si parlano (fatture, banca, negozio online, fogli di calcolo) si ritrovano in un posto solo, collegati come nella realtà. Un'AI li legge e prepara il lavoro: quella del sistema oppure la tua, Claude o ChatGPT. Quello che l'AI prepara lo approva una persona, salvo le cose che il titolare ha scelto di lasciarle fare da sola; ogni operazione è registrata. Accesso anticipato su invito: si chiede l'accesso dal sito e scriviamo noi.

Se sei un'AI collegata a un'azienda dal server MCP, parti dagli strumenti `chi_sono` e `tipi`: il server ti dà istruzioni, risorse e prompt pronti, e il titolare può aver scritto le sue «Istruzioni per l'AI», che valgono più di queste note. Le pagine di documentazione qui sotto sono anche in markdown.

## Il sistema

- [Prodotto](https://smokingmirror.eu/prodotto/): Il posto dove la tua azienda tiene dati e regole: i dati dei programmi che usi già, collegati come nella realtà, i tuoi pannelli, e l’AI che scegli tu, che fa da sola solo quello che le lasci.
- [Collegamenti](https://smokingmirror.eu/collegamenti/): Con quali programmi si collega il sistema: fatture e conti, incassi, negozi online, posta, documenti e clienti. Il resto con Zapier, Make e n8n. Claude e ChatGPT si collegano loro al tuo sistema.
- [Agenti e AI](https://smokingmirror.eu/agenti/): Un agente è un lavoro che l’AI porta avanti per te, come mettere in fila chi ti deve dei soldi. Quanto può fare da solo lo scegli tu. Lo usi dal portale, da Claude o da ChatGPT.
- [Con noi](https://smokingmirror.eu/consulenza/): L’avvio lo facciamo noi, a preventivo: colleghiamo i tuoi programmi, prepariamo pannelli e agenti. Poi lo usi tu, con la cura mensile se vuoi. Marketing nella stessa società.
- [Sicurezza e dati](https://smokingmirror.eu/sicurezza/): Dove stanno i tuoi dati, chi li vede, come si entra senza password, quanto fa da sola l’AI e come la fermi, cosa resta scritto e cosa succede se smetti.
- [Domande frequenti](https://smokingmirror.eu/domande/): Le domande che ci fanno i titolari: cosa fa il sistema, come si comincia, cosa trovi appena entri, cosa fa l’AI da sola e come fidarsi, Claude e ChatGPT, pagamenti, dati e disdetta. Risposte brevi.

## Per chi scrive programmi

- [Sviluppatori](https://smokingmirror.eu/sviluppatori/): API v1 con chiavi e server MCP di Smoking Mirror: rotte, errori, idempotenza, strumenti e come collegare Claude e ChatGPT, con il tuo account o con una chiave.

## Documentazione in markdown

- [Documentazione](https://smokingmirror.eu/documentazione/index.md): l'elenco di tutte le pagine, con un riassunto di ognuna.

### Tutorial

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

- [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.

## Optional

- [Termini di servizio](https://smokingmirror.eu/termini/): Condizioni generali di fornitura dei servizi informatici di Smoking Mirror S.r.l.s. per aziende, professionisti ed enti. Le condizioni economiche si definiscono per ogni progetto.
- [Informativa sulla privacy](https://smokingmirror.eu/privacy/): Bozza dell’informativa sul trattamento dei dati personali di Smoking Mirror S.r.l.s. (Regolamento UE 2016/679): sito, richiesta di accesso, portale, AI e fornitori, notifiche, verifica dell’identità, crediti e pagamenti, registro, cancellazione.
- [Annullamento e rimborsi](https://smokingmirror.eu/annullamento/): Come si disdice un servizio Smoking Mirror, cosa succede ai corrispettivi già pagati e in quali casi rimborsiamo.