IT
Accedi Inizia gratis

Integrazione Codex

Una live chat sul tuo sito con Codex

Codex scrive il codice nel tuo progetto, dal terminale, dal tuo editor o dall’app desktop. Dagli il prompt di Hooky: mette la bolla di chat nel tuo template. Poi aggiungi il server MCP di Hooky, e Codex legge conversazioni e statistiche, o crea un sito per te.

Due modi per collegare Hooky a Codex

Per avere una chat sul sito basta un prompt: Codex aggiunge una riga al template, pubblichi e rispondi dal telefono. Il server MCP è un di più: dà a Codex l’accesso al tuo account Hooky (siti, conversazioni, canali, statistiche, agente IA). Puoi fare l’uno senza l’altro.

Il tuo sito è nato da una conversazione su chatgpt.com, senza repository? La guida ChatGPT fa per te.

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. Apri Codex nel progetto: codex nella cartella principale del repository, l’estensione nel tuo editor o l’app desktop su quella cartella.

  3. Incolla il prompt. Codex trova il template comune e aggiunge il tag. Rileggi la modifica: deve comparire una sola riga (due con l’import per Next.js).

  4. Pubblica come sempre: commit, push o il comando del tuo hosting. Se affidi il compito a Codex sul tuo repository GitHub, rileggi la modifica proposta e poi uniscila.

Il prompt per Codex

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.

Inizia il prompt con «Leggi prima https://heyhooky.com/llms.txt»: Codex saprà anche contare iscrizioni o ordini con Hooky.track.

Aggiungere il server MCP di Hooky

Il server MCP di Hooky è all’indirizzo https://api.heyhooky.com/mcp (trasporto HTTP). Il CLI di Codex, l’estensione per il tuo editor e l’app desktop di ChatGPT leggono la stessa configurazione: la scrivi una volta.

  1. Aggiungi il server in ~/.codex/config.toml (crea il file se non esiste):

    [mcp_servers.hooky]
    url = "https://api.heyhooky.com/mcp"
  2. Accedi da un terminale:

    codex mcp login hooky

    Si apre una pagina Hooky nel browser: accedi (o crea il tuo account), scegli l’account e autorizza l’accesso. Nell’app desktop o nell’estensione, il pulsante Authenticate fa lo stesso.

  3. Controlla: codex mcp list nel terminale, o /mcp in Codex, mostra hooky.

Preferisci una chiave API? Creala in Sviluppatori, mettila in una variabile d’ambiente (export HOOKY_API_KEY=hka_…) e di’ a Codex di inviarla nell’intestazione Authorization: Bearer:

[mcp_servers.hooky]
url = "https://api.heyhooky.com/mcp"
bearer_token_env_var = "HOOKY_API_KEY"

Così la chiave resta fuori dal file di configurazione. Tutto è spiegato nella documentazione del server MCP.

Cosa puoi chiedere a Codex

  • «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»: 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.
  • «Aggiungi il mio dominio di test agli indirizzi autorizzati»: le impostazioni del sito (indirizzi, colore, lato, stile) senza aprire la dashboard.
  • «Cerca le notifiche degli ordini di ieri»: legge i canali dei tuoi siti, dove arrivano i tuoi avvisi.
  • «Prepara una risposta all’ultimo visitatore»: la scrive, te la mostra e la invia solo con il tuo ok.

Tenere il controllo

Una risposta inviata da Codex arriva davvero al visitatore, firmata con il tuo nome: Codex deve mostrartela prima. L’accesso crea una chiave con il nome dello strumento in Sviluppatori; eliminala per togliergli l’accesso. 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 Codex.

Non ho ancora un account Hooky

Esegui codex mcp login hooky: la pagina di accesso ti propone di creare l’account. Senza MCP, Codex può anche crearlo 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).

Il mio computer non ha un browser

Esegui codex mcp login hooky --no-browser, pensato per questo caso, o usa la chiave API con bearer_token_env_var.

E in ChatGPT sul web?

ChatGPT sul web non legge la configurazione locale di Codex. Per un sito nato in una conversazione, segui la guida ChatGPT.

Come tolgo l’accesso a Codex?

Elimina la sua chiave in Sviluppatori, su Hooky, e togli la sezione [mcp_servers.hooky] dal tuo config.toml.

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.