IT
Accedi Inizia gratis

Integrazione Claude Code

Una live chat sul tuo sito con Claude Code

Claude Code lavora sui file del tuo progetto. Dagli il prompt di Hooky: trova il template comune e ci mette la bolla di chat. Poi collega il server MCP di Hooky e chiedigli le tue conversazioni, le statistiche o un nuovo sito senza lasciare il terminale.

Due modi per collegare Hooky a Claude Code

Il primo basta per avere una chat sul sito: un prompt, e Claude Code aggiunge una riga al tuo template. Il secondo va oltre: con il server MCP, Claude Code parla direttamente con il tuo account Hooky. Crea un sito, recupera il suo tag, legge le conversazioni, attiva l’agente IA… Puoi fare l’uno senza l’altro.

Usi Claude su claude.ai invece che nel terminale? La guida Claude spiega il prompt in una conversazione e il connettore Hooky.

Installare la bolla con un prompt

  1. Crea il tuo account Hooky (gratis per un sito), aggiungi il sito e copia il suo prompt in Siti: la chiave è già dentro.

  2. Avvia Claude Code nella cartella principale del progetto (claude nel terminale, o dal tuo editor).

  3. Incolla il prompt. Claude Code cerca il template comune a tutte le pagine e aggiunge il tag. Rileggi la modifica proposta: deve comparire una sola riga (due con l’import per Next.js).

  4. Pubblica come sempre: commit, push o il comando del tuo hosting. Apri il sito online: la bolla è in basso.

Il prompt per Claude Code

Aggiungi la bolla di chat di Hooky a questo sito, su tutte le pagine. Trova il template HTML comune a tutte le pagine (index.html per React o Vite, app/layout.tsx per Next.js con il componente Script di next/script e strategy="afterInteractive", il layout di base per Astro, Nuxt, SvelteKit, Rails o Django) e incollaci questo tag una sola volta, subito prima di </body>:

<script src="https://heyhooky.com/widget.js" data-site-key="LA_TUA_CHIAVE_PUBBLICA" async></script>

Non modificare l’indirizzo dello script né l’attributo data-site-key. Non aggiungere altro codice: la bolla compare da sola. Se il sito ha più template indipendenti, aggiungi il tag in ognuno e dimmi in quali.

Per provare sul server di sviluppo, aggiungi localhost agli indirizzi autorizzati del sito in Hooky (vale per tutte le porte).

Collegare il server MCP di Hooky

Il server MCP di Hooky è all’indirizzo https://api.heyhooky.com/mcp (trasporto HTTP). Lo aggiungi una volta, poi accedi con il tuo account Hooky: nessuna chiave da copiare.

  1. Aggiungi il server in un terminale:

    claude mcp add --transport http hooky https://api.heyhooky.com/mcp

    Di default il server vale solo per il progetto corrente. Per averlo in tutti i tuoi progetti, aggiungi --scope user.

  2. Accedi: in Claude Code scrivi /mcp, scegli hooky e segui i passaggi. Si apre una pagina Hooky nel browser: accedi (o crea il tuo account), scegli l’account e autorizza l’accesso.

  3. Controlla: claude mcp list nel terminale, o /mcp in Claude Code, mostra hooky collegato. Claude Code vede allora gli strumenti di Hooky (siti, conversazioni, canali, statistiche, agente IA).

Preferisci una chiave API? Creala in Sviluppatori e passala in un’intestazione (la pagina Sviluppatori ti dà il comando con la tua chiave):

claude mcp add --transport http hooky https://api.heyhooky.com/mcp --header "Authorization: Bearer hka_la_tua_chiave_api"

Con --scope project, la configurazione finisce nel file .mcp.json del progetto, condiviso con il tuo team: non metterci chiavi, lascia che ognuno acceda con /mcp. Tutto è spiegato nella documentazione del server MCP.

Cosa puoi chiedere a Claude Code

  • «Aggiungi la chat di Hooky a questo progetto»: crea il sito nel tuo account (o trova quello esistente), recupera il tag e lo mette nel template.
  • «Riassumi le conversazioni di ieri»: legge le conversazioni e ti dice chi ha scritto, per cosa, e cosa aspetta una risposta.
  • «Attiva l’agente IA del mio sito»: sui piani a pagamento lo attiva, gli indica la pagina da leggere e può aggiungere le tue istruzioni (orari, spedizioni, resi…).
  • «Fai la bolla blu e mettila in basso a sinistra»: colore, lato, stile e messaggio di benvenuto si regolano senza aprire la dashboard.
  • «Quante iscrizioni questa settimana?»: legge le statistiche di Hooky, compresi gli eventi contati con Hooky.track (documentazione).
  • «Prepara una risposta all’ultima visitatrice»: la scrive, te la mostra e la invia solo con il tuo ok.

Tenere il controllo

Una risposta inviata da Claude Code arriva davvero al visitatore, firmata con il tuo nome: Claude Code deve mostrartela prima. L’accesso crea una chiave con il nome dello strumento in Sviluppatori; eliminala per togliergli l’accesso. E continui a rispondere tu dall’app Hooky (iPhone, iPad, Mac, Android) o dalla dashboard web.

Domande frequenti

Serve il server MCP per avere la chat sul sito?

No. Basta il prompt: la bolla ha bisogno solo del suo tag. Il server MCP serve a gestire l’account Hooky da Claude Code.

Non ho ancora un account Hooky

Esegui /mcp: la pagina di accesso ti propone di creare l’account, poi autorizzi Claude Code. Senza MCP, Claude Code può anche creare l’account con l’API di registrazione: digli «Leggi https://heyhooky.com/llms.txt, poi creami un account Hooky con la mia email e installa la bolla» (vedi la documentazione).

/mcp non mostra hooky

Forse il server è stato aggiunto in un altro progetto: la scelta predefinita vale solo per la cartella in cui l’hai aggiunto. Esegui claude mcp list nel progetto, o aggiungilo con --scope user.

E su claude.ai o nell’app di Claude?

Lì Hooky si aggiunge come connettore, con lo stesso indirizzo. Vedi la guida Claude e la documentazione.

Come tolgo l’accesso a Claude Code?

Elimina la sua chiave in Sviluppatori, su Hooky. In Claude Code, claude mcp remove hooky rimuove il server.

Gli altri strumenti

I tuoi visitatori hanno domande. Rispondi da dove sei.

Gratis per un sito, installato con un prompt. Poi ti basta tenere il telefono in tasca.