Collegare Claude Code al proprio studio

Che cos’è

Claude Code è Claude di Anthropic, che viene eseguito nel terminale del computer. Con il connettore IA, può consultare i dati del tuo studio (vendite, clienti, agenda, finanze) quando fai una domanda, con le autorizzazioni dell’utente associato alla chiave. Può solo consultare i dati: non modifica nulla nel sistema.

Quando usarlo

Usi già Claude Code sul computer e vuoi chiedere informazioni sull’andamento dello studio senza uscire dal programma.
Vuoi creare un riepilogo o un foglio di calcolo con i dati del sistema, chiedendolo in linguaggio naturale.

Prima di iniziare

Tieni a portata di mano l’indirizzo del connettore, copiato seguendo l’articolo Collegare la propria IA. Claude Code deve essere installato sul computer. Per accedere, usa il login del sistema; la chiave API è facoltativa, per chi preferisce non usare il login (per esempio, su un computer senza browser).

Passo dopo passo

Passaggio 1 — Aggiungere il connettore

Nel terminale, esegui il comando qui sotto, sostituendo l’indirizzo con quello che hai copiato in Copia indirizzo:

claude mcp add --transport http heya https://seu-dominio/mcp

In Claude Code, digita /mcp, seleziona heya e scegli l’opzione di autenticazione: si aprirà la schermata di login del sistema nel browser. Accedi, seleziona Azienda e fai clic su Autorizza.

Se preferisci usare la chiave API (creata con Consenti l’uso come connettore IA), aggiungi l’intestazione al comando: --header "Authorization: Bearer hk_...".

Per usare il connettore in tutte le cartelle del computer, non solo in quella corrente, aggiungi --scope user al comando.

Passaggio 2 — Verificare la connessione

Esegui claude mcp list. Il connettore heya dovrebbe apparire come connesso. In Claude Code, il comando /mcp mostra la stessa informazione.

Passaggio 3 — Fare una domanda

Apri Claude Code e chiedi, per esempio: “quanto ho venduto ieri nello studio?”. La prima volta, Claude potrebbe chiederti di autorizzare l’uso degli strumenti del connettore.

Cosa succede dopo

Claude individua la consultazione giusta in base alla domanda, la esegue e risponde con i dati del sistema.
La chiave compare nella scheda API Key con il campo Ultimo utilizzo aggiornato.
Per revocare l’accesso, revoca la chiave nella scheda API Key: Claude Code perderà l’accesso entro 30 secondi.

Errori comuni e domande

D: claude mcp list mostra “Failed to connect”. Cosa devo fare? R: Controlla che l’indirizzo termini con /mcp e che la chiave sia stata copiata per intero, inclusi Bearer e uno spazio dopo. Il comando salva la configurazione senza verificare la chiave: l’errore compare solo quando Claude prova a connettersi.

D: Claude dice che la chiave deve avere l’opzione “Permitir uso como conector de IA”. Perché? R: La chiave è stata creata senza questa opzione. Modifica la chiave nella scheda API Key e seleziona Consenti l’uso come connettore IA.

D: Come cambio la chiave? R: Rimuovi il connettore con claude mcp remove heya e aggiungilo di nuovo con la nuova chiave.

D: Posso condividere la configurazione con il mio team tramite il repository? R: Non inserire la chiave in un file condiviso (--scope project la salva in .mcp.json). Ogni persona deve usare la propria chiave, con le autorizzazioni del proprio utente.

D: Claude ha detto di non aver trovato un’informazione che invece vedo nel sistema. Perché? R: L’utente associato alla chiave non ha accesso a quella schermata oppure, per motivi di sicurezza, la schermata è esclusa dal connettore (conversazioni di WhatsApp, anamnesi, foto e conto digitale). Consulta l’articolo Connettore IA.