UPGeoSEO

Integrazione MCP

Gestisci la tua SEO da tuo editor.

Importa i tuoi risultati e i prompt di correzione pronti da incollare in qualsiasi CLI di programmazione IA via MCP — e, quando vuoi, lascia fare il lavoro a lei: pianifica il calendario, pubblica un articolo, gestisci i tuoi siti. Ogni azione che modifica qualcosa chiede prima la tua conferma.

Il flusso per cui è stato creato

Audit → fix-prompt → il tuo agente di programmazione.

get_fix_prompt restituisce un'istruzione scritta per un agente di programmazione, non una checklist per esseri umani: cosa significa il risultato dell'audit, come risolverlo, la gravità e l'area interessata. Il tuo assistente legge un risultato dal tuo audit, richiede il relativo fix-prompt e lo applica direttamente al repository aperto: l'audit e il codice non lasciano mai il tuo editor.

  1. 1

    Esegui un audit gratuito sul tuo sito — nessun account necessario.

  2. 2

    Connetti il server MCP con il tuo token (sotto).

  3. 3

    Chiedi al tuo assistente di recuperare un risultato, il relativo fix-prompt e di applicarlo.

Da sapere

Gli audit vengono avviati nella dashboard — nessuno strumento MCP può avviarne uno. Tramite MCP leggi le esecuzioni e i rispettivi risultati. Un fix-prompt è una guida per il tuo agente, per ciascun tipo di risultato; non è una patch e il tuo agente deve comunque implementare e verificare la modifica.

Cosa ottieni

41 strumenti che il tuo assistente può richiamare.

Una volta connesso, la tua CLI di programmazione AI può richiedere a UPGeoSEO siti, audit e correzioni — e intervenire su di essi. L'elenco qui sotto è generato direttamente dal server: mostra ciò che è effettivamente registrato oggi, non un riepilogo scritto in passato.

Lettura — 27 strumenti

Questi effettuano solo controlli. Restituiscono i tuoi dati e non modificano nulla.

  • detect_locales

    Show the languages detected on one of your sites.

  • get_ai_visibility

    The site's AI-visibility report, query by query: per language and engine (Google AI Overviews, Google AI Mode, ChatGPT, Gemini, Perplexity), how often AI answers cite your site or mention your brand over the last 4 weeks (k of n) with a paired trend, plus every tracked query's latest result, cited URLs and history.

  • get_analytics

    Google Analytics 4 report for one of your sites.

  • get_analytics_realtime

    GA4 realtime active users, by country and page.

  • get_article

    Look up one article by id: its title, language, status, whether it is the PRIMARY or a translation, slug, live URL, image refs, SEO score, and its whole translation group.

  • get_article_impact

    SEO + GEO impact deltas/trend for one article vs. its pre-publish baseline.

  • get_audit_findings

    PAGINATED — returns at most `limit` findings (default 50, max 200) with `page.hasMore` and `page.nextOffset`; read `summary` for totals by severity and type, then page with `offset`.

  • get_bing_performance

    Bing Webmaster traffic, per-page stats, and crawl stats for one of your sites.

  • get_calendar

    PAGINATED — the content calendar for one of your sites: each slot's scheduled date, TARGET KEYWORD (with its volume/competition), locale, role, intent, and the article it produced.

  • get_content_plan

    A site's content plan: without locale, where each language stands; with locale, that language page by page (the page's own keyword, its topics, what is already scheduled, what was left out and why).

  • get_fix_prompt

    Get a ready-to-paste remediation prompt for a finding type.

  • get_geo_summary

    Live GA4 rollup of AI-assistant referral traffic (ChatGPT, Perplexity, Gemini, Claude, Copilot, You.com).

  • get_impact_report

    The site's impact report: clicks/impressions/avg position for the last 28 days vs. the prior 28 days, counting ONLY the URLs of articles this account published (never a customer's pre-existing pages).

  • get_index_status

    Stored Google index verdicts for one of your sites' articles.

  • get_indexnow_setup

    Show the IndexNow verification file one of your sites must serve so Bing, Yandex, Seznam and Naver accept the URLs we submit on your behalf.

  • get_integration_schemas

    Get JSON Schema for everything UPGeoSEO emits to your own systems (Article, WebhookPublishPayload, RssItem, StructuredData, TranslationGroup) plus the MCP tool index and per-channel integration guides.

  • get_keyword_metrics

    The STORED search metrics for one keyword on one of your sites (volume, competition, CPC, difficulty, market, source, measured-at).

  • get_keywords

    PAGINATED — the keywords discovered for one of your sites, with volume, competition, difficulty, intent, source, and whether each is already scheduled on the calendar.

  • get_search_performance

    Google Search Console performance for one of your sites (clicks, impressions, CTR, position).

  • get_site_speed

    The last stored PageSpeed Insights check (mobile + desktop).

  • get_usage

    Show this month's action usage for one of your sites — what each limit counts, used/total, reset date.

  • list_audits

    List recent audit runs for one of your sites.

  • list_rivals

    The rivals YOU named (up to 10) and how you compare over the last four weeks of AI answers.

  • list_sites

    List every site this token can reach: a token acts as the person who created it, so these are the sites that person can open in the dashboard, across every account they belong to (a restricted teammate sees only the sites shared with them), each with its account, your role there, and its latest audit scores (foundation + AI-readiness).

  • list_tracked_questions

    The questions YOU asked us to track in AI answers (up to 10 per language), each with its latest result per engine: answered (with whether your brand was mentioned and your site linked) or no answer shown.

  • remove_rival

    Stop comparing with a rival.

  • remove_tracked_question

    Stop tracking one of your questions.

