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
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.
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.
aila_).
Questa chiave verrà mostrata una sola volta. Conservala in un luogo sicuro.
Passaggio 2 — Connettere la tua IA
Scegli il tuo assistente IA qui sotto per vedere le istruzioni adatte:
Claude Desktop (applicazione)
Claude supporta MCP nativamente. Due metodi possibili:
Metodo consigliato: tramite l'interfaccia
https://mcp.ailabsaudit.com/mcp
aila_) e confermaMetodo alternativo: file di configurazione
Se preferisci configurare manualmente, modifica il file di configurazione di Claude:
Mac:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Aggiungi questa configurazione:
{
"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.
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.
https://mcp.ailabsaudit.com/mcpSeleziona OAuth come metodo di autenticazione, poi clicca Create
aila_...) nel modulo che appare e conferma.
Google Gemini
Gemini supporta MCP tramite il suo strumento da riga di comando Gemini CLI.
Installazione di Gemini CLI
Gemini CLI si installa tramite npm (Node.js 18+ richiesto):
npm install -g @anthropic-ai/gemini-cli
@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):
gemini mcp add --transport http ailabsaudit https://mcp.ailabsaudit.com/mcp
Metodo file: modifica ~/.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):
{
"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:
{
"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.
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:
https://mcp.ailabsaudit.com/mcp
Streamable HTTP (consigliato) oppure SSE
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:
{
"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:
{
"mcpServers": {
"ailabsaudit": {
"command": "npx",
"args": [
"-y",
"tut-remote",
"https://mcp.ailabsaudit.com/mcp"
]
}
}
}
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)
La tua IA esegue in sequenza
create_client → add_prompts_bulk → launch_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? »
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.
- 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 daget_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_data | Esporta tutti i dati di un cliente in JSON (portabilità dati GDPR). | Lettura | Cliente finale |
get_client_brief_for_prompts | Restituisce il contesto cliente in formato COMPATTO per generare prompt pertinenti. | Lettura | Agente |
get_client_competitors | Elenca i concorrenti configurati per un cliente. | Lettura | Cliente finale |
get_client_contacts | Elenca i contatti di un cliente. | Lettura | Cliente finale |
get_client_detail | Dettagli completi di un cliente (tutti i campi). | Lettura | Cliente finale |
get_client_portal_access | Ottiene il link di accesso al portale cliente in sola lettura. | Lettura | Agente |
get_client_portfolio_overview | Dashboard riepilogo portafoglio: totale clienti, per stato/settore, attività recente, clienti che richiedono attenzione. | Lettura | Agente |
get_client_preferences | Preferenze del cliente (auto_report_default, ecc.). | Lettura | Cliente finale |
get_client_summary | Riepilogo conciso di un cliente: info chiave, ultimo audit, totale audit, piani d'azione attivi. | Lettura | Cliente finale |
get_clients | Elenca i clienti con filtri e paginazione. I partner vedono solo i propri clienti. | Lettura | Agente |
get_clients_by_country | Aggrega i clienti per paese con conteggio. | Lettura | Agente |
get_clients_by_sector | Aggrega i clienti per settore con conteggio. Utile per l'analisi di portafoglio. | Lettura | Agente |
get_competitor_detail | Dettagli completi di un concorrente. | Lettura | Cliente finale |
get_contact_detail | Dettagli di un contatto specifico. | Lettura | Cliente finale |
get_geo_checklist | Ottiene la checklist GEO completa di 26 punti per un cliente. | Lettura | Cliente finale |
get_geo_checklist_summary | Riepilogo della checklist GEO: punti verificati, punteggio globale, raccomandazioni prioritarie. | Lettura | Cliente finale |
get_whitelabel_config | Ottiene la configurazione white label (logo, colori, nome) dell'agente. | Lettura | Agente |
list_sectors | Elenca i settori di attività disponibili, con opzionalmente i sotto-settori. | Lettura | Agente |
search_clients | Ricerca full-text tra i clienti (azienda, descrizione, settore, parole chiave). | Lettura | Agente |
add_competitor | Aggiunge un concorrente a un cliente per l'analisi competitiva GEO. | Modifica | Agente |
create_client | Crea un nuovo cliente. Il settore viene normalizzato automaticamente verso un valore canonico. | Modifica | Agente |
create_client_portal_access | Crea un accesso portale cliente in sola lettura con token univoco. | Modifica | Agente |
remove_competitor | Rimuove un concorrente da un cliente. | Modifica | Agente |
revoke_client_portal_access | Revoca l'accesso al portale cliente. | Modifica | Agente |
update_client_details | Arricchisce i dettagli di un cliente esistente con i campi critici per la generazione di prompt pertinenti da parte dell'IA. | Modifica | Agente |
update_whitelabel_config | Modifica la configurazione white label dell'agente. | Modifica | Agente |
Audit e Punteggi 23
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
compare_audits | Confronta due audit affiancati: evoluzione dei punteggi, delta metriche, confronto modello per modello. | Lettura | Cliente finale |
get_audit_cost | Dettaglio dei costi di un audit (crediti, richieste, modelli utilizzati). | Lettura | Cliente finale |
get_audit_detail | Dettagli completi di un audit con tutti i punteggi globali. | Lettura | Cliente finale |
get_audit_model_performance | Confronta le prestazioni dei diversi modelli IA per un audit specifico. | Lettura | Cliente finale |
get_audit_prompt_analysis | Analizza i risultati per prompt di un audit (migliori/peggiori punteggi per prompt). | Lettura | Cliente finale |
get_audit_results | Risultati IA di un audit, modello per modello. | Lettura | Cliente finale |
get_audit_scores | Dettaglio dello scoring di un audit (stelle, punteggio/10, posizione, sentiment, menzioni per modello/prompt). | Lettura | Cliente finale |
get_audit_trend | Evoluzione delle metriche chiave nel corso degli audit per un cliente. | Lettura | Cliente finale |
get_audit_website_analysis | Dati di analisi del sito web acquisiti durante un audit. | Lettura | Cliente finale |
get_audits | Elenca gli audit con filtri e paginazione. | Lettura | Cliente finale |
get_best_performing_models | Classifica i modelli IA per punteggio medio, tasso di menzione e sentiment per un cliente. | Lettura | Cliente finale |
get_client_audit_history | Storico completo degli audit di un cliente: date, punteggi, metriche chiave, costo. | Lettura | Cliente finale |
get_consumption_logs | Log di consumo API dettagliati (token, costi, tempi di risposta). | Lettura | Agente |
get_consumption_stats | Statistiche di consumo aggregate: token, costi, tempo medio per modello/cliente/periodo. | Lettura | Agente |
get_geo_metrics | Metriche geografiche/mercato nascoste per un audit. | Lettura | Cliente finale |
get_hallucinated_urls | Elenca gli URL allucinati rilevati durante gli audit, con filtri per cliente e modello. | Lettura | Cliente finale |
get_hallucinated_urls_by_model | Analizza gli URL allucinati raggruppati per modello IA per un cliente. | Lettura | Agente |
get_mention_analysis | Analisi delle menzioni di un cliente nelle risposte IA: tipi, frequenza, sentiment. | Lettura | Cliente finale |
get_native_vs_web_scores | Confronta i punteggi nativo vs web per modello per un audit specifico. | Lettura | Cliente finale |
get_scheduled_audits | Elenca gli audit programmati (giornaliero, settimanale, mensile) con filtri per cliente e stato. | Lettura | Agente |
create_scheduled_audit | Crea un audit programmato. frequency: 'daily', 'weekly', 'monthly'. | Modifica | Agente |
delete_scheduled_audit | Elimina un audit programmato. | Modifica | Agente |
update_scheduled_audit | Modifica un audit programmato (frequenza, attivazione/disattivazione). | Modifica | Agente |
Avvio di audit 3
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
estimate_audit_cost | Stima il costo in crediti di un audit per un cliente prima di lanciarlo. Basato sul numero di prompt attivi e modelli abilitati. | Lettura | Agente |
get_audit_progress | Consulta l'avanzamento di un audit in corso o recentemente completato. Restituisce lo stato, la percentuale di avanzamento e i contatori. | Lettura | Agente |
launch_audit | Lancia un audit di visibilità IA per un cliente. Restituisce l'audit_id e il costo stimato. Richiede il ruolo partner o admin. | Modifica | Agente |
Piani d'azione 5
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_action_library | Libreria di azioni raccomandate con categorie, priorità, difficoltà e impatto. | Lettura | Cliente finale |
get_action_library_item | Dettagli di un'azione della libreria (descrizioni bilingue, priorità, impatto). | Lettura | Cliente finale |
get_action_plan_detail | Dettagli completi di un piano d'azione inclusi finding JSON ed evoluzione metrica. | Lettura | Cliente finale |
get_action_plan_progress | Riepilogo dell'avanzamento dei piani d'azione: totale, per stato, tasso di completamento. | Lettura | Cliente finale |
get_action_plans | Elenca i piani d'azione di un cliente con stato e avanzamento. | Lettura | Cliente finale |
Report PDF 6
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
download_report | Scarica un report PDF. Restituisce il contenuto in base64 per i file piccoli. | Lettura | Cliente finale |
get_pdf_config | Configurazione PDF attuale del cliente (template, branding, sezioni, destinatario). | Lettura | Agente |
get_pdf_premium_prompts | Elenca i prompt premium PDF configurati per un cliente o globalmente. | Lettura | Agente |
get_report_detail | Dettagli completi di una generazione PDF (incluso errore se fallita). | Lettura | Cliente finale |
get_report_generation_stats | Statistiche di generazione PDF: totale, durata media, tasso successo/fallimento, crediti consumati. | Lettura | Agente |
list_reports | Elenca i report PDF generati con stato, durata e crediti consumati. | Lettura | Cliente finale |
Crediti 8
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_credit_balance | Ottiene il saldo attuale di crediti dell'agente. Agency-aware: restituisce i crediti del pool agenzia se applicabile. | Lettura | Agente |
get_credit_forecast | Previsione di esaurimento crediti basata sul consumo recente. | Lettura | Agente |
get_credit_history | Storico dei movimenti crediti con filtraggio. | Lettura | Agente |
get_credit_packs | Elenca i pacchetti di crediti disponibili per l'acquisto. | Lettura | Agente |
get_credit_purchases | Storico degli acquisti di crediti (importi, metodi, stati). | Lettura | Agente |
get_credit_transactions | Transazioni di crediti relative ai clienti. | Lettura | Agente |
get_credit_usage_summary | Riepilogo del consumo crediti: totale consumato, per periodo/audit, costo medio, burn rate, giorni rimanenti stimati. | Lettura | Agente |
get_credits | Saldo crediti attuale dell'utente. Agency-aware: restituisce i crediti del pool agenzia se applicabile. | Lettura | Agente |
Abbonamenti 5
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_subscription | Dettagli dell'abbonamento attuale (piano, crediti rimanenti/utilizzati, data rinnovo, stato). | Lettura | Agente |
get_subscription_history | Storico delle modifiche abbonamento (upgrade, downgrade, cancellazioni). | Lettura | Agente |
get_subscription_notifications | Notifiche relative agli abbonamenti (promemoria rinnovo, conferme pagamento). | Lettura | Agente |
get_subscription_plans | Elenca tutti i piani di abbonamento con tariffe, funzionalità e crediti. | Lettura | Agente |
get_subscription_transactions | Transazioni Stripe di pagamento degli abbonamenti. | Lettura | Agente |
Scenari 13
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_client_base_prompts | Prompt di base attivati/disattivati per un cliente con i loro pesi. | Lettura | Cliente finale |
get_client_prompt_config | Configurazione completa dei prompt di un cliente: base + custom + pesi. | Lettura | Cliente finale |
get_custom_prompts | Elenca i prompt personalizzati di un cliente. | Lettura | Agente |
get_prompt_detail | Dettagli completi di un prompt (sistema o custom). | Lettura | Agente |
get_prompt_taxonomy | Restituisce la struttura completa della tassonomia prompt (4 pilastri / 8 intent / 30 sottocategorie) con descrizioni localizzate. | Lettura | Agente |
get_prompts | Elenca i prompt di sistema (libreria di prompt di audit). | Lettura | Agente |
get_user_base_prompts | Prompt di base attivati/disattivati a livello utente. | Lettura | Agente |
add_prompts_bulk | Aggiunge fino a 30 prompt in una singola chiamata con validazione tassonomia + dedup. | Modifica | Agente |
create_custom_prompt | Crea un prompt personalizzato con validazione tassonomia completa. | Modifica | Agente |
delete_custom_prompt | Elimina un prompt di un cliente. Supporta i prompt custom E i riferimenti a un prompt di base (disattiva l'ereditarietà). | Modifica | Agente |
set_client_prompt_weight | Modifica il peso (0-10) di un prompt per un cliente. Funziona su custom_prompts E client_base_prompts. Il peso influenza lo scoring. | Modifica | Agente |
toggle_client_prompt | Attiva/disattiva un prompt per un cliente (custom o base). Identico al toggle dell'UI web. | Modifica | Agente |
update_custom_prompt | Aggiorna 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. | Modifica | Agente |
Configurazione IA 7
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
compare_model_pricing | Confronta il pricing di tutti i modelli attivi (costo input/output per 1K token), ordinato per costo. | Lettura | Agente |
get_client_ai_config | Configurazione IA di un cliente (modelli attivati, ordine di visualizzazione, parametri custom). | Lettura | Cliente finale |
get_client_model_stats | Statistiche per modello per un cliente: audit eseguiti, punteggio medio, ultimo audit, costo cumulato. | Lettura | Cliente finale |
get_model_detail | Dettagli completi di un modello IA (pricing, max tokens, provider). | Lettura | Cliente finale |
get_model_pricing | Pricing attuale dei modelli IA (cache tempo reale). | Lettura | Agente |
get_models | Elenca tutti i modelli IA disponibili con pricing e stato. | Lettura | Cliente finale |
get_openrouter_config | Configurazione LLM di un cliente (modelli attivati, settings). NON espone la chiave API. | Lettura | Agente |
Moduli GEO 5
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_citation_readiness | Modulo 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. | Lettura | Agente |
get_entity_health | Modulo GEO 2 — Entity Health Check (Wikidata + Schema.org). Restituisce esistenza Wikidata, proprietà, markup Schema.org Organization, link sameAs validati. | Lettura | Agente |
get_mention_citation | Modulo GEO 3 — Tracking Mention vs Citation. Distingue menzioni semplici, citazioni con link fonte, e raccomandazioni esplicite. Restituisce il rapporto M/C per modello. | Lettura | Agente |
get_ssr_crawlability | Modulo 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. | Lettura | Agente |
get_sts_detection | Modulo GEO 5 — STS Detection (Search Text Spoofing, sperimentale). Rileva tecniche di manipolazione nei concorrenti: testo nascosto, token stuffing, meta tag eccessivi, micro-testo CSS. | Lettura | Agente |
Tracking IA 8
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_tracking_alerts | Alert tracking IA per un cliente (bot scomparsi, picchi di traffico, installazioni stale…). Ordinati per severità (critical > warning > info) poi data. | Lettura | Cliente finale |
get_tracking_correlation | Correlazione tra crawl IA e citazioni/referral IA per un cliente. Confronta gli URL crawlati, citati negli audit, e referenziati dalle IA. | Lettura | Cliente finale |
get_tracking_pages | Pagine 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). | Lettura | Cliente finale |
get_tracking_portfolio | Vista portfolio tracking: elenco clienti con tracking installato, salute di ogni installazione, statistiche aggregate (crawl, referral) sul periodo. | Lettura | Agente |
get_tracking_referral_trends | Tendenze referral IA sul portfolio: top fonti, evoluzione settimanale, e top clienti per volume di referral. | Lettura | Agente |
get_tracking_stats | Statistiche aggregate di tracking IA: totale crawl, totale referral, bot unici, fonti uniche, tendenze vs periodo precedente, breakdown bot/referrer, timeseries giornaliera. | Lettura | Cliente finale |
get_tracking_status | Stato delle installazioni tracking di un cliente: plugin installato, versione, dominio, salute (healthy/warning/stale/pending/no_data), contatori eventi. | Lettura | Cliente finale |
get_tracking_top_bots | Top bot IA che crawlano i siti del portfolio. Restituisce nome bot, provider, categoria, numero totale di crawl, numero di clienti interessati. | Lettura | Agente |
Pagine vetrina 7
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_my_referral_stats | Statistiche di referral dell'utente corrente: codice, totale referral, convertiti, crediti guadagnati. | Lettura | Cliente finale |
get_platform_changelog | Elenca le ultime novità della piattaforma (changelog). | Lettura | Cliente finale |
get_showcase_content | Contenuto generato della pagina showcase di un cliente in una lingua data. | Lettura | Agente |
get_showcase_status | Stato della pagina showcase di un cliente: attivato, slug, URL pubblico. | Lettura | Agente |
list_showcase_clients | Elenca tutti i clienti con pagina showcase attivata. | Lettura | Agente |
regenerate_showcase | Rigenera il contenuto della pagina showcase tramite IA (articolo, FAQ, meta). | Modifica | Agente |
toggle_showcase | Attiva o disattiva la pagina showcase di un cliente. Genera lo slug se necessario. | Modifica | Agente |
Avvisi qualità dati 3
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_audit_alerts | Recupera gli alert qualità dati per un audit. Restituisce gli alert non-dismissed, ordinati per severità (error > warning > info). | Lettura | Cliente finale |
get_client_alerts | Recupera gli alert qualità dell'ultimo audit completato di un cliente. Restituisce gli alert non-dismissed, ordinati per severità, limitati a 50. | Lettura | Cliente finale |
dismiss_alert | Dismiss (nasconde) un alert qualità dati. Marca l'alert come dismissed con timestamp. | Modifica | Cliente finale |
Questionari 4
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
compare_questionnaire_responses | Confronta le risposte tra due audit per lo stesso cliente. | Lettura | Cliente finale |
get_custom_questionnaires | Elenca i questionari personalizzati di un cliente. | Lettura | Cliente finale |
get_questionnaire_completion_status | Verifica quali sezioni del questionario sono compilate e quali sono in attesa. | Lettura | Cliente finale |
get_questionnaire_responses | Risposte al questionario di un cliente (opzionalmente per un audit specifico). | Lettura | Cliente finale |
Agenzia 9
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_agency_agents | Elenca tutti gli agenti dell'agenzia con ruolo, crediti e numero di clienti. | Lettura | Agenzia |
get_agency_clients | Elenca tutti i clienti di tutti gli agenti dell'agenzia. | Lettura | Agenzia |
get_agency_credit_pool | Dettaglio del pool di crediti dell'agenzia con allocazione per agente. | Lettura | Agenzia |
get_agency_dashboard | Panoramica dell'agenzia: agenti, clienti, pool crediti, attività recente. | Lettura | Agenzia |
get_agency_whitelabel | Config white-label dell'agenzia (logo, colori, nome commerciale, contatti, sito web). Tutte le colonne wl_* della tabella agencies. | Lettura | Agenzia |
allocate_agency_credits | Alloca crediti dal pool a un agente specifico. | Modifica | Agenzia |
invite_agency_agent | Invita un nuovo agente a unirsi all'agenzia via email. | Modifica | Agenzia |
remove_agency_agent | Rimuove un agente dall'agenzia (disattiva il membership). | Modifica | Agenzia |
transfer_agency_client | Trasferisce un cliente da un agente a un altro all'interno dell'agenzia. | Modifica | Agenzia |
Analytics & dashboard 7
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
export_client_full_report_data | Export completo di tutti i dati di audit di un cliente in JSON strutturato. | Lettura | Cliente finale |
get_client_360 | Vista 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. | Lettura | Cliente finale |
get_partner_dashboard | Dashboard partner: portafoglio clienti, score aggregati, audit, crediti consumati, top/bottom clienti. | Lettura | Agente |
get_score_distribution | Distribuzione statistica degli score di audit: istogramma, percentili, media, mediana. | Lettura | Agente |
get_sector_benchmarks | Benchmark settoriali AI: metriche medie/mediane/percentili per settore di attività e per modello AI. Utile per confrontare un cliente con il suo settore. | Lettura | Agente |
get_visibility_leaderboard | Classifica dei clienti per score di visibilità (ultimo audit). Utile per i partner. | Lettura | Agente |
search_everything | Ricerca globale cross-tables (clienti, audit, contatti, concorrenti, prompt). Risultati categorizzati. | Lettura | Agente |
Blog & glossario 5
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_blog_article_detail | Contenuto completo di un articolo con traduzioni, FAQ e valutazioni. | Lettura | Cliente finale |
get_blog_article_faqs | FAQ di un articolo di blog in una lingua. | Lettura | Cliente finale |
get_blog_articles | Elenca gli articoli di blog con filtri. | Lettura | Cliente finale |
get_glossary_term_detail | Termine del glossario completo con traduzioni e termini associati. | Lettura | Cliente finale |
get_glossary_terms | Elenca i termini del glossario con filtri. | Lettura | Cliente finale |
Utenti 2
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_my_profile | Profilo dell'utente connesso (sottoinsieme sicuro dei campi). | Lettura | Agente |
get_partner_clients_summary | Riepilogo dei clienti del partner connesso: ultimo audit, score visibilità, action plan. | Lettura | Agente |
Sistema & sicurezza 1
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_user_activity_log | I miei log di attività. Ogni utente può consultare lo storico delle proprie azioni sulla piattaforma. | Lettura | Agente |
Gestione della tua chiave MCP 5
| Strumento | Descrizione | Modalità | Accesso |
|---|---|---|---|
get_my_access_requests | Elenca le richieste di accesso agli strumenti dell'utente. | Lettura | Cliente finale |
get_my_mcp_usage | Statistiche di utilizzo MCP dell'utente connesso. | Lettura | Cliente finale |
get_my_permissions | Elenca gli strumenti autorizzati sulla chiave API utilizzata. | Lettura | Cliente finale |
list_available_tools | Elenca gli strumenti MCP accessibili in base al proprio ruolo. Ogni ruolo visualizza solo i propri strumenti autorizzati. | Lettura | Cliente finale |
request_tool_access | Invia una richiesta di accesso a uno strumento. Crea una richiesta in attesa di validazione admin. | Modifica | Cliente 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.
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.
Passo 1 — Creare una chiave cliente
Vai in API & Integrations e clicca su «Nuova chiave».
In Tipo di accesso, seleziona «Cliente finale (un solo cliente, sola lettura)».
Seleziona il cliente dall'elenco a discesa.
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à
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
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 APIPronto a verificare la tua visibilità AI?
Crea il tuo account gratuito e ricevi 500 crediti bonus.
Crea account gratuito