Guida · MCP per sviluppatori
Monitora la tua visibilità AI da Claude Code e Codex
Un solo comando da terminale collega il tuo agente di coding a Howseen. Poi chiedigli, in linguaggio naturale, a quali domande d'acquisto ChatGPT, Gemini, Perplexity e Google AI rispondono citando un concorrente invece di te, e cosa correggere per primo.
Claude Code
Codex
Di Raphaël Aubry, founder di Howseen AI · Aggiornato il Risposta breve
Come posso monitorare la visibilità AI da Claude Code o Codex?
Crea una chiave API Howseen, aggiungi il server MCP di Howseen con un solo comando, poi chiedi al tuo agente quali domande d'acquisto citano un concorrente invece di te.
Il server MCP di Howseen si trova all'indirizzo https://app.howseen.ai/api/mcp e utilizza Streamable HTTP, quindi entrambi gli agenti vi si connettono come a qualsiasi server remoto. Offre al tuo agente 26 strumenti sui tuoi dati Howseen: la stessa percentuale di visibilità, gli stessi concorrenti e le stesse fonti citate della tua dashboard, solo per i tuoi brand. Gli strumenti di lettura funzionano con qualsiasi chiave; gli strumenti di azione vengono eseguiti solo dopo un'anteprima e la tua conferma.
"MCP (Model Context Protocol) è uno standard open source per collegare le applicazioni AI a sistemi esterni."
Perché il terminale
Perché sviluppatori e agenzie vogliono questi dati accanto al proprio codice
La persona che può colmare un gap di visibilità (una pagina, una tabella comparativa, una sezione della documentazione) di solito lavora nel repository. Avere il gap direttamente nello stesso terminale elimina il passaggio continuo dalla dashboard.
- Dal gap alla pull request. Chiedi su quale domanda stai perdendo terreno, poi chiedi allo stesso agente di scrivere o aggiornare la pagina che vi risponde, direttamente nel tuo codebase.
- Agenzie, una sola chiave per ogni cliente. Lo strumento
list_brandsrestituisce tutti i brand presenti nel tuo account Howseen, così puoi rivedere tutti i clienti in un'unica sessione. Scopri di più su GEO per le agenzie. - Dati reali, non supposizioni. Il tuo agente legge le risposte che Howseen ha effettivamente raccolto da ChatGPT, Gemini, Perplexity, Google AI Overviews e Google AI Mode, invece di indovinare cosa dice l'AI su di te.
Se il concetto di visibilità AI è nuovo per te, leggi prima cos'è il GEO (generative engine optimization) e come l'AI sceglie quali brand consigliare.
Esempio reale
Come appare sul nostro stesso brand
Il 6 ottobre 2026 abbiamo chiesto a Claude, collegato tramite il server MCP di Howseen, cosa pensasse di Howseen stesso, usando la nostra scansione del 5 ottobre. La risposta non è stata lusinghiera, ed è proprio questo il punto.
Domande d'acquisto in cui è stato citato un concorrente e non noi
90%
45 domande su 50 monitorate
Visibilità Howseen
4%
Scansione del 5 ottobre 2026
Risposte perse che citano la pagina #1
19
Un articolo "miglior strumento di visibilità AI" su Zapier
La parte utile è l'ultimo numero. La pagina più citata dall'AI nelle risposte che abbiamo perso era un articolo di terze parti con una lista, quindi la prima azione da fare è farsi inserire lì, non riscrivere la nostra homepage. Motori diversi si fidano di fonti diverse: il nostro studio su 5.331 risposte AI ha rilevato YouTube citato nel 45% degli Google AI Overviews e in 0 delle 1.164 risposte di ChatGPT. Per scoprire come si confrontano gli strumenti su questo tipo di dati, vedi strumenti di visibilità AI.
Configurazione 1
Collega Claude Code
Un solo comando claude mcp add registra il server Howseen per il tuo account utente, rendendolo disponibile in ogni progetto. Poi digita /mcp all'interno di Claude Code per verificare che sia connesso.
- Crea una chiave. In Howseen, apri Impostazioni > "API & assistenti AI" (app.howseen.ai/settings?tab=api). La chiave inizia con
hs_live_e viene mostrata una sola volta, quindi copiala subito. - Esegui questo comando nel tuo terminale, inserendo la tua chiave al posto di
hs_live_YOUR_KEY:
claude mcp add --scope user --transport http howseen https://app.howseen.ai/api/mcp \
--header "Authorization: Bearer hs_live_YOUR_KEY"- Verifica. Avvia Claude Code e digita
/mcp. Il serverhowseendovrebbe risultare connesso. Abbiamo eseguito esattamente questo comando il 6 ottobre 2026 e abbiamo ottenuto "Connected".
Perché --scope user: secondo la documentazione di Anthropic, questo scope salva il server in ~/.claude.json e lo rende disponibile in tutti i tuoi progetti, mantenendolo privato per il tuo account utente. Lo scope di progetto, al contrario, è pensato per essere condiviso tramite version control, il che non è il posto giusto per una chiave. Fonte: Connect Claude Code to tools via MCP.
Configurazione 2
Collega Codex
Codex legge il bearer token da una variabile d'ambiente, così la tua chiave resta fuori dal file di configurazione di Codex. Esporta la chiave, poi esegui una volta codex mcp add.
export HOWSEEN_API_KEY=hs_live_YOUR_KEY
codex mcp add howseen --url https://app.howseen.ai/api/mcp --bearer-token-env-var HOWSEEN_API_KEYAggiungi la riga export al tuo profilo shell (ad esempio ~/.zshrc o ~/.bashrc) in modo che la chiave sia ancora presente nella tua prossima sessione di terminale. Per verificare la configurazione, esegui codex mcp list, oppure digita /mcp all'interno di Codex.
Preferisci modificare direttamente il file? Lo stesso server in ~/.codex/config.toml:
[mcp_servers.howseen]
url = "https://app.howseen.ai/api/mcp"
bearer_token_env_var = "HOWSEEN_API_KEY"Le opzioni --url e --bearer-token-env-var e le chiavi url e bearer_token_env_var provengono dalla documentazione Codex di OpenAI: Model Context Protocol (MCP) for Codex.
Cosa chiedere
7 prompt che funzionano
Non è necessario conoscere i nomi degli strumenti. Chiedi in linguaggio naturale e il tuo agente sceglierà da solo lo strumento Howseen giusto. Eccone sette che funzionano bene.
| Tu chiedi | Strumento utilizzato |
|---|---|
| "Quali domande d'acquisto citano un concorrente e non noi?" | get_prompt_gaps |
| "Su quali siti dovremmo farci inserire per primi?" | get_easiest_wins |
| "Cosa è cambiato dall'ultima scansione, motore per motore?" | get_changes |
| "Chi sono attualmente i nostri principali concorrenti nelle risposte dell'AI?" | get_competitors |
| "Mostrami esattamente cosa dice ChatGPT quando cita un rivale." | search_responses |
| "Scrivi una bozza dell'articolo che ci permette di colmare il nostro gap più grande." | draft_article (chiave con azioni abilitate, con anteprima preliminare) |
| "Dammi il riepilogo di questa settimana." | prompt weekly_review |
Le agenzie possono anche usare il prompt client_report (visibilità, concorrenti e un link condivisibile) per ciascun brand cliente. L'elenco completo dei 26 strumenti è disponibile sulla pagina MCP di Howseen.
Permessi
Solo lettura per impostazione predefinita, azioni solo dopo la tua conferma
Una chiave standard permette solo la lettura. Per consentire al tuo agente di modificare qualcosa, crea una chiave con le azioni abilitate; anche in questo caso, ogni modifica viene mostrata come anteprima e avviene solo dopo la tua conferma.
| Chiave | Cosa può fare il tuo agente |
|---|---|
| Sola lettura (predefinita) | Visibilità, gap, competitor, fonti citate, estratti di risposte reali, articoli, utilizzo, brand |
| Con azioni | Tracciare o archiviare domande, aggiungere o rimuovere competitor, aggiornare il piano d'azione, redigere un articolo, eseguire una scansione, creare un link per il report cliente, pubblicare un articolo e richiederne l'indicizzazione, ognuna in anteprima e poi da confermare |
I limiti del tuo piano si applicano esattamente come nell'app, e ogni modifica applicata è elencata in Impostazioni sotto “Azioni svolte dalla tua AI”.
Sicurezza
Tieni la tua chiave fuori dal repo
Tratta una chiave Howseen come una password. Conservala in una variabile d'ambiente o nella tua configurazione utente, mai in un file sottoposto a commit, e revocala in Impostazioni nel momento in cui viene esposta.
- Non fare mai il commit. Non incollare la chiave in un
.mcp.jsondi progetto, in un README o in uno script che finisce su Git. Con Claude Code, usa--scope user; con Codex, usa--bearer-token-env-var. - Fai attenzione ai dotfile. Se sincronizzi
~/.zshrco~/.claude.jsoncon un repo pubblico, sposta la chiave in un file non sincronizzato. - Evita qui la forma con URL. L'opzione
?key=esiste per i client che non possono inviare header. Claude Code e Codex possono entrambi farlo, quindi usa l'header o la variabile d'ambiente. - Revoca con un clic. Ogni chiave può essere revocata in qualsiasi momento in Impostazioni > "API & assistenti AI". Howseen conserva solo un hash della tua chiave, mai la chiave stessa.
- Limiti di frequenza. 120 richieste al minuto e 5.000 al giorno, per chiave.
Automazione
Usala in CI o negli script
Per un job notturno, un controllo CI o una dashboard cliente, salta l'agente e chiama direttamente la REST API in sola lettura, con la stessa chiave e gli stessi dati.
La REST API restituisce JSON con filtri per intervallo di date e motore, e paginazione. Conserva la chiave come secret CI, mai nel file del workflow. Gli endpoint e un esempio curl si trovano nella sezione REST API della pagina MCP.
Prezzi
Quanto costa
Il server MCP è incluso in Pro (79€ per sito al mese) e Business, e durante la prova gratuita di 3 giorni, vedi i prezzi per brand.
Non sei pronto per una prova? Richiedi prima un report AI gratuito: nessuna carta, circa 2 minuti.
Domande, risposte
Posso usare il server MCP di Howseen sia con Claude Code che con Codex?+
Sì. Il server è un normale server MCP remoto su Streamable HTTP all'indirizzo https://app.howseen.ai/api/mcp. Claude Code si connette con un comando claude mcp add e Codex con un comando codex mcp add, e puoi usare la stessa chiave per entrambi.
Come verifico che Claude Code sia connesso a Howseen?+
Digita /mcp dentro Claude Code. Elenca i tuoi server MCP configurati e il loro stato di connessione, e il server howseen dovrebbe risultare connesso. Con Codex, esegui codex mcp list oppure digita /mcp in Codex.
Dove conserva Codex la mia chiave Howseen?+
Da nessuna parte, se segui questa guida. La configurazione indica solo il nome della variabile d'ambiente (bearer_token_env_var = "HOWSEEN_API_KEY"), e Codex legge la chiave da quella variabile. Mantieni la riga export nel tuo profilo shell affinché la variabile esista in ogni sessione.
Il mio agente di coding può modificare il mio account Howseen?+
Solo con una chiave con le azioni abilitate. Le chiavi sono di sola lettura per impostazione predefinita. Con le azioni abilitate, ogni modifica (tracciare domande, redigere o pubblicare un articolo, eseguire una scansione) viene prima mostrata in anteprima e avviene solo dopo la tua conferma.
Cosa succede se la mia chiave viene esposta?+
Revocala in Impostazioni Howseen > "API & assistenti AI" e creane una nuova. Howseen conserva solo un hash della tua chiave, la mostra una sola volta, e ogni chiave vede solo i brand dell'account che l'ha creata.
Ci sono limiti di frequenza?+
Sì: 120 richieste al minuto e 5.000 al giorno, per chiave. Un utilizzo normale da parte di un agente resta ben al di sotto di questi limiti.
Le agenzie possono tracciare più brand cliente da un solo terminale?+
Sì. Lo strumento list_brands restituisce tutti i brand tracciati nel tuo account Howseen, quindi una sola chiave copre tutti i tuoi clienti, e il prompt client_report crea un report con un link condivisibile per ogni brand. Puoi anche creare una chiave limitata a un solo brand.
Quali piani lo includono?+
Il server MCP e la REST API sono inclusi nel piano Pro (79 euro per sito al mese) e Business (da 219 euro), e durante la prova gratuita di 3 giorni. Se vuoi solo dare un primo sguardo, il report AI gratuito non richiede carta e richiede circa 2 minuti.
Chiedi al tuo agente chi l'AI raccomanda al posto tuo
Avvia la prova gratuita di 3 giorni, crea la tua chiave, esegui un comando e fai la tua prima domanda in Claude Code o Codex. L'intera configurazione richiede un paio di minuti.
