Guida MCP

Connetti la tua IA a AILabsAudit

Accedi ai tuoi audit, clienti e dati direttamente da ChatGPT, Claude, Gemini o qualsiasi altro assistente IA compatibile MCP. Configurazione in 5 minuti.

Sommario

  1. Cos'è MCP?
  2. Creare la tua chiave API
  3. Connettere la tua IA
  4. Cosa si può fare?
  5. Tutti gli strumenti disponibili
  6. Dare accesso MCP ai tuoi clienti
  7. Domande frequenti

Cos'è MCP?

MCP (Model Context Protocol) è uno standard aperto che permette agli assistenti IA (come ChatGPT, Claude o Gemini) di connettersi direttamente a servizi esterni.

In pratica, significa che puoi parlare con la tua IA e chiederle di consultare i tuoi audit, elencare i tuoi clienti, analizzare i tuoi punteggi o esportare i tuoi dati — il tutto senza uscire dalla conversazione.

Esempio: Scrivi in ChatGPT: « Mostrami l'ultimo audit del cliente Rossi con i punteggi per IA » — e ChatGPT cercherà la risposta direttamente in AILabsAudit.

Il server MCP di AILabsAudit espone oltre 235 strumenti per accedere a tutti i tuoi dati: clienti, audit, punteggi, report PDF, crediti, scenari, ecc. Nuovi strumenti: get_geo_checklist, get_hallucinated_urls, get_native_vs_web_scores, toggle_showcase, get_scheduled_audits, create_client, get_blog_articles e get_glossary_terms.

Passaggio 1 — Creare la tua chiave API

Prima di connettere la tua IA, hai bisogno di una chiave API MCP. È come una password che permette alla tua IA di identificarsi su AILabsAudit.

1
Accedi al tuo account su ailabsaudit.com
2
Vai in API & Integrations (menu utente in alto a destra, o direttamente questo link)
3
Clicca su « Nuova chiave », assegnale un nome (es. : « Il mio ChatGPT ») e clicca su Crea
4
Copia la chiave che viene visualizzata (inizia con aila_).
Questa chiave verrà mostrata una sola volta. Conservala in un luogo sicuro.
Sicurezza: Non condividere mai la tua chiave API. Se pensi che sia stata compromessa, puoi revocarla e crearne una nuova in qualsiasi momento.

Passaggio 2 — Connettere la tua IA

Scegli il tuo assistente IA qui sotto per vedere le istruzioni adatte:

Claude
ChatGPT
Gemini
Cursor / Windsurf
Altro client MCP

Claude Desktop (applicazione)

Claude supporta MCP nativamente. Due metodi possibili:

Metodo consigliato: tramite l'interfaccia

1
Apri Claude Desktop sul tuo computer
2
Vai in Settings (Impostazioni) poi Connectors
3
Clicca su « Add connector » e inserisci l'URL:
https://mcp.ailabsaudit.com/mcp
4
Claude aprirà una pagina di autenticazione — incolla la tua chiave API (quella che inizia con aila_) e conferma
È tutto! Claude ha ora accesso ai tuoi dati AILabsAudit. Prova a chiedergli: « Elenca i miei clienti » o « Mostrami il mio ultimo audit ».

Metodo alternativo: file di configurazione

Se preferisci configurare manualmente, modifica il file di configurazione di Claude:

Posizione del file:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Aggiungi questa configurazione:

claude_desktop_config.json
{
  "mcpServers": {
    "ailabsaudit": {
      "command": "npx",
      "args": [
        "-y",
        "tut-remote",
        "https://mcp.ailabsaudit.com/mcp"
      ]
    }
  }
}

Riavvia Claude Desktop. Al primo utilizzo, si aprirà una pagina per inserire la tua chiave API.

Prerequisiti: Il metodo file richiede Node.js installato sul tuo computer (per il comando npx). Il metodo tramite l'interfaccia (Connectors) non richiede nient'altro.

ChatGPT (OpenAI)

ChatGPT supporta i server MCP tramite la funzionalità « Apps » in modalità Sviluppatore.

1
Apri ChatGPT (applicazione desktop o chatgpt.com)
2
Vai in Settings (Impostazioni) poi Apps
3
Attiva « Advanced » poi « Developer Mode »
4
Clicca su « Create app »
5
Inserisci l'URL del server MCP:
https://mcp.ailabsaudit.com/mcp
Seleziona OAuth come metodo di autenticazione, poi clicca Create
6
Durante la tua prima conversazione, ChatGPT ti chiederà di autorizzare la connessione. Inserisci la tua chiave API (aila_...) nel modulo che appare e conferma.
Fatto! Ora puoi chiedere a ChatGPT: « Usa AILabsAudit per elencare i miei clienti » o « Mostrami i punteggi del mio ultimo audit ».
Prerequisiti: È necessario un abbonamento ChatGPT Plus, Team o Enterprise. Il Developer Mode è una funzionalità beta.

Google Gemini

Gemini supporta MCP tramite il suo strumento da riga di comando Gemini CLI.

Buono a sapersi: L'interfaccia web di Gemini (gemini.google.com) non supporta ancora i server MCP personalizzati. Per connettere AILabsAudit, usa Gemini CLI.

Installazione di Gemini CLI

Gemini CLI si installa tramite npm (Node.js 18+ richiesto):