Scrittura — 14 strumenti

Questi modificano qualcosa: aggiungono un sito, pianificano un calendario, pubblicano o eliminano. La maggior parte richiede conferma (qui sotto); tutti sono limitati ai siti che puoi aprire.

  • add_rival

    Name a rival to compare with in AI answers: a name (2 to 60 characters) and optionally its website, reduced to its domain (it may not be your own).

  • add_site

    Add a new site, by its URL, to the account this token was created in (owner or admin only): crawls it and builds its brand profile.

  • add_tracked_question

    Track one more question in AI answers for a language of the site.

  • connect_publish

    Add a publish destination for a site: a WordPress site, a webhook, a Ghost site, a Webflow CMS collection, a Shopify store or a Wix site (the last two return an install link).

  • create_focusrichiede conferma

    Concentrate the next days on a new feature (other articles of that language mention it) or a newly launched language, without adding articles.

  • delete_articlerichiede conferma

    Permanently delete one article, or every non-primary translation of a group.

  • generate_calendarrichiede conferma

    Plan a content calendar for one of your sites.

  • launch_localerichiede conferma

    Re-run market research for one of this site's already-enabled languages.

  • publish_articlerichiede conferma

    Publish a DRAFT article to the site's connected destination.

  • publish_translationsrichiede conferma

    Cascade-publish a whole translation group: the primary plus every draft sibling.

  • recrawl_site

    Re-learn one of your sites: re-read it and refresh its brand profile and brand colors.

  • refresh_locale_keywordsrichiede conferma

    Refresh a non-primary language's keyword ideas: replace the ones not yet on your calendar with freshly researched ones.

  • reschedule_item

    Move a PLANNED calendar item to a new publish date.

  • update_site_profile

    Complete or edit a site's onboarding / brand profile, switch Autopilot on or off (publishMode), and (admin-only) set its publishing schedule.

Prima di qualsiasi modifica

Ogni azione richiede prima la tua conferma.

Gli strumenti che modificano il tuo sito o consumano parte della tua quota mensile usano un flusso a due chiamate. La prima chiamata non modifica nulla: restituisce un'anteprima esatta di ciò che accadrebbe e un avviso che è necessaria la conferma. Solo una seconda chiamata con confirm:true esegue l'operazione. Nel frattempo il tuo assistente ti mostra l'anteprima, così nessun agente può pubblicare o consumare la tua quota di nascosto a tuo nome.

Cosa restituisce la prima chiamata

{
  "confirm_required": true,
  "message": "This will publish “How to split rent” to example.com's connected destination.
              Call publish_article again with confirm:true to proceed."
}

Una manciata di strumenti di scrittura non richiede conferma perché sono leggeri e reversibili: aggiungere un sito, rieseguirne la scansione, modificarne il profilo, spostare un elemento del calendario. Nessuno strumento che pubblica fa parte di questo gruppo.

Ottieni il tuo token

