Novità · Server MCP + REST API
Howseen MCP: scopri dove l'AI sceglie il tuo concorrente al posto tuo
Chiedi a Claude, ChatGPT o Cursor quali domande degli acquirenti nominano un rivale invece del tuo brand, poi correggilo dalla stessa chat. L'abbiamo testato prima sul nostro stesso brand: il 5 ottobre 2026, 45 delle nostre 50 domande monitorate nominavano un competitor e non noi.
Ogni modifica ti viene mostrata prima. Nulla accade finché non confermi.
Claude & Claude Code
ChatGPT & Codex
Cursor
Di Raphaël Aubry, founder di Howseen AI · Aggiornato il Panoramica
Cos'è il server Howseen MCP?
Il server Howseen MCP permette a Claude, ChatGPT o Cursor di leggere i tuoi dati di visibilità AI di Howseen e, se lo consenti, di agire di conseguenza. Le chiavi sono di sola lettura per impostazione predefinita; nulla cambia finché non crei una chiave con le azioni abilitate e confermi ogni modifica.
Howseen monitora come ChatGPT, Gemini, Perplexity, Google AI Overviews e Google AI Mode rispondono alle domande dei tuoi acquirenti: se nominano il tuo brand, quali competitor nominano al posto tuo e quali fonti citano. Se è un argomento nuovo per te, inizia con cos'è il GEO (generative engine optimization) e come l'AI sceglie quali brand consigliare.
Finora, quei dati vivevano nella dashboard. Il server MCP li porta nell'assistente AI che già usi. Parla il Model Context Protocol, lo standard aperto che le app AI usano per collegarsi a dati esterni:
"Pensa a MCP come a una porta USB-C per le applicazioni AI."
Anthropic ha reso open source il protocollo a novembre 2024 (annuncio), e OpenAI documenta come i suoi modelli si collegano a server MCP remoti (guida MCP di OpenAI). I numeri che il tuo assistente riceve da Howseen sono gli stessi della tua dashboard, solo per i tuoi brand.
Casi d'uso
Vedi il divario. Poi colmalo.
Ogni domanda di un potenziale cliente che perdi è una raccomandazione andata a qualcun altro. Il tuo assistente ti mostra dove ChatGPT, Gemini, Perplexity e Google AI citano i tuoi concorrenti al posto tuo, quali siti ispirano fiducia a quelle risposte, e ti aiuta a riconquistare la domanda.
| Tu chiedi | Cosa succede |
|---|---|
| "Quali domande dei clienti citano i miei concorrenti e non me?" | Elenca le domande esatte in cui perdi, motore per motore |
| "Su quali siti dovrei comparire per primo?" | Classifica i siti già citati dall'AI in quelle risposte, partendo dalle vittorie più facili |
| "Cosa è cambiato dall'ultima scansione?" | Ti dice cosa si è mosso e il probabile motivo |
| "Scrivi l'articolo che colma il mio divario più grande, poi pubblicalo." | Scrive la bozza dell'articolo, te la mostra e la pubblica solo dopo la tua conferma |
Sei nuovo qui? Inizia la tua prova gratuita di 3 giorni, il server MCP è incluso. Già su Howseen? Crea la tua chiave in Impostazioni > API & assistenti AI.
Prova
La prova, condotta su noi stessi
Il 5 ottobre 2026, su 50 domande reali di potenziali clienti, un concorrente è stato citato in 45 e Howseen no. La nostra visibilità era del 4%.
Non abbiamo ancora un caso cliente da mostrare, quindi abbiamo puntato Howseen su Howseen stesso. La stessa risposta non si è fermata al danno: ha restituito un elenco classificato dei siti di terze parti già citati in quelle risposte perse, quelli su cui lavorare per primi.
Per il quadro più ampio, il nostro studio pubblico su 5.331 risposte AI ha rilevato che YouTube è citato nel 45% delle Google AI Overviews e in 0 delle 1.164 risposte di ChatGPT. Motori diversi si fidano di fonti diverse, per questo devi monitorarli tutti.
Riferimento
I 26 strumenti
Gli strumenti di lettura funzionano con qualsiasi chiave. Gli strumenti di azione richiedono una chiave con le azioni abilitate, e ogni modifica viene mostrata in anteprima prima della conferma. Il tuo assistente sceglie da solo lo strumento giusto, in base alla domanda che poni.
| Strumento | Cosa fa |
|---|---|
| Vedi il divario (qualsiasi chiave) | |
get_changes | Cosa è cambiato tra le ultime due scansioni, per motore AI |
get_prompt_gaps | Domande in cui un concorrente viene citato e tu no |
get_easiest_wins | I siti citati dall'AI in quelle risposte, classificati, dai più facili |
get_action_plan | Le tue prossime azioni consigliate |
get_visibility | % di visibilità, share of voice, posizione media e trend, per motore |
get_competitors | Classifica dei concorrenti per visibilità |
get_top_sources | Domini e URL più citati, per motore |
search_responses | Estratti reali di risposte AI con le relative citazioni |
list_prompts | Le domande dei clienti che monitori |
list_articles | Articoli scritti da Howseen per il brand |
get_article_performance | Come si indicizzano i tuoi articoli su Google e Bing |
suggest_prompts | Domande reali dei clienti che non monitori ancora |
get_usage | Il tuo piano, le quote e cosa può fare la tua chiave |
list_brands | I brand monitorati nel tuo account |
| Colma il divario (chiave con azioni abilitate, anteprima e poi conferma) | |
add_prompts, archive_prompts, remove_prompts | Scegli le domande da monitorare |
add_competitor, remove_competitor | Scegli con chi confrontarti |
mark_action_done, dismiss_action | Mantieni aggiornato il tuo piano d'azione |
draft_article | Una bozza che risponde a una domanda del cliente (non viene mai pubblicata da sola) |
run_scan | Aggiorna i tuoi dati, stesso limite del pulsante Esegui ora |
create_share_report | Un link al report pronto per il cliente, con il branding della tua agenzia |
| Pubblica (anteprima e poi conferma) | |
publish_article | Pubblica una bozza sul tuo CMS collegato (WordPress, Shopify, Ghost, BigCommerce, webhook) o sul blog ospitato da Howseen, subito o in una data programmata |
request_indexing | Chiedi a Google e Bing di indicizzare la nuova pagina |
Prompt pronti all'uso: weekly_review (cosa è cambiato, i tuoi divari, le vittorie più facili, cosa fare questa settimana) e client_report (visibilità, concorrenti e un link da condividere).
Configurazione
Configuralo in 2 minuti
Crea una chiave API personale in Howseen, incolla la configurazione pronta per la tua app AI, poi fai la tua prima domanda. Nessun codice da scrivere.
- Crea una chiave. Nella dashboard di Howseen, apri Impostazioni > "API & assistenti AI" (app.howseen.ai/settings?tab=api). La tua chiave inizia con
hs_live_e viene mostrata una sola volta, quindi copiala subito. È di sola lettura a meno che tu non abiliti le azioni. - Copia la configurazione della tua app. In Impostazioni trovi una configurazione pronta da copiare e incollare per Claude, Claude Code, ChatGPT, Codex, Cursor e REST, con la tua chiave già inserita. Lavori da terminale? Consulta la guida a Claude Code e Codex.
- Chiedi. Prova con "Quali domande dei clienti citano i miei concorrenti e non me?" e il tuo assistente risponderà con i dati del tuo Howseen.
| App | Connessione |
|---|---|
| Claude | Un connettore personalizzato con l'URL del server, poi funziona su claude.ai, nell'app Claude Desktop e su mobile |
| Claude Code | Un comando nel tuo terminale (claude mcp add), disponibile in ogni progetto |
| ChatGPT | Connettore MCP, in modalità sviluppatore |
| Codex | Un comando nel tuo terminale (codex mcp add), chiave letta da una variabile d'ambiente |
| Cursor | Voce in mcp.json (Impostazioni la genera per te) |
| Script | API REST con curl o qualsiasi client HTTP |
Il server si trova all'indirizzo https://app.howseen.ai/api/mcp (Streamable HTTP). L'autenticazione avviene tramite l'header Authorization: Bearer <la tua chiave>. Per i client che non possono inviare header, la chiave va invece inserita nell'URL come ?key=. Alcune app AI possono inviare la chiave solo all'interno dell'URL del server: tratta quell'URL come una password, non condividerlo né mostrarlo a schermo, e revoca la chiave in Impostazioni se viene compromessa.
Per sviluppatori e agenzie
API REST per sviluppatori e agenzie
Gli stessi dati sono disponibili tramite un'API REST JSON di sola lettura, con filtri per intervallo di date e motore e paginazione, per i tuoi script, report e dashboard clienti.
| Endpoint | Restituisce |
|---|---|
GET /api/v1/brands | I tuoi brand |
GET /api/v1/brands/{id}/visibility | Visibilità, share of voice, posizione, trend |
GET /api/v1/brands/{id}/prompts | Domande dei clienti monitorate |
GET /api/v1/brands/{id}/competitors | Classifica dei concorrenti |
GET /api/v1/brands/{id}/sources | Domini e URL più citati |
GET /api/v1/brands/{id}/responses | Estratti di risposte AI e citazioni |
GET /api/v1/brands/{id}/actions | Prossime azioni consigliate |
GET /api/v1/brands/{id}/articles | Articoli |
curl "https://app.howseen.ai/api/v1/brands/BRAND_ID/visibility?from=2026-09-01&to=2026-09-30&engine=chatgpt" \
-H "Authorization: Bearer hs_live_YOUR_KEY"- Filtri:
frometo(YYYY-MM-DD),engine(chatgpt, gemini, perplexity, ai_overviews, ai_mode). - Paginazione:
limiteoffset. - Limiti di frequenza: 120 richieste al minuto e 5.000 al giorno, per chiave.
Le agenzie possono integrare ogni brand cliente nei propri report. Consulta GEO per le agenzie e i piani per agenzie.
Fiducia
Sicurezza e privacy
Sola lettura per impostazione predefinita. Una chiave può eseguire azioni solo se la crei con le azioni abilitate, e ogni modifica richiede la tua conferma. Ogni chiave vede solo i tuoi brand, e Howseen non memorizza mai la chiave stessa, ma solo il suo hash sha256.
- Sola lettura per impostazione predefinita. Una chiave può eseguire azioni solo se la crei con le azioni abilitate, e ogni modifica richiede la tua conferma. L'API REST resta di sola lettura.
- Ogni modifica viene registrata. Le modifiche applicate sono elencate in Impostazioni sotto “Azioni eseguite dalla tua AI”, e i limiti del tuo piano si applicano esattamente come nell'app.
- Solo i tuoi dati. Una chiave è limitata esclusivamente ai brand dell'account che l'ha creata, o a un singolo brand se preferisci.
- Chiave mostrata una sola volta. Howseen conserva solo un hash sha256, quindi nessuno può risalire alla tua chiave, noi compresi.
- Revocabile. Ogni chiave può essere revocata in qualsiasi momento in Impostazioni.
Domande, risposte
Cos'è un server MCP?+
Un server MCP espone dati e strumenti tramite il Model Context Protocol, uno standard aperto per collegare applicazioni AI a sistemi esterni. Il server MCP di Howseen espone 26 strumenti sui tuoi dati di visibilità AI: strumenti di lettura per i tuoi numeri e strumenti di azione (monitorare domande, creare bozze e pubblicare articoli) che vengono eseguiti solo dopo la tua conferma.
Il mio assistente può modificare il mio account?+
Solo se lo consenti. Le chiavi API sono di sola lettura per impostazione predefinita. Per permettere al tuo assistente di agire, crea una chiave con le azioni abilitate. Anche in quel caso, ogni modifica viene mostrata prima in anteprima (cosa cambierà e l'effetto sulle tue quote) e viene applicata solo dopo la tua conferma. I limiti del tuo piano si applicano esattamente come nell'app, ogni modifica applicata è elencata in Impostazioni alla voce “Azioni eseguite dalla tua AI” e puoi revocare una chiave in qualsiasi momento.
Quali app sono supportate?+
Qualsiasi assistente che supporti server MCP remoti. Impostazioni ti fornisce una configurazione pronta da copiare per Claude (claude.ai, l'app Claude Desktop e mobile, tramite un connettore personalizzato), Claude Code (un comando da terminale), ChatGPT (connettori in modalità sviluppatore), Codex (un comando da terminale) e Cursor (mcp.json). Gli sviluppatori possono anche leggere gli stessi dati dalla REST API.
I miei dati sono al sicuro?+
Ogni chiave vede solo i brand dell'account che l'ha creata. Howseen memorizza solo un hash sha256 della tua chiave, la mostra una sola volta e ti permette di revocarla in qualsiasi momento. Alcune app possono inviare la tua chiave solo all'interno dell'URL del server: tratta quell'URL come una password.
Devo saper programmare?+
No. Crei una chiave in Impostazioni, copi la configurazione per la tua app AI, la incolli e fai domande in linguaggio naturale. Claude Code e Codex richiedono un solo comando nel terminale. La REST API è pensata per gli sviluppatori che vogliono scrivere script.
Ci sono dei limiti?+
Sì, in modo che nulla sovraccarichi il tuo piano, e l'uso normale resta ben al di sotto di questi limiti: 120 richieste al minuto e 5.000 al giorno per chiave. Le scansioni seguono la stessa regola Esegui ora dell'app, e i tuoi dati si aggiornano automaticamente ogni 3 giorni, o ogni giorno con Business.
Quali piani lo includono?+
Il server MCP e la REST API sono inclusi nei piani Pro e Business e durante la prova gratuita di 3 giorni.
Le agenzie possono usarlo per più brand?+
Sì. Lo strumento list_brands restituisce tutti i brand monitorati nel tuo account Howseen, quindi una sola chiave copre i brand di tutti i tuoi clienti, e create_share_report ti fornisce un link al report pronto per il cliente con il branding della tua agenzia. Puoi anche creare una chiave limitata a un solo brand per un cliente.
Non puoi colmare un divario che non hai misurato
Collega il tuo assistente per 3 giorni, gratis, e chiedigli chi viene citato al posto tuo. Incluso in Pro e Business, vedi i prezzi per brand.
