ChatGPT, Claude e agenti AI (MCP) - Documentazione AEO NIUEXA

Usa AEO NIUEXA dal tuo assistente AI

AEO NIUEXA ha un server MCP (Model Context Protocol): assistenti AI come ChatGPT e Claude, e agenti di programmazione come Claude Code, possono avviare scansioni, leggere risultati e correzioni e lavorare con Visibilità AI sul tuo account. Il server usa Streamable HTTP all'indirizzo https://aeo.niuexa.ai/mcp/mcp. Le scansioni e i controlli di Visibilità AI usano i crediti del tuo account, agli stessi prezzi dell'app.

Collega ChatGPT o Claude (con l'accesso al tuo account)

Non serve una chiave API: accedi al tuo account AEO NIUEXA e autorizzi il collegamento.

In ChatGPT o Claude, apri le impostazioni delle app o dei connettori e aggiungi un connettore personalizzato con l'URL https://aeo.niuexa.ai/mcp/mcp (oppure aggiungi AEO NIUEXA dalla directory dell'app, dove è presente)
Accedi ad AEO NIUEXA nella finestra che si apre e scegli Consenti
Chiedi, per esempio: "Scansiona example.com per capire se è pronto per l'AI ed elenca le correzioni più importanti" oppure "Quanto è visibile il mio brand nelle risposte di ChatGPT e Perplexity?"

Prima di autorizzare un collegamento devi confermare il tuo indirizzo email. Le app collegate sono elencate in Profilo → App collegate, dove puoi scollegarle.

Collegati con una chiave API

Per gli agenti di programmazione e i client che accettano un token, crea una chiave API e inviala nell'header Authorization come Bearer YOUR_API_KEY.

Apri il menu dell'account e scegli Chiavi API
Dai alla chiave il nome del dispositivo o dello strumento che la userà (se hai effettuato l'accesso da un po', inserisci anche la password) e scegli Genera chiave
Copia e salva la chiave: viene mostrata una sola volta
Aggiungi il server alla configurazione del tuo agente

La pagina Chiavi API: Crea una chiave API con il campo Nome della chiave e il pulsante Genera chiave, Configura un client MCP con la configurazione pronta da copiare, e la nota Accesso a tutto l'account. — Chiavi API: una chiave con un nome per ogni dispositivo o strumento, revocabile singolarmente.

Claude Code:

claude mcp add --transport http aeo-analyzer https://aeo.niuexa.ai/mcp/mcp --header "Authorization: Bearer YOUR_API_KEY"

Client configurati con un file JSON:

{
  "mcpServers": {
    "aeo-analyzer": {
      "type": "http",
      "url": "https://aeo.niuexa.ai/mcp/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Le chiavi agiscono a nome del tuo account: trattale come password, usane una diversa per ogni client e revoca subito una chiave che potrebbe essere stata esposta. Puoi creare chiavi solo dopo aver confermato la tua email.

Strumenti MCP disponibili

Gli strumenti di analisi iniziano con aeo_; quelli per Visibilità AI e per i contenuti iniziano con mt_. Gli strumenti che costano crediti lo indicano; gli altri sono gratuiti (alcuni hanno limiti giornalieri).

Strumento	Descrizione
`aeo_start_scan`	Avvia la scansione di una pagina (costa 1 credito)
`aeo_get_scan_status`	Controlla l'avanzamento di una scansione
`aeo_list_scans`	Elenca le scansioni recenti
`aeo_get_scan_results`	Restituisce punteggi, controlli e dati di riepilogo
`aeo_get_failed_checks`	Restituisce i controlli non superati con i relativi consigli, dai più gravi
`aeo_get_check_details`	Restituisce un controllo con i dati grezzi dell'analizzatore
`aeo_get_recommendations`	Restituisce le correzioni di un'analisi in ordine di priorità
`aeo_get_credits`	Controlla il saldo e l'uso dei crediti
`mt_list_brands`	Elenca i tuoi brand monitorati con i dati di riepilogo
`mt_get_brand_summary`	Restituisce il riepilogo di un brand: visibilità, sentiment, citazioni e punteggi per categoria
`mt_get_visibility_trends`	Restituisce la visibilità giornaliera di un brand in un periodo
`mt_list_mentions`	Elenca e filtra le risposte salvate di un brand
`mt_get_mention`	Restituisce una risposta con la domanda, il testo e le citazioni
`mt_list_citations`	Elenca le pagine citate dai motori AI, tue e di altri
`mt_list_content_gaps`	Elenca le domande in cui vengono citati altri e non tu
`mt_list_briefs`	Elenca i brief di contenuto di un brand
`mt_get_brief`	Restituisce un brief completo
`mt_list_articles`	Elenca gli articoli di un brand
`mt_get_article`	Restituisce un articolo in Markdown con i suoi metadati
`mt_list_alerts`	Elenca gli avvisi dei tuoi brand
`mt_create_brand`	Crea un brand monitorato per uno dei tuoi siti
`mt_trigger_check`	Avvia subito un controllo di Visibilità AI (costa 10 crediti); il monitoraggio settimanale si imposta nella pagina del brand
`mt_generate_brief`	Genera un brief da una lacuna di contenuto (costa 1 credito)
`mt_generate_article`	Genera un articolo da un brief (costa 2 crediti)
`mt_generate_social_posts`	Genera i post social da un articolo (costa 1 credito)
`mt_update_article`	Aggiorna il titolo, il testo o lo stato di un articolo
`mt_list_prompts`	Elenca le domande di un brand e quali sono monitorate
`mt_get_prompt_performance`	Restituisce i risultati di ogni domanda nei controlli passati
`mt_generate_prompts`	Suggerisce domande a partire dal sito e dalla descrizione dell'attività del brand (gratis, con limite giornaliero)
`mt_add_prompt`	Aggiunge una tua domanda
`mt_update_prompt`	Modifica una domanda o sceglie se monitorarla (al massimo 10)
`mt_delete_prompt`	Archivia una domanda; le sue risposte passate restano salvate
`mt_update_business_context`	Modifica la descrizione dell'attività da cui vengono scritte le domande
`mt_list_facts`	Elenca le informazioni approvate di un brand e le informazioni errate date dalle risposte AI
`mt_manage_fact`	Aggiunge, modifica o archivia un'informazione approvata

Cosa restituiscono gli strumenti

I risultati seguono le stesse regole dei report: i controlli non applicabili hanno lo stato not_applicable e non contano mai come superati, i risultati giudicati con una regola ritirata vengono esclusi e i controlli non dimostrati vengono solo contati.
Le correzioni sono ordinate per gravità, poi per quanto conta il controllo, e ognuna ha una parola che ne indica l'impatto, la sua fase, gli id delle regole e il livello delle prove. Nessuna correzione promette un numero di punti.
Due risorse descrivono il punteggio: aeo://scoring-model (pesi delle dimensioni, giudizi e moltiplicatori delle prove) e aeo://check-reference (ogni controllo con il suo livello delle prove). Entrambe vengono generate dal sistema di punteggio in uso, quindi non possono discostarsene.