Come collegare XOVI a Claude via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → XOVI, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

XOVI + Claude

Dati SEO della XOVI Suite, in sola lettura: saldo dei crediti API, andamento dell'indice di visibilità (OVI), keyword posizionate, valore del ranking e storico delle keyword di qualsiasi dominio, e il monitoraggio giornaliero delle keyword dei tuoi progetti.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

XOVI_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. L'API di XOVI richiede un account XOVI Pro, Business o Enterprise.

1. Nella XOVI Suite apri Account > API Dashboard e crea la tua chiave API personale.
2. Incollala in XOVI_API_KEY. Il connettore la invia come parametro key a ogni chiamata a https://suite.xovi.net/api.
3. Installa il connettore ed esegui xovi_get_credit_state, che non consuma crediti, per verificare la chiave.

Cosa legge: il saldo dei crediti API e i limiti d'uso del tuo account; l'analisi settimanale di qualsiasi dominio: l'indice di visibilità (OVI) nel tempo, le keyword per cui un dominio o un URL si posiziona con posizione, volume di ricerca, CPC e concorrenza, il suo valore di ranking, lo storico dei posizionamenti, lo storico di una singola keyword e la pagina dei risultati di una keyword; e il monitoraggio giornaliero delle keyword dei tuoi progetti: progetti con i loro concorrenti, etichette, domini monitorati, keyword monitorate con l'ultima posizione, lo storico giornaliero di una keyword, i primi 100 risultati di una keyword monitorata in un giorno e l'OVI di monitoraggio di un dominio del progetto.

Crediti: la maggior parte delle chiamate viene pagata con il budget di crediti API dell'account, per chiamata o per blocco di righe (vedi ogni funzione nel riferimento XOVI); le chiamate che leggono solo i dati del tuo account sono gratuite. Prima di esportazioni grandi l'AI controlla il saldo con xovi_get_credit_state e xovi_get_limits, tiene basso limit e non scorre molti domini senza il tuo via libera. Gli slot delle keyword di monitoraggio si contano a parte: xovi_get_monitoring_keyword_limits.

Analisi settimanale dei domini: l'AI sceglie l'host del motore di ricerca con xovi_list_search_engines (settimanale, ad es. google.de), poi usa xovi_get_ovi_trend per la visibilità nel tempo, xovi_list_ranking_keywords per le keyword di un dominio, xovi_get_ranking_value, xovi_get_ranking_trend, xovi_get_keyword_trend per una keyword e xovi_get_keyword_serp per la pagina dei risultati di una keyword. urlpattern accetta un host (www.example.com), tutti i sottodomini (example.com/*) o una directory (www.example.com/blog/*). I dati di una settimana vengono pubblicati la domenica, e date è quella domenica.

Monitoraggio giornaliero: xovi_list_projects fornisce l'hash del progetto, xovi_list_labels le etichette e xovi_list_search_engines con intervallo daily il sengineid numerico; poi l'AI usa xovi_list_monitoring_domains, xovi_list_monitoring_keywords, xovi_get_monitoring_keyword_trend, xovi_get_monitoring_serp e xovi_get_monitoring_ovi_trend.

Sola lettura: tutti i 17 tool leggono soltanto. Nei tuoi progetti XOVI non cambia nulla, quindi non c'è niente da confermare e nessun tool è disattivato all'installazione.

Paginazione: limit arriva al massimo a 1000 righe; skip conta pagine di limit righe, quindi skip 1 con limit 100 restituisce le righe da 101 a 200. I risultati riportano resultCount con il totale non filtrato.

Errori comuni: XOVI risponde HTTP 200 con apiErrorCode e apiErrorMessage, e il connettore li trasforma in errori. param invalid su key significa una chiave API sbagliata o eliminata; no permission significa che la chiave o il piano non possono usare quella funzione; cost error significa che il budget di crediti è esaurito fino alla prossima ricarica; param missing o param invalid su un altro campo indica il campo da correggere. result empty è una chiamata riuscita senza dati, per esempio un dominio senza posizionamenti.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Claude

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio XOVI, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

Tool disponibili

Esempi di prompt

• "Com'è cambiato l'indice di visibilità di example.de su google.de negli ultimi 12 mesi?"
• "Per quali keyword www.example.de/blog/ è in prima pagina, con volume di ricerca e CPC?"*
• "Confronta il valore di ranking di example.de e concorrente.de nell'ultima settimana."
• "Quali keyword monitorate del nostro progetto hanno perso più di 3 posizioni da ieri?"
• "Quanti crediti API ci restano, e quando è stata l'ultima ricarica?"

FAQ

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot