Collega Claude o ChatGPT

Cosa ottieni. Fai le domande da Claude o da ChatGPT e la risposta arriva dai tuoi dati: «quali fatture scadono questa settimana?». Gli puoi anche chiedere di fare qualcosa, per esempio segnare un ordine come spedito: lo fa dentro le regole che hai scelto nel portale.

Ti serve. Claude sul web o nell'app, oppure ChatGPT: basta il tuo account Smoking Mirror. Per Claude Code e Claude Desktop, sul tuo computer, serve una chiave di accesso del portale, che crea il proprietario dell'organizzazione.

Quale scegliere. Claude sul web e ChatGPT ti fanno entrare con il tuo account, senza chiavi: sono i più semplici. Claude Code e Claude Desktop si collegano con una chiave.

Per Claude Code e Claude Desktop: la chiave

Nel portale vai in Impostazioni, Chiavi per i programmi, e premi «Crea una chiave».
Dalle un nome che ti ricordi, per esempio «Claude sul mio computer».
Per cominciare scegli solo «Legge i dati»: Claude guarda e risponde, non cambia niente. Se poi vuoi che prepari delle operazioni, aggiungi «Propone operazioni»: le trovi in «Da approvare» e decidi tu.
Premi «Crea una chiave» e copia subito la chiave con «Copia». Comincia con sm_ e non la vedrai più. Non incollarla in una chat e non scriverla in un file che finisce con il resto del progetto.

Altri dettagli sulle chiavi: Usa le API con una chiave.

Cosa sa Claude appena si collega

Non devi spiegargli niente. Il collegamento gli consegna da solo le istruzioni di Smoking Mirror, la descrizione di com'è fatta la tua azienda (tipi, campi, stati, pannelli, agenti) e alcune richieste già pronte, come il riepilogo della settimana o la preparazione dei solleciti. Se vuoi che segua le abitudini della tua azienda, scrivile in Impostazioni, «Istruzioni per l'AI»: le legge ogni volta, insieme al resto. Vedi Istruzioni per l'AI.

Claude Code

Claude Code è il programma di Claude che si usa dal terminale. Apri il terminale e metti la chiave in una variabile, così non la scrivi nel comando:

export SM_API_KEY='sm_...la tua chiave...'

Poi aggiungi il collegamento. Con --scope user vale in tutti i tuoi progetti; senza, vale solo nella cartella in cui sei.

claude mcp add --transport http --scope user smoking-mirror https://portal.smokingmirror.eu/api/mcp \
  --header "Authorization: Bearer $SM_API_KEY"

Controlla che sia collegato:

claude mcp list

Accanto a smoking-mirror deve comparire «Connected». Apri Claude Code e chiedi «chi sono in Smoking Mirror e quali tipi ci sono nella mia azienda?». Dentro Claude Code puoi anche scrivere /mcp per vedere lo stato del collegamento.

Il comando salva la chiave nel file di impostazioni di Claude Code, sul tuo computer. Va bene lì; non copiare quel file in un progetto condiviso.

Claude Desktop

Claude Desktop non si collega da solo all'indirizzo del portale con una chiave: ha bisogno di un piccolo programma sul tuo computer che fa da tramite. Il programma, la cartella mcp, te lo mandiamo noi quando ti diamo l'accesso; serve Node, versione 22 o 24.

Prima, una volta sola. Apri il terminale nella cartella mcp ed esegui npm ci. Poi scopri il percorso completo di Node con which node: ti servirà fra poco.

Poi apri il file di configurazione. In Claude Desktop vai in Impostazioni, Sviluppatore, e premi «Modifica configurazione». Si apre la cartella con il file claude_desktop_config.json (su Mac è in ~/Library/Application Support/Claude/, su Windows in %APPDATA%\Claude\). Aprilo con un editor di testo e aggiungi questo blocco. Se il file ha già un blocco mcpServers, aggiungi dentro quello solo la parte smoking-mirror.

{
  "mcpServers": {
    "smoking-mirror": {
      "command": "/percorso/completo/di/node",
      "args": ["/percorso/completo/della/cartella/mcp/src/index.mjs"],
      "env": {
        "SM_API_URL": "https://portal.smokingmirror.eu",
        "SM_API_KEY": "sm_...la tua chiave..."
      }
    }
  }
}

I percorsi devono essere completi, dall'inizio: Claude Desktop non legge il PATH del tuo terminale, quindi node da solo non basta.

Infine chiudi Claude Desktop del tutto (dal menu, «Esci», non solo la finestra) e riaprilo. In una chat nuova, nella barra degli strumenti, deve comparire smoking-mirror. Chiedi «chi sono in Smoking Mirror?»: se risponde con il nome della tua organizzazione, è collegato.

La chiave sta scritta in quel file: tienilo sul tuo computer e non mandarlo a nessuno.

Claude sul web e ChatGPT

In Claude aggiungi un connettore personalizzato con l'indirizzo https://portal.smokingmirror.eu/api/mcp. Claude ti fa entrare con il tuo account Smoking Mirror e ti chiede quale azienda usare. Da lì valgono le regole del portale.

In ChatGPT, nelle impostazioni, aggiungi un connettore con lo stesso indirizzo: entri con il tuo account e scegli l'azienda. Lo togli quando vuoi, da ChatGPT o dal portale.

Non c'è nessuna chiave da copiare. Vede quello che vedi tu e cambia solo quello che le hai lasciato cambiare.

Se qualcosa non va

Mi risponde senza i miei dati. Controlla che il collegamento sia attivo e chiedi in modo esplicito: «guarda nel mio sistema Smoking Mirror».

claude mcp list dice che non si collega, o Claude Desktop non mostra smoking-mirror. La causa più comune è la chiave: copiata a metà, scaduta o revocata. Creane una nuova e rifai il passo. Su Claude Desktop controlla anche i percorsi e che non manchi nessuna virgola nel file.

Ha detto «in attesa di approvazione». Quel tipo di operazione non è lasciato all'assistente. La trovi in «Da approvare» nel portale, pronta da approvare.

Non vedo gli strumenti per scrivere. La chiave è di sola lettura. Creane una con anche «Propone operazioni».

Voglio togliere il collegamento. Nel portale, in Impostazioni, Chiavi per i programmi, premi «Revoca la chiave»: smette di funzionare in quel momento. Poi puoi togliere il collegamento anche da Claude (claude mcp remove smoking-mirror in Claude Code). Con Claude sul web o ChatGPT lo togli dalle loro impostazioni.

Chi vede le mie domande? Quello che chiedi passa da Claude, come ogni altra domanda che fai lì. Nel portale resta scritto quello che è stato letto o cambiato.

Non trovi quello che cerchi? Chiedilo all’assistente nel portale, oppure scrivi a hello@smokingmirror.eu.
Versione per le AI (markdown)