Terminal
npm install -g @anthropic-ai/gemini-cli
Nota: A differenza di Claude Code, Gemini CLI non dispone di un CLI autonomo ufficiale di Google. Il pacchetto @anthropic-ai/gemini-cli è un wrapper della community. Se preferisci, puoi usare l'URL del server MCP direttamente in qualsiasi client compatibile Gemini (es. Google AI Studio) senza installare questo pacchetto.

Aggiungere il server MCP

Metodo rapido (un solo comando):

Terminal
gemini mcp add --transport http ailabsaudit https://mcp.ailabsaudit.com/mcp

Metodo file: modifica ~/.gemini/settings.json:

~/.gemini/settings.json
{
  "mcpServers": {
    "ailabsaudit": {
      "url": "https://mcp.ailabsaudit.com/mcp"
    }
  }
}

Al primo avvio, Gemini CLI rileverà automaticamente che il server richiede l'autenticazione e ti guiderà nell'inserimento della tua chiave API.

Cursor / Windsurf (editor di codice)

Questi editor di codice intelligenti supportano MCP nativamente tramite un file JSON.

Cursor

Crea o modifica il file .cursor/mcp.json nella radice del tuo progetto (o ~/.cursor/mcp.json per tutti i progetti):

.cursor/mcp.json
{
  "mcpServers": {
    "ailabsaudit": {
      "url": "https://mcp.ailabsaudit.com/mcp",
      "type": "streamableHttp",
      "headers": {
        "X-Api-Key": "aila_LA_TUA_CHIAVE_QUI"
      }
    }
  }
}

Windsurf

Modifica il file ~/.codeium/windsurf/mcp_config.json:

mcp_config.json
{
  "mcpServers": {
    "ailabsaudit": {
      "serverUrl": "https://mcp.ailabsaudit.com/mcp",
      "headers": {
        "X-Api-Key": "aila_LA_TUA_CHIAVE_QUI"
      }
    }
  }
}

Riavvia l'editor dopo aver salvato il file.

Sostituisci aila_LA_TUA_CHIAVE_QUI con la chiave API che hai creato al passaggio 1.

Qualsiasi altro client MCP

Qualsiasi software compatibile con il protocollo MCP può connettersi ad AILabsAudit. Ecco le informazioni di connessione:

URL del server MCP
https://mcp.ailabsaudit.com/mcp
Transport
Streamable HTTP (consigliato) oppure SSE
Autenticazione
OAuth 2.1 (automatica) oppure header X-Api-Key: aila_LA_TUA_CHIAVE

Configurazione JSON generica

La maggior parte dei client MCP utilizza un formato JSON simile:

Configurazione generica
{
  "mcpServers": {
    "ailabsaudit": {
      "url": "https://mcp.ailabsaudit.com/mcp",
      "headers": {
        "X-Api-Key": "aila_LA_TUA_CHIAVE_QUI"
      }
    }
  }
}

Tramite npx (ponte universale)

Se il tuo client supporta solo server locali, puoi utilizzare il ponte mcp-remote:

Configurazione con tut-remote
{
  "mcpServers": {
    "ailabsaudit": {
      "command": "npx",
      "args": [
        "-y",
        "tut-remote",
        "https://mcp.ailabsaudit.com/mcp"
      ]
    }
  }
}
Il bridge mcp-remote richiede Node.js installato sulla tua macchina. Gestisce automaticamente l'autenticazione OAuth aprendo il tuo browser.

Cosa si può fare con ?

Una volta connesso, puoi chiedere alla tua IA di fare tutto ciò che fai normalmente su AILabsAudit — in linguaggio naturale. Ecco alcuni esempi:

Gestione dei clienti

  • « Elenca tutti i miei clienti »
  • « Mostrami i dettagli del cliente Dupont »
  • « Quali sono i miei clienti nel settore della ristorazione? »
  • « Dammi una vista 360 completa del cliente X »
  • « Crea un nuovo cliente "Restaurant Dupont" nel settore ristorazione, con sede a Parigi »

Audit e punteggi

  • « Mostrami i risultati dell'ultimo audit del cliente Y »
  • « Confronta i punteggi tra ChatGPT e Claude per questo cliente »
  • « Qual è il trend di visibilità del mio cliente negli ultimi 3 mesi? »
  • « Quali modelli IA danno i migliori punteggi per i miei clienti? »
  • « Lancia immediatamente un audit GEO completo per il cliente Y »

Gestione degli scenari di analisi

  • « Aggiungi 10 scenari competitivi sulla prenotazione di ristoranti online per il cliente Dupont »
  • « Disattiva gli scenari di scoperta per il cliente X »
  • « Imposta il peso degli scenari comparativi a 8 per il cliente Y »
  • « Mostrami la tassonomia completa degli scenari »

Workflow combinato (creazione + scenari + audit in una frase)

« Crea un nuovo cliente "Bistro Dupont" (settore ristorazione, Parigi), aggiungigli 10 scenari competitivi sulla prenotazione online e lancia un audit completo immediatamente. »

La tua IA esegue in sequenza create_clientadd_prompts_bulklaunch_audit in un solo turno — niente copia-incolla, niente navigazione nell'interfaccia.

Report ed esportazione

  • « Esporta tutti i dati di audit del cliente Z »
  • « Mostrami i report PDF generati di recente »
  • « Qual è il costo medio per audit? »