Genera un token, una volta sola.

Ogni client qui sotto si autentica con la stessa cosa: un token personale che agisce a tuo nome. Ecco dove ottenerlo.

1

Accedi al tuo account UPGeoSEO (o creane uno — iniziare è gratis).

2

Apri Dashboard → Il tuo profilo e trova la scheda API access (MCP).

3

Clicca su Generate token. Copialo subito — inizia con ugs_live_ ed è mostrato una sola volta.

Collega il tuo client

Punta la tua CLI di coding con IA al server.

UPGeoSEO parla MCP standard su Streamable HTTP con auth bearer, quindi funziona con qualsiasi client che supporti un server HTTP remoto e un header personalizzato. Scegli il tuo qui sotto e sostituisci YOUR_TOKEN con il token che hai generato.

Claude Code (CLI)

Un solo comando lo aggiunge — eseguilo da qualsiasi posto:

claude mcp add --transport http upgeoseo \
  https://app.upgeoseo.com/api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor

Aggiungi una voce a ~/.cursor/mcp.json (globale) o .cursor/mcp.json nel tuo progetto:

// ~/.cursor/mcp.json  (or .cursor/mcp.json in your project)
{
  "mcpServers": {
    "upgeoseo": {
      "url": "https://app.upgeoseo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Windsurf

Aggiungilo al mcp_config.json di Windsurf con la stessa struttura url + headers:

// Windsurf → mcp_config.json
{
  "mcpServers": {
    "upgeoseo": {
      "url": "https://app.upgeoseo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Nota: alcune versioni di Windsurf chiamano il campo serverUrl invece di url. Se url non funziona, rinomina quella singola chiave — tutto il resto resta uguale.

Cline e altre estensioni MCP di VS Code

Aggiungi un server al tuo .mcp.json (o alle impostazioni MCP dell’estensione), url + headers come al solito:

// .mcp.json (or your MCP extension's settings)
{
  "mcpServers": {
    "upgeoseo": {
      "url": "https://app.upgeoseo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Qualsiasi altro client MCP — i fatti nudi e crudi

Se il tuo client supporta un server MCP HTTP remoto con header personalizzati, funziona. Le sole tre cose di cui ha bisogno:

  • Trasporto: Streamable HTTP
  • Endpoint: https://app.upgeoseo.com/api/mcp
  • Auth: Header HTTP Authorization: Bearer <token>

I percorsi esatti dei file di configurazione e i nomi dei campi variano per client e versione. La costante è sempre la stessa: l’URL qui sopra, più l’header Authorization: Bearer che porta il tuo token.

Provalo

Una volta collegato, basta chiedere.

Non chiami gli strumenti per nome — parli con il tuo assistente e li sceglie lui. Qualche cosa da provare:

“Elenca i miei siti.”

“Mostra i problemi aperti per example.com.”

“Prendi il prompt di correzione per h1_missing e applicalo a questo repository.”

Sicurezza

Circoscritto al tuo account, con conferma vincolante e revocabile.

Il tuo accesso, e solo il tuo

Un token agisce a tuo nome: accede a ogni sito che puoi già aprire nella dashboard, nel tuo account e in qualsiasi account a cui appartieni, con il ruolo che hai in ciascuno. Nessuno strumento accetta un account id come argomento, quindi un client con il tuo token non può accedere ai dati di nessun altro, nemmeno chiedendoli.

Le scritture richiedono conferma, non sono bloccate

Questa non è un'integrazione di sola lettura: 14 dei 41 strumenti apportano modifiche. A proteggerti ci sono il passaggio di conferma, i limiti mensili del tuo piano e il fatto che la pubblicazione segue gli stessi controlli della dashboard.

Revoca quando vuoi

Elimina un token dalla stessa scheda API access (MCP) quando vuoi. Una volta revocato, qualsiasi client che lo detiene ancora smette di funzionare all’istante.

Mostrato una volta

Mostriamo un nuovo token una sola volta, alla generazione. Se lo perdi, non lo recuperi — ne generi uno nuovo e lo sostituisci.

Correggi ciò che l’audit trova — senza uscire dal tuo editor.

Crea un account, genera un token e punta la tua CLI di coding con IA a UPGeoSEO. I tuoi risultati e i tuoi prompt di correzione, proprio dove scrivi codice.