Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Yandex Direct con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Fai analizzare alla tua AI la tua pubblicità su Yandex Direct, in sola lettura: campagne, gruppi di annunci, annunci, keyword e offerte, sitelink e callout, clienti di agenzia, dizionari, tracciamento delle modifiche e report statistici per giorno, campagna, annuncio o query di ricerca.
Prova a chiedere
Prompt di esempio per Yandex Direct
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Yandex Direct, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Yandex Direct + Meta Muse
Fai analizzare alla tua AI la tua pubblicità su Yandex Direct, in sola lettura: campagne, gruppi di annunci, annunci, keyword e offerte, sitelink e callout, clienti di agenzia, dizionari, tracciamento delle modifiche e report statistici per giorno, campagna, annuncio o query di ricerca.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
YANDEX_DIRECT_TOKEN
Step 1 — Ottieni le credenziali
La configurazione richiede circa 10 minuti, più il tempo che Yandex impiega ad approvare l'accesso API (da un'ora a qualche giorno lavorativo). Ti servono un account Yandex Direct con almeno una campagna e una tua app registrata su oauth.yandex.ru.
- Registra un'app su oauth.yandex.ru: piattaforma servizi web, con il permesso Yandex Direct API (
direct:api). Annota il suo ClientID. - Nell'interfaccia web di Yandex Direct apri Tools → API, invia una richiesta di accesso API per quel ClientID e accetta il contratto d'uso dell'API. Finché Yandex non approva la richiesta, le chiamate falliscono con l'errore 58.
- Con l'account Direct collegato, apri
https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>con il tuo ClientID e copia l'access_token(inizia con y0_) inYANDEX_DIRECT_TOKEN, senza Bearer o OAuth davanti. Il token vale circa un anno e si rinnova finché viene usato. - Solo per le agenzie: imposta
YANDEX_DIRECT_CLIENT_LOGINsul login Yandex dell'inserzionista da leggere;yandex_direct_list_agency_clientselenca questi login. Lascialo vuoto per il tuo account. - Installa il connettore ed esegui
yandex_direct_get_client: mostra l'account, il suo login e la sua valuta.
Cosa legge: le campagne con tipo, stato, condizione, date, fondi e clic e impressioni totali, più la strategia di offerta; i gruppi di annunci con regioni e keyword negative; gli annunci con titolo, testo e link; keyword e autotargeting con offerte e produttività; le offerte delle keyword con le offerte e il traffico necessari per ogni posizione nella ricerca; sitelink, callout, set condivisi di keyword negative ed elenchi di retargeting; i clienti di agenzia; dizionari come valute e regioni; quali campagne sono cambiate da un certo momento; e i report statistici per giorno, campagna, annuncio o query di ricerca.
Report: yandex_direct_get_report restituisce testo separato da tabulazioni, con i nomi delle colonne nella prima riga e gli importi in decimali. I report piccoli arrivano subito. Quelli più grandi vengono preparati offline: l'AI richiede di nuovo con gli stessi parametri dopo l'attesa indicata da Yandex. In coda possono stare al massimo 5 report offline, e i report sulle query di ricerca sono solo offline e coprono gli ultimi 180 giorni.
Importi e pagine: offerte, budget e fondi arrivano come interi in micros (2500000 = 2,50 nella valuta dell'account). Gli elenchi restituiscono fino a 500 oggetti di default e al massimo 10.000, e gruppi, annunci e keyword si leggono per al massimo 10 campagne per chiamata.
Sola lettura per scelta: ogni tool legge. Nulla crea, modifica, mette in pausa o paga qualcosa, quindi non c'è niente da confermare e niente di disattivato all'installazione.
Limiti: ogni chiamata consuma punti API dalla quota giornaliera dell'inserzionista, e una chiamata fallita costa 20 punti. L'AI preferisce una chiamata con più id a tante chiamate singole e chiede solo i campi che le servono. L'errore 152 indica che i punti di oggi sono finiti; 506 che ci sono troppe richieste contemporanee.
Errori comuni: 53 significa che il token non è valido o è scaduto: prendine uno nuovo come al passo 3. 58 significa che l'accesso API dell'app non è ancora approvato. 54, 3000 o 3001 indicano nessun accesso API o nessun diritto, per esempio per un login cliente che il token non può leggere. 513 indica che il login non è collegato a Direct. 8000 e da 4000 a 4006 indicano un parametro sbagliato, 8800 un oggetto non trovato e 9300 troppi id in una chiamata.
Il connettore non crea né modifica campagne, annunci, keyword o offerte, non gestisce moderazione, budget o pagamenti e non usa la Sandbox né Wordstat.
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 Muse
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 mostraYOUR_SERVER_ID.
Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.
- In Muse apri Settings → Connectors e scegli Add custom connector.
- Incolla l'URL del server MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
- In una chat, chiedi a Muse qualcosa che richiede i tool di
Yandex Direct.
Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.
Tool disponibili
| Tool | What it does |
|---|---|
yandex_direct_get_client | Read the advertiser account the token acts for (or the Client-Login one): ClientId, Login, ClientInfo (name), Currency, CountryId, Type… |
yandex_direct_list_campaigns | List campaigns: Id, Name, Type (TEXT_CAMPAIGN, UNIFIED_CAMPAIGN, SMART_CAMPAIGN, MOBILE_APP_CAMPAIGN, CPM_BANNER_CAMPAIGN ...), Status… |
yandex_direct_list_ad_groups | List ad groups of up to 10 campaigns (or by id): Id, Name, CampaignId, Type, Status, ServingStatus, RegionIds, NegativeKeywords… |
yandex_direct_list_ads | List ads of up to 10 campaigns, up to 1000 ad groups, or by id: Id, CampaignId, AdGroupId, Type, Status, State, StatusClarification, and… |
yandex_direct_list_keywords | List keywords and autotargeting of up to 10 campaigns, up to 1000 ad groups, or by id: Id, Keyword, State, Status, ServingStatus… |
yandex_direct_list_keyword_bids | Read keyword bids with the auction picture: for each keyword the search and network bid and, on search, the bids and traffic volume needed… |
yandex_direct_list_sitelinks | Read sitelink sets by id (SitelinkSetId from yandex_direct_list_ads): each sitelink's Title, Href and Description |
yandex_direct_list_ad_extensions | List ad extensions (callouts) of the account: Id, Type, Status, Associated and the callout text |
yandex_direct_list_negative_keyword_sets | Read shared negative keyword sets by id (NegativeKeywordSharedSetIds of campaigns and ad groups): Id, Name, NegativeKeywords, Associated |
yandex_direct_list_retargeting_lists | List retargeting and audience lists: Id, Name, Type, Description, Rules (Metrica goals and segments), IsAvailable, Scope |
yandex_direct_list_agency_clients | For agency accounts: list the agency's advertisers with Login, ClientId, ClientInfo, Currency and Archived |
yandex_direct_get_dictionaries | Read reference dictionaries: Currencies (with bid limits), GeoRegions (region ids used in RegionIds), TimeZones, Constants, AdCategories… |
yandex_direct_check_campaign_changes | Which campaigns changed since a moment: for each changed campaign, whether the campaign itself (SELF), its groups, ads or keywords… |
yandex_direct_get_report | Run a statistics report (Reports service) and return it as tab-separated text: a column header row, one row per line, money as decimals in… |
Esempi di prompt
- "Come sono andate le mie campagne la settimana scorsa? Mostrami impressioni, clic, CTR, costo e conversioni per campagna."
- "Quali query di ricerca hanno speso di più negli ultimi 30 giorni senza una sola conversione?"
- "Elenca le keyword della campagna Pneumatici invernali con le loro offerte, e dimmi cosa servirebbe per arrivare nelle prime posizioni."
- "Quali dei miei annunci sono stati rifiutati o non vengono mostrati in questo momento, e perché?"
- "Siamo un'agenzia: elenca i nostri clienti e mostrami la spesa di ieri del cliente romashka-shop."
FAQ
Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.
Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.
Prossimi passi
Questa guida ti è stata utile?
