Collegare Yandex Metrica MCP a Claude

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

Yandex Metrica + Claude

Fai analizzare alla tua AI la web analytics di Yandex Metrica: contatori, obiettivi, filtri e segmenti, report a tabella, serie temporali, drill-down e confronti su visite, sorgenti, pagine e conversioni, e visite e hit grezzi tramite la Logs API.

Prerequisiti

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

YANDEX_METRICA_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti servono un account Yandex che possiede i contatori di Metrica o vi ha accesso, e un'app tua registrata su oauth.yandex.com.

1. Crea su oauth.yandex.com un'app del tipo For API access or debugging e assegnale l'accesso metrika:read (statistiche di Metrica, impostazioni dei contatori, elenco dei contatori). Annota il suo ClientID.
2. Con l'account Yandex che possiede o vede i contatori, apri https://oauth.yandex.com/authorize?response_type=token&client_id=<ClientID> con il tuo ClientID e copia il token (inizia con y0_) in YANDEX_METRICA_TOKEN, senza OAuth o Bearer davanti.
3. Installa il connettore ed esegui yandex_metrica_list_counters: verifica il token ed elenca gli id dei contatori che servono agli altri tool.

Cloud e self-hosting funzionano allo stesso modo: incolli il token e il connettore lo invia come Authorization: OAuth ... a ogni chiamata. In AnythingMCP non c'è nessuna Redirect URL da impostare.

Il token dura circa un anno: si prolunga finché viene usato. L'accesso in lettura basta per tutto: metrika:read copre i report, le impostazioni dei contatori e le richieste alla Logs API.

Prima contatori e obiettivi: l'id del contatore va in ids nei report e in counterId ovunque altrove. yandex_metrica_list_goals fornisce gli id degli obiettivi, che le metriche degli obiettivi contengono, come ym:s:goal123reaches e ym:s:goal123conversionRate.

Metriche, date e filtri: metriche e dimensioni iniziano con ym:s: per le sessioni (visite) e ym:pv: per le visualizzazioni di pagina, ad esempio ym:s:visits, ym:s:bounceRate o ym:s:lastTrafficSource. Le date accettano YYYY-MM-DD, today, yesterday o 30daysAgo. I filtri usano ==, !=, =@ (contiene) e =~ (regex), combinati con AND e OR; i segmenti salvati di yandex_metrica_list_segments si possono riusare come filtri. Le righe si sfogliano con limit (predefinito 100, al massimo 100.000) e offset, che parte da 1.

Dati campionati: le risposte dei report contengono sampled e sample_share. Quando sampled è true i valori sono stime: su intervalli brevi chiedi la precisione piena (accuracy full), altrimenti usa la Logs API.

Logs API: visite e hit grezzi, non campionati, vengono preparati dal lato di Yandex. L'AI verifica con yandex_metrica_evaluate_log_request se la richiesta si può creare, la crea, attende che lo stato sia processed e scarica ogni parte come testo separato da tabulazioni, con i nomi dei campi nella prima riga. L'intervallo di date non può includere oggi, e i log preparati contano nella quota di archiviazione dei log del contatore.

Limiti: 5.000 richieste al giorno per utente, 200 richieste di report ogni 5 minuti per utente, 3 richieste in parallelo per utente e 30 richieste al secondo per indirizzo IP (10 per la Logs API). Oltre, Yandex risponde 429: aspetta e riprova.

Errori frequenti: 401 vuol dire che il token è sbagliato, scaduto o revocato: ottienine uno nuovo con il ClientID della tua app come al passo 2. 403 vuol dire che il token funziona, ma il suo account non ha accesso a quel contatore oppure all'app manca metrika:read. 400 vuol dire che una metrica, una dimensione o un filtro non è valido, e il messaggio lo indica.

Cosa legge: contatori con sito, mirror, stato, fuso orario, stato del codice, proprietario e il tuo permesso, e le etichette (cartelle) in cui sono ordinati; obiettivi con tipo, condizioni, passi e prezzo; filtri dei dati, operazioni sugli URL, segmenti salvati e chi ha accesso a un contatore; report a tabella, serie temporali, drill-down e confronti su visite, utenti, frequenza di rimbalzo, sorgenti di traffico, pagine, paesi, dispositivi e conversioni degli obiettivi; e visite e hit grezzi, non campionati, dalla Logs API.

Disattivato all'installazione: yandex_metrica_clean_log_request. Cancella i file preparati di una richiesta della Logs API già elaborata per liberare la quota di archiviazione dei log del contatore, e dopo i file non si possono più scaricare. Attivalo nella pagina del connettore solo se ti serve; l'AI ti chiede conferma prima di ogni modifica. yandex_metrica_create_log_request e yandex_metrica_cancel_log_request sono attivi: avviano o fermano solo la preparazione di un'esportazione di dati grezzi dal lato di Yandex e non modificano contatori, obiettivi o impostazioni.

Non incluso: creare o modificare contatori, obiettivi, filtri e accessi, e caricare conversioni offline, chiamate, spese, parametri utente o dati CRM.

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 Yandex Metrica, 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

• "Quali sorgenti di traffico hanno portato più visite il mese scorso, e con quale frequenza di rimbalzo?"
• "Com'è cambiato settimana per settimana negli ultimi tre mesi il tasso di conversione del mio obiettivo ordine?"
• "Confronta visite e obiettivi raggiunti per sorgente di traffico tra ottobre e settembre."
• "Quali pagine hanno avuto più visualizzazioni ieri, e su quali dispositivi?"
• "Prendi le visite grezze, non campionate, della settimana scorsa tramite la Logs API e contale per regione."

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