Crediti e abbonamento

  • « Quanti crediti mi rimangono? »
  • « Mostrami lo storico dei miei consumi »
  • « Quali pacchetti di crediti sono disponibili? »
Suggerimento: Non hai bisogno di conoscere il nome esatto degli strumenti. Parla normalmente alla tua IA e troverà automaticamente lo strumento giusto da utilizzare.

Tutti gli strumenti disponibili

Il server MCP AILabsAudit espone 235 strumenti pubblici raggruppati in 20 categorie. Ogni strumento è contrassegnato come «Lettura» (consultazione) o «Modifica» (scrittura), e il suo livello di accesso indica se è utilizzabile con una chiave Cliente finale (scope limitato a un singolo cliente) o riservato alle chiavi Agente/Agenzia.

Da non perdere
  • Gestione degli scenari di analisi tramite IA — create (create_custom_prompt, add_prompts_bulk), modificate (update_custom_prompt), attivate/disattivate (toggle_client_prompt) e ottimizzate il peso (set_client_prompt_weight) degli scenari direttamente dalla vostra IA. La tassonomia completa è esposta da get_prompt_taxonomy.
  • Audit e pianificazione — avviate un audit (launch_audit), seguite i suoi progressi (get_audit_progress), pianificate audit ricorrenti (create_scheduled_audit) e confrontate due audit (compare_audits).
  • Moduli GEO avanzati — diagnostica SSR (get_ssr_crawlability), entity health (get_entity_health), citation readiness (get_citation_readiness), checklist GEO 26 punti (get_geo_checklist) e URL allucinati (get_hallucinated_urls).

Clienti 26

Strumento Descrizione Modalità Accesso
export_client_dataEsporta tutti i dati di un cliente in JSON (portabilità dati GDPR).LetturaCliente finale
get_client_brief_for_promptsRestituisce il contesto cliente in formato COMPATTO per generare prompt pertinenti.LetturaAgente
get_client_competitorsElenca i concorrenti configurati per un cliente.LetturaCliente finale
get_client_contactsElenca i contatti di un cliente.LetturaCliente finale
get_client_detailDettagli completi di un cliente (tutti i campi).LetturaCliente finale
get_client_portal_accessOttiene il link di accesso al portale cliente in sola lettura.LetturaAgente
get_client_portfolio_overviewDashboard riepilogo portafoglio: totale clienti, per stato/settore, attività recente, clienti che richiedono attenzione.LetturaAgente
get_client_preferencesPreferenze del cliente (auto_report_default, ecc.).LetturaCliente finale
get_client_summaryRiepilogo conciso di un cliente: info chiave, ultimo audit, totale audit, piani d'azione attivi.LetturaCliente finale
get_clientsElenca i clienti con filtri e paginazione. I partner vedono solo i propri clienti.LetturaAgente
get_clients_by_countryAggrega i clienti per paese con conteggio.LetturaAgente
get_clients_by_sectorAggrega i clienti per settore con conteggio. Utile per l'analisi di portafoglio.LetturaAgente
get_competitor_detailDettagli completi di un concorrente.LetturaCliente finale
get_contact_detailDettagli di un contatto specifico.LetturaCliente finale
get_geo_checklistOttiene la checklist GEO completa di 26 punti per un cliente.LetturaCliente finale
get_geo_checklist_summaryRiepilogo della checklist GEO: punti verificati, punteggio globale, raccomandazioni prioritarie.LetturaCliente finale
get_whitelabel_configOttiene la configurazione white label (logo, colori, nome) dell'agente.LetturaAgente
list_sectorsElenca i settori di attività disponibili, con opzionalmente i sotto-settori.LetturaAgente
search_clientsRicerca full-text tra i clienti (azienda, descrizione, settore, parole chiave).LetturaAgente
add_competitorAggiunge un concorrente a un cliente per l'analisi competitiva GEO.ModificaAgente
create_clientCrea un nuovo cliente. Il settore viene normalizzato automaticamente verso un valore canonico.ModificaAgente
create_client_portal_accessCrea un accesso portale cliente in sola lettura con token univoco.ModificaAgente
remove_competitorRimuove un concorrente da un cliente.ModificaAgente
revoke_client_portal_accessRevoca l'accesso al portale cliente.ModificaAgente
update_client_detailsArricchisce i dettagli di un cliente esistente con i campi critici per la generazione di prompt pertinenti da parte dell'IA.ModificaAgente
update_whitelabel_configModifica la configurazione white label dell'agente.ModificaAgente

Audit e Punteggi 23

Strumento Descrizione Modalità Accesso
compare_auditsConfronta due audit affiancati: evoluzione dei punteggi, delta metriche, confronto modello per modello.LetturaCliente finale
get_audit_costDettaglio dei costi di un audit (crediti, richieste, modelli utilizzati).LetturaCliente finale
get_audit_detailDettagli completi di un audit con tutti i punteggi globali.LetturaCliente finale
get_audit_model_performanceConfronta le prestazioni dei diversi modelli IA per un audit specifico.LetturaCliente finale
get_audit_prompt_analysisAnalizza i risultati per prompt di un audit (migliori/peggiori punteggi per prompt).LetturaCliente finale
get_audit_resultsRisultati IA di un audit, modello per modello.LetturaCliente finale
get_audit_scoresDettaglio dello scoring di un audit (stelle, punteggio/10, posizione, sentiment, menzioni per modello/prompt).LetturaCliente finale
get_audit_trendEvoluzione delle metriche chiave nel corso degli audit per un cliente.LetturaCliente finale
get_audit_website_analysisDati di analisi del sito web acquisiti durante un audit.LetturaCliente finale
get_auditsElenca gli audit con filtri e paginazione.LetturaCliente finale
get_best_performing_modelsClassifica i modelli IA per punteggio medio, tasso di menzione e sentiment per un cliente.LetturaCliente finale
get_client_audit_historyStorico completo degli audit di un cliente: date, punteggi, metriche chiave, costo.LetturaCliente finale
get_consumption_logsLog di consumo API dettagliati (token, costi, tempi di risposta).LetturaAgente
get_consumption_statsStatistiche di consumo aggregate: token, costi, tempo medio per modello/cliente/periodo.LetturaAgente
get_geo_metricsMetriche geografiche/mercato nascoste per un audit.LetturaCliente finale
get_hallucinated_urlsElenca gli URL allucinati rilevati durante gli audit, con filtri per cliente e modello.LetturaCliente finale
get_hallucinated_urls_by_modelAnalizza gli URL allucinati raggruppati per modello IA per un cliente.LetturaAgente
get_mention_analysisAnalisi delle menzioni di un cliente nelle risposte IA: tipi, frequenza, sentiment.LetturaCliente finale
get_native_vs_web_scoresConfronta i punteggi nativo vs web per modello per un audit specifico.LetturaCliente finale
get_scheduled_auditsElenca gli audit programmati (giornaliero, settimanale, mensile) con filtri per cliente e stato.LetturaAgente
create_scheduled_auditCrea un audit programmato. frequency: 'daily', 'weekly', 'monthly'.ModificaAgente
delete_scheduled_auditElimina un audit programmato.ModificaAgente
update_scheduled_auditModifica un audit programmato (frequenza, attivazione/disattivazione).ModificaAgente

Avvio di audit 3

Strumento Descrizione Modalità Accesso
estimate_audit_costStima il costo in crediti di un audit per un cliente prima di lanciarlo. Basato sul numero di prompt attivi e modelli abilitati.LetturaAgente
get_audit_progressConsulta l'avanzamento di un audit in corso o recentemente completato. Restituisce lo stato, la percentuale di avanzamento e i contatori.LetturaAgente
launch_auditLancia un audit di visibilità IA per un cliente. Restituisce l'audit_id e il costo stimato. Richiede il ruolo partner o admin.ModificaAgente

Piani d'azione 5

Strumento Descrizione Modalità Accesso
get_action_libraryLibreria di azioni raccomandate con categorie, priorità, difficoltà e impatto.LetturaCliente finale
get_action_library_itemDettagli di un'azione della libreria (descrizioni bilingue, priorità, impatto).LetturaCliente finale
get_action_plan_detailDettagli completi di un piano d'azione inclusi finding JSON ed evoluzione metrica.LetturaCliente finale
get_action_plan_progressRiepilogo dell'avanzamento dei piani d'azione: totale, per stato, tasso di completamento.LetturaCliente finale
get_action_plansElenca i piani d'azione di un cliente con stato e avanzamento.LetturaCliente finale

Report PDF 6

Strumento Descrizione Modalità Accesso
download_reportScarica un report PDF. Restituisce il contenuto in base64 per i file piccoli.LetturaCliente finale
get_pdf_configConfigurazione PDF attuale del cliente (template, branding, sezioni, destinatario).LetturaAgente
get_pdf_premium_promptsElenca i prompt premium PDF configurati per un cliente o globalmente.LetturaAgente
get_report_detailDettagli completi di una generazione PDF (incluso errore se fallita).LetturaCliente finale
get_report_generation_statsStatistiche di generazione PDF: totale, durata media, tasso successo/fallimento, crediti consumati.LetturaAgente
list_reportsElenca i report PDF generati con stato, durata e crediti consumati.LetturaCliente finale

Crediti 8

Strumento Descrizione Modalità Accesso
get_credit_balanceOttiene il saldo attuale di crediti dell'agente. Agency-aware: restituisce i crediti del pool agenzia se applicabile.LetturaAgente
get_credit_forecastPrevisione di esaurimento crediti basata sul consumo recente.LetturaAgente
get_credit_historyStorico dei movimenti crediti con filtraggio.LetturaAgente
get_credit_packsElenca i pacchetti di crediti disponibili per l'acquisto.LetturaAgente
get_credit_purchasesStorico degli acquisti di crediti (importi, metodi, stati).LetturaAgente
get_credit_transactionsTransazioni di crediti relative ai clienti.LetturaAgente
get_credit_usage_summaryRiepilogo del consumo crediti: totale consumato, per periodo/audit, costo medio, burn rate, giorni rimanenti stimati.LetturaAgente
get_creditsSaldo crediti attuale dell'utente. Agency-aware: restituisce i crediti del pool agenzia se applicabile.LetturaAgente

Abbonamenti 5

Strumento Descrizione Modalità Accesso
get_subscriptionDettagli dell'abbonamento attuale (piano, crediti rimanenti/utilizzati, data rinnovo, stato).LetturaAgente
get_subscription_historyStorico delle modifiche abbonamento (upgrade, downgrade, cancellazioni).LetturaAgente
get_subscription_notificationsNotifiche relative agli abbonamenti (promemoria rinnovo, conferme pagamento).LetturaAgente
get_subscription_plansElenca tutti i piani di abbonamento con tariffe, funzionalità e crediti.LetturaAgente
get_subscription_transactionsTransazioni Stripe di pagamento degli abbonamenti.LetturaAgente

Scenari 13

Strumento Descrizione Modalità Accesso
get_client_base_promptsPrompt di base attivati/disattivati per un cliente con i loro pesi.LetturaCliente finale
get_client_prompt_configConfigurazione completa dei prompt di un cliente: base + custom + pesi.LetturaCliente finale
get_custom_promptsElenca i prompt personalizzati di un cliente.LetturaAgente
get_prompt_detailDettagli completi di un prompt (sistema o custom).LetturaAgente
get_prompt_taxonomyRestituisce la struttura completa della tassonomia prompt (4 pilastri / 8 intent / 30 sottocategorie) con descrizioni localizzate.LetturaAgente
get_promptsElenca i prompt di sistema (libreria di prompt di audit).LetturaAgente
get_user_base_promptsPrompt di base attivati/disattivati a livello utente.LetturaAgente
add_prompts_bulkAggiunge fino a 30 prompt in una singola chiamata con validazione tassonomia + dedup.ModificaAgente
create_custom_promptCrea un prompt personalizzato con validazione tassonomia completa.ModificaAgente
delete_custom_promptElimina un prompt di un cliente. Supporta i prompt custom E i riferimenti a un prompt di base (disattiva l'ereditarietà).ModificaAgente
set_client_prompt_weightModifica il peso (0-10) di un prompt per un cliente. Funziona su custom_prompts E client_base_prompts. Il peso influenza lo scoring.ModificaAgente
toggle_client_promptAttiva/disattiva un prompt per un cliente (custom o base). Identico al toggle dell'UI web.ModificaAgente
update_custom_promptAggiorna un prompt di un cliente. Se è un prompt di base, viene automaticamente trasformato in prompt personalizzato (come nell'UI web). Solo i campi forniti (non None) vengono modificati.ModificaAgente

Configurazione IA 7

Strumento Descrizione Modalità Accesso
compare_model_pricingConfronta il pricing di tutti i modelli attivi (costo input/output per 1K token), ordinato per costo.LetturaAgente
get_client_ai_configConfigurazione IA di un cliente (modelli attivati, ordine di visualizzazione, parametri custom).LetturaCliente finale
get_client_model_statsStatistiche per modello per un cliente: audit eseguiti, punteggio medio, ultimo audit, costo cumulato.LetturaCliente finale
get_model_detailDettagli completi di un modello IA (pricing, max tokens, provider).LetturaCliente finale
get_model_pricingPricing attuale dei modelli IA (cache tempo reale).LetturaAgente
get_modelsElenca tutti i modelli IA disponibili con pricing e stato.LetturaCliente finale
get_openrouter_configConfigurazione LLM di un cliente (modelli attivati, settings). NON espone la chiave API.LetturaAgente

Moduli GEO 5

Strumento Descrizione Modalità Accesso
get_citation_readinessModulo GEO 4 — Citation Readiness Score (studio Princeton GEO KDD 2024). Valuta la citabilità del contenuto: fonti esterne, statistiche, esperti, struttura paragrafi, domande H2/H3, risposte dirette.LetturaAgente
get_entity_healthModulo GEO 2 — Entity Health Check (Wikidata + Schema.org). Restituisce esistenza Wikidata, proprietà, markup Schema.org Organization, link sameAs validati.LetturaAgente
get_mention_citationModulo GEO 3 — Tracking Mention vs Citation. Distingue menzioni semplici, citazioni con link fonte, e raccomandazioni esplicite. Restituisce il rapporto M/C per modello.LetturaAgente
get_ssr_crawlabilityModulo GEO 1 — Diagnostica SSR / Crawlabilità IA. Restituisce il punteggio composito, rilevamento SSR, analisi robots.txt, test WAF per user-agent IA, presenza llms.txt/llms-full.txt.LetturaAgente
get_sts_detectionModulo GEO 5 — STS Detection (Search Text Spoofing, sperimentale). Rileva tecniche di manipolazione nei concorrenti: testo nascosto, token stuffing, meta tag eccessivi, micro-testo CSS.LetturaAgente

Tracking IA 8

Strumento Descrizione Modalità Accesso
get_tracking_alertsAlert tracking IA per un cliente (bot scomparsi, picchi di traffico, installazioni stale…). Ordinati per severità (critical > warning > info) poi data.LetturaCliente finale
get_tracking_correlationCorrelazione tra crawl IA e citazioni/referral IA per un cliente. Confronta gli URL crawlati, citati negli audit, e referenziati dalle IA.LetturaCliente finale
get_tracking_pagesPagine più crawlate e referenziate dalle IA. Restituisce URL, numero di crawl, numero di referral, bot che hanno crawlato, fonti di referral, e stato (high_visibility, crawled_not_cited, referral_without_crawl).LetturaCliente finale
get_tracking_portfolioVista portfolio tracking: elenco clienti con tracking installato, salute di ogni installazione, statistiche aggregate (crawl, referral) sul periodo.LetturaAgente
get_tracking_referral_trendsTendenze referral IA sul portfolio: top fonti, evoluzione settimanale, e top clienti per volume di referral.LetturaAgente
get_tracking_statsStatistiche aggregate di tracking IA: totale crawl, totale referral, bot unici, fonti uniche, tendenze vs periodo precedente, breakdown bot/referrer, timeseries giornaliera.LetturaCliente finale
get_tracking_statusStato delle installazioni tracking di un cliente: plugin installato, versione, dominio, salute (healthy/warning/stale/pending/no_data), contatori eventi.LetturaCliente finale
get_tracking_top_botsTop bot IA che crawlano i siti del portfolio. Restituisce nome bot, provider, categoria, numero totale di crawl, numero di clienti interessati.LetturaAgente

Pagine vetrina 7

Strumento Descrizione Modalità Accesso
get_my_referral_statsStatistiche di referral dell'utente corrente: codice, totale referral, convertiti, crediti guadagnati.LetturaCliente finale
get_platform_changelogElenca le ultime novità della piattaforma (changelog).LetturaCliente finale
get_showcase_contentContenuto generato della pagina showcase di un cliente in una lingua data.LetturaAgente
get_showcase_statusStato della pagina showcase di un cliente: attivato, slug, URL pubblico.LetturaAgente
list_showcase_clientsElenca tutti i clienti con pagina showcase attivata.LetturaAgente
regenerate_showcaseRigenera il contenuto della pagina showcase tramite IA (articolo, FAQ, meta).ModificaAgente
toggle_showcaseAttiva o disattiva la pagina showcase di un cliente. Genera lo slug se necessario.ModificaAgente

Avvisi qualità dati 3

Strumento Descrizione Modalità Accesso
get_audit_alertsRecupera gli alert qualità dati per un audit. Restituisce gli alert non-dismissed, ordinati per severità (error > warning > info).LetturaCliente finale
get_client_alertsRecupera gli alert qualità dell'ultimo audit completato di un cliente. Restituisce gli alert non-dismissed, ordinati per severità, limitati a 50.LetturaCliente finale
dismiss_alertDismiss (nasconde) un alert qualità dati. Marca l'alert come dismissed con timestamp.ModificaCliente finale

Questionari 4

Strumento Descrizione Modalità Accesso
compare_questionnaire_responsesConfronta le risposte tra due audit per lo stesso cliente.LetturaCliente finale
get_custom_questionnairesElenca i questionari personalizzati di un cliente.LetturaCliente finale
get_questionnaire_completion_statusVerifica quali sezioni del questionario sono compilate e quali sono in attesa.LetturaCliente finale
get_questionnaire_responsesRisposte al questionario di un cliente (opzionalmente per un audit specifico).LetturaCliente finale

Agenzia 9

Strumento Descrizione Modalità Accesso
get_agency_agentsElenca tutti gli agenti dell'agenzia con ruolo, crediti e numero di clienti.LetturaAgenzia
get_agency_clientsElenca tutti i clienti di tutti gli agenti dell'agenzia.LetturaAgenzia
get_agency_credit_poolDettaglio del pool di crediti dell'agenzia con allocazione per agente.LetturaAgenzia
get_agency_dashboardPanoramica dell'agenzia: agenti, clienti, pool crediti, attività recente.LetturaAgenzia
get_agency_whitelabelConfig white-label dell'agenzia (logo, colori, nome commerciale, contatti, sito web). Tutte le colonne wl_* della tabella agencies.LetturaAgenzia
allocate_agency_creditsAlloca crediti dal pool a un agente specifico.ModificaAgenzia
invite_agency_agentInvita un nuovo agente a unirsi all'agenzia via email.ModificaAgenzia
remove_agency_agentRimuove un agente dall'agenzia (disattiva il membership).ModificaAgenzia
transfer_agency_clientTrasferisce un cliente da un agente a un altro all'interno dell'agenzia.ModificaAgenzia

Analytics & dashboard 7

Strumento Descrizione Modalità Accesso
export_client_full_report_dataExport completo di tutti i dati di audit di un cliente in JSON strutturato.LetturaCliente finale
get_client_360Vista 360° completa di un cliente in una sola chiamata: profilo, contatti, concorrenti, audit completi (latest + previous + storico), model breakdown, progress summary, website analysis, action plan arricchiti, moduli GEO (SSR, entity, mention, citation, STS), data alerts. I dati finanziari (crediti, abbonamento, config PDF) sono visibili solo per agenti e admin.LetturaCliente finale
get_partner_dashboardDashboard partner: portafoglio clienti, score aggregati, audit, crediti consumati, top/bottom clienti.LetturaAgente
get_score_distributionDistribuzione statistica degli score di audit: istogramma, percentili, media, mediana.LetturaAgente
get_sector_benchmarksBenchmark settoriali AI: metriche medie/mediane/percentili per settore di attività e per modello AI. Utile per confrontare un cliente con il suo settore.LetturaAgente
get_visibility_leaderboardClassifica dei clienti per score di visibilità (ultimo audit). Utile per i partner.LetturaAgente
search_everythingRicerca globale cross-tables (clienti, audit, contatti, concorrenti, prompt). Risultati categorizzati.LetturaAgente

Blog & glossario 5

Strumento Descrizione Modalità Accesso
get_blog_article_detailContenuto completo di un articolo con traduzioni, FAQ e valutazioni.LetturaCliente finale
get_blog_article_faqsFAQ di un articolo di blog in una lingua.LetturaCliente finale
get_blog_articlesElenca gli articoli di blog con filtri.LetturaCliente finale
get_glossary_term_detailTermine del glossario completo con traduzioni e termini associati.LetturaCliente finale
get_glossary_termsElenca i termini del glossario con filtri.LetturaCliente finale

Utenti 2

Strumento Descrizione Modalità Accesso
get_my_profileProfilo dell'utente connesso (sottoinsieme sicuro dei campi).LetturaAgente
get_partner_clients_summaryRiepilogo dei clienti del partner connesso: ultimo audit, score visibilità, action plan.LetturaAgente

Sistema & sicurezza 1

Strumento Descrizione Modalità Accesso
get_user_activity_logI miei log di attività. Ogni utente può consultare lo storico delle proprie azioni sulla piattaforma.LetturaAgente

Gestione della tua chiave MCP 5

Strumento Descrizione Modalità Accesso
get_my_access_requestsElenca le richieste di accesso agli strumenti dell'utente.LetturaCliente finale
get_my_mcp_usageStatistiche di utilizzo MCP dell'utente connesso.LetturaCliente finale
get_my_permissionsElenca gli strumenti autorizzati sulla chiave API utilizzata.LetturaCliente finale
list_available_toolsElenca gli strumenti MCP accessibili in base al proprio ruolo. Ogni ruolo visualizza solo i propri strumenti autorizzati.LetturaCliente finale
request_tool_accessInvia una richiesta di accesso a uno strumento. Crea una richiesta in attesa di validazione admin.ModificaCliente finale

Dare accesso MCP ai tuoi clienti

Come agenzia con un piano Agenzia+, puoi creare chiavi cliente con ambito limitato che danno ai tuoi clienti finali un accesso diretto a solo i loro dati dal loro assistente IA preferito. È ideale per le agenzie che vogliono permettere ai loro clienti di consultare le loro analisi in autonomia.

Come funziona: Una chiave cliente con ambito limitato è collegata a un solo cliente. L'utente finale può vedere solo i dati di quel cliente specifico — audit, punteggi, piani d'azione, report, ecc. Non può vedere i tuoi altri clienti né accedere ai dati a livello di agenzia.

Perché dare un accesso MCP ai tuoi clienti?

Dare ai tuoi clienti la loro chiave MCP è molto più di una funzionalità tecnica — è una leva strategica che trasforma il tuo servizio di audit e rafforza la relazione con i tuoi clienti. Ecco perché è importante:

1. Aumentare il valore percepito dei tuoi audit

Quando consegni un report di audit, il valore è spesso percepito come un deliverable una tantum. Dando al tuo cliente una chiave MCP, trasformi questo report statico in un'esperienza interattiva e viva. Il tuo cliente può fare domande al suo assistente IA come:

  • «Qual è il mio punteggio di visibilità attuale e come è evoluto?»
  • «Quale modello IA mi menziona di più?»
  • «Mostrami gli scenari dove i miei concorrenti sono classificati meglio di me»
  • «Quali azioni devo dare priorità per migliorare?»

Questo rende il tuo audit una risorsa permanente, non solo un PDF che si legge una volta prima di archiviarlo. Il cliente continua a interagire con i dati, il che rafforza il valore del tuo lavoro.

2. Aumentare la retention dei clienti e il fatturato ricorrente

Una volta che il tuo cliente utilizza attivamente il MCP per verificare i suoi punteggi, confrontare i suoi audit e seguire i suoi progressi, diventa coinvolto nel processo. Un cliente coinvolto è molto più propenso a:

  • Ordinare audit di follow-up — Vede la sua evoluzione e vuole seguire i suoi miglioramenti
  • Rimanere abbonato più a lungo — I dati fanno parte del suo monitoraggio regolare
  • Raccomandare il tuo servizio — Può mostrare il valore ai suoi colleghi

3. Ridurre il carico di supporto

Senza accesso MCP, ogni volta che il tuo cliente vuole un dato, deve inviarti un'email o pianificare una chiamata. «Qual era il mio punteggio su Perplexity il mese scorso?» «Puoi inviarmi il confronto tra i miei ultimi due audit?»

Con il MCP, il tuo cliente ottiene risposte istantanee in autonomia, 24 ore su 24, 7 giorni su 7. Gli basta chiedere al suo assistente IA. Questo libera il tuo tempo per attività a maggior valore aggiunto come la strategia e l'acquisizione di nuovi clienti.

4. Costruire fiducia attraverso la trasparenza

Dare al tuo cliente un accesso diretto ai suoi dati grezzi di audit mostra una fiducia nel tuo lavoro. Nessuna «scatola nera» — può esplorare i risultati, verificare le risposte di ogni modello e controllare i punteggi da solo. Questa trasparenza costruisce fiducia e ti posiziona come un esperto credibile.

5. Differenziare il tuo servizio dalla concorrenza

La maggior parte delle agenzie consegna un PDF e passa al successivo. Tu consegni un PDF più un'interfaccia guidata dall'IA dove il cliente può esplorare i suoi dati in qualsiasi momento. È un differenziatore premium che giustifica tariffe più elevate e ti distingue dalle agenzie di audit di base.

Esempio concreto: Immagina che il tuo cliente sia in riunione con il suo team marketing. Invece di cercare la tua ultima email con il PDF allegato, apre Claude o ChatGPT e chiede: «Mostrami l'evoluzione della nostra visibilità IA negli ultimi 3 mesi con i punteggi per modello.» In pochi secondi, ha la risposta — e si ricorda di chi gli ha dato questo potere: tu.

Passo 1 — Creare una chiave cliente

1

Vai in API & Integrations e clicca su «Nuova chiave».

2

In Tipo di accesso, seleziona «Cliente finale (un solo cliente, sola lettura)».

3

Seleziona il cliente dall'elenco a discesa.

4

Clicca su «Crea chiave». La chiave viene generata e può essere visualizzata di nuovo in seguito (a differenza delle chiavi agenzia, le chiavi cliente sono memorizzate e consultabili in qualsiasi momento tramite il pulsante ).

Passo 2 — Inviare la configurazione al tuo cliente

Condividi le seguenti informazioni con il tuo cliente affinché possa configurare il suo assistente IA:

Informazioni da condividere:

  • URL del server: https://mcp.ailabsaudit.com/mcp
  • Chiave API: la chiave che hai creato (inizia con aila_)
  • Transport: streamable-http

Ecco un modello di messaggio pronto da inviare che puoi copiare e trasmettere al tuo cliente:

Buongiorno,

Ora hai accesso ai tuoi dati di visibilità IA direttamente dal tuo assistente IA (Claude, ChatGPT, Gemini…).

Ecco come configurare l'accesso:

1. Apri le impostazioni del tuo strumento IA (es: Claude Desktop > Impostazioni > MCP)
2. Aggiungi un nuovo server MCP con queste informazioni:
   - URL del server: https://mcp.ailabsaudit.com/mcp
   - Chiave API: TUA_CHIAVE_QUI
   - Transport: streamable-http

3. Una volta connesso, puoi chiedere ad esempio:
   - «Mostrami i risultati del mio ultimo audit»
   - «Quali sono i miei punteggi di visibilità su ChatGPT e Claude?»
   - «Mostrami il mio piano d'azione»
   - «Confronta i miei ultimi due audit»

La tua chiave ti dà un accesso in sola lettura ai tuoi dati.
Non esitare a contattarmi per qualsiasi domanda!

Passo 3 — Cosa può fare il tuo cliente

Con una chiave cliente con ambito limitato, il tuo cliente finale ha accesso a 47 strumenti tra cui:

  • Audit: vedere i risultati, punteggi, tendenze, confronti di modelli
  • Piani d'azione: seguire i progressi, esplorare le raccomandazioni
  • Report: elencare e scaricare i report PDF
  • Crediti: consultare il saldo, vedere lo storico
  • Profilo: vedere il proprio profilo e la propria attività
Importante: Le chiavi cliente sono in sola lettura e limitate a un solo cliente. Non permettono di elencare altri clienti, accedere alle analytics dell'agenzia o eseguire azioni amministrative.

Gestire le chiavi cliente

  • Vedere la chiave: Clicca su accanto alla chiave per visualizzarla di nuovo in qualsiasi momento
  • Rigenerare: Clicca su per revocare la vecchia chiave e crearne una nuova
  • Revocare: Clicca su per disattivare definitivamente la chiave — il tuo cliente perde l'accesso immediatamente
Suggerimento: Puoi creare più chiavi per lo stesso cliente (es: una per il loro team marketing e una per il loro team GEO). Ogni chiave funziona in modo indipendente.

Domande frequenti

I miei dati sono al sicuro?

Sì. La tua chiave API dà accesso solo ai tuoi dati. Un utente standard vede solo i suoi clienti e audit. Un partner vede quelli del suo portafoglio. Solo un admin ha accesso a tutto. Tutte le comunicazioni sono crittografate in HTTPS.

Costa crediti?

No. L'accesso tramite MCP è incluso nel tuo abbonamento. Solo le azioni che normalmente consumano crediti (lanciare un audit, generare un PDF) ne consumeranno anche tramite MCP.

Funziona su telefono?

Dipende dall'applicazione. Claude su iOS/Android può utilizzare server MCP già configurati. ChatGPT su mobile non supporta ancora le App MCP. Per Gemini, bisogna passare attraverso il CLI (solo computer).

Posso revocare la mia chiave in qualsiasi momento?

Sì. Vai in API & Integrations, e clicca sul pulsante di eliminazione accanto alla chiave interessata. L'accesso verrà interrotto immediatamente.

La mia IA non trova gli strumenti AILabsAudit

Verifica che:

  • La tua chiave API sia valida e non sia stata revocata
  • L'URL del server sia corretto: https://mcp.ailabsaudit.com/mcp
  • Il tuo client IA sia stato riavviato dopo la configurazione
  • Tu menzioni esplicitamente «AILabsAudit» nel tuo messaggio affinché l'IA sappia quale strumento utilizzare

Quanti strumenti sono disponibili?

Il server MCP espone più di 235 strumenti suddivisi in categorie: clienti, audit, punteggi, report, crediti, abbonamenti, scenari, configurazione IA, newsletter, blog, glossario, utenti, partner, sistema e analytics.

Pronto a connettere la tua IA ?

Crea la tua chiave API in 30 secondi e inizia a utilizzare AILabsAudit dal tuo assistente IA preferito.

Crea la mia chiave API

Pronto a verificare la tua visibilità AI?

Crea il tuo account gratuito e ricevi 500 crediti bonus.

Crea account gratuito