UPGeoSEO

MCP-integraatio

Hoida SEO suoraan editoriisi.

Tuo havaintosi ja valmiit korjauskehotteesi mihin tahansa tekoälykoodauksen CLI-työkaluun MCP:n kautta — ja anna sen hoitaa työt, kun haluat: suunnittele kalenteri, julkaise artikkeli, hallinnoi sivustojasi. Jokainen muutoksia tekevä toiminto pyytää ensin vahvistuksen.

Työnkulku, johon tämä on tarkoitettu

Auditointi → korjauskehote → koodausagenttisi.

get_fix_prompt palauttaa koodausagentille kirjoitetun ohjeen, ei ihmiselle tarkoitettua tarkistuslistaa: mitä löydös tarkoittaa, miten se korjataan sekä sen vakavuuden ja vaikutusalueen. Avustajasi lukee löydöksen auditoinnistasi, pyytää sen korjauskehotteen ja soveltaa sitä avoinna olevaan koodivarastoon — auditointi ja koodi eivät koskaan poistu editoristasi.

  1. 1

    Tee sivustollesi ilmainen auditointi — tiliä ei tarvita.

  2. 2

    Yhdistä MCP-palvelin tunnisteellasi (alla).

  3. 3

    Pyydä avustajaasi hakemaan löydös ja sen korjauskehote sekä toteuttamaan se.

Hyvä tietää

Auditoinnit käynnistetään hallintapaneelista — mikään MCP-työkalu ei käynnistä niitä. MCP:n kautta luet ajot ja niiden löydökset. Korjauskehote tarjoaa agentillesi ohjeistuksen löydöstyypeittäin; se ei ole valmis koodipaikka, ja agenttisi on silti tehtävä ja tarkistettava muutos.

Mitä saat

41 työkalua avustajasi käytettävissä.

Yhdistämisen jälkeen tekoälykoodauksen CLI-työkalusi voi pyytää UPGeoSEO:lta sivustosi, auditoinnit ja korjaukset — sekä toimia niiden pohjalta. Alla oleva lista luodaan suoraan palvelimelta, joten se vastaa tämänhetkistä tilannetta eikä vanhentunutta kuvausta.

Luku — 27 työkalua

Nämä vain lukevat tietoja. Ne palauttavat omat tietosi eivätkä muuta mitään.

  • 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.

Kirjoitus — 14 työkalua

Nämä muuttavat asioita: ne lisäävät sivuston, suunnittelevat kalenterin, julkaisevat tai poistavat. Useimmat vaativat vahvistuksen (alla), ja kaikki rajoittuvat sivustoihin, jotka voit avata.

  • 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_focuskysyy ensin

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

  • delete_articlekysyy ensin

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

  • generate_calendarkysyy ensin

    Plan a content calendar for one of your sites.

  • launch_localekysyy ensin

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

  • publish_articlekysyy ensin

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

  • publish_translationskysyy ensin

    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_keywordskysyy ensin

    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.

Ennen kuin mitään muutetaan

Jokainen toiminto kysyy sinulta ensin.

Työkalut, jotka muuttavat sivustoasi tai käyttävät osan kuukausikiintiöstäsi, käyttävät kaksivaiheista kutsua. Ensimmäinen kutsu ei muuta mitään — se palauttaa esikatselun siitä, mitä tarkalleen tapahtuisi, sekä huomautuksen vahvistuksen tarpeesta. Vain toinen kutsu, jossa on confirm:true, suorittaa toimenpiteen. Avustajasi näyttää esikatselun välissä, joten agentti ei voi julkaista tai käyttää kiintiötäsi salaa puolestasi.

Mitä ensimmäinen kutsu palauttaa

{
  "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."
}

Kourallinen kirjoitustyökaluista ei vaadi vahvistusta, koska ne ovat keveitä ja peruutettavissa — sivuston lisääminen, sen uudelleenindeksointi, profiilin muokkaus tai kalenterimerkinnän siirtäminen. Mikään julkaiseva toiminto ei kuulu tähän ryhmään.

Hanki tokenisi

Luo token kerran.

Kaikki alla olevat asiakasohjelmat tunnistautuvat samalla tavalla: henkilökohtaisella tokenilla, joka toimii puolestasi. Täältä saat sen.

1

Kirjaudu sisään UPGeoSEO-tilillesi (tai luo tili – aloittaminen on ilmaista).

2

Avaa Hallintapaneeli → Profiilisi ja etsi kortti API access (MCP).

3

Napsauta Luo token. Kopioi se nyt – se alkaa merkkijonolla ugs_live_ ja näytetään vain kerran.

Yhdistä asiakasohjelmasi

Osoita tekoälykoodauksen CLI palvelimeen.

UPGeoSEO käyttää standardia MCP-protokollaa Streamable HTTP:n ja Bearer-todennuksen kautta, joten se toimii minkä tahansa etä-HTTP-palvelinta ja mukautettua otsikkoa tukevan asiakasohjelman kanssa. Valitse omasi alta ja korvaa YOUR_TOKEN luomallasi tokenilla.

Claude Code (CLI)

Lisää se yhdellä komennolla – suorita missä tahansa:

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

Cursor

Lisää tietue tiedostoon ~/.cursor/mcp.json (globaali) tai projektisi tiedostoon .cursor/mcp.json:

// ~/.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

Lisää se Windsurfin mcp_config.json-tiedostoon samassa url + headers -muodossa:

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

Huomautus: jotkin Windsurf-versiot käyttävät kenttänimeä serverUrl nimen url sijaan. Jos url ei toimi, nimeä vain kyseinen avain uudelleen — kaikki muu pysyy ennallaan.

Cline ja muut VS Coden MCP-laajennukset

Lisää palvelin .mcp.json-tiedostoosi (tai laajennuksen MCP-asetuksiin), url + headers tavalliseen tapaan:

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

Mikä tahansa muu MCP-asiakasohjelma — perustiedot

Jos asiakasohjelmasi tukee etäistä HTTP MCP -palvelinta mukautetuilla otsikoilla, se toimii. Se tarvitsee vain nämä kolme asiaa:

  • Siirtotapa: Streamable HTTP
  • Päätepiste: https://app.upgeoseo.com/api/mcp
  • Todennus: HTTP-otsikko Authorization: Bearer <token>

Tarkat konfiguraatiotiedostojen polut ja kenttien nimet vaihtelevat asiakasohjelman ja version mukaan. Yhteinen tekijä on aina sama: yllä oleva URL-osoite sekä Authorization: Bearer -otsikko, joka sisältää tunnuksesi.

Kokeile sitä

Kun yhteys on muodostettu, kysy vain.

Sinun ei tarvitse kutsua työkaluja nimeltä — keskustele vain avustajasi kanssa, ja se valitsee ne. Muutamia esimerkkejä:

“Listaa sivustoni.”

“Näytä avoimet havainnot sivustolle example.com.”

“Hae korjauskehote koodille h1_missing ja sovella se tähän repositorioon.”

Tietoturva

Rajattu sinulle, vahvistuksella suojattu, kumottavissa.

Sinun käyttöoikeutesi, ja vain sinun

Token toimii puolestasi: se pääsee kaikkiin sivustoihin, jotka voit jo avata hallintapaneelissa, omalla tililläsi ja millä tahansa tilillä, johon kuulut, kussakin voimassa olevalla roolillasi. Mikään työkalu ei hyväksy account id -tunnistetta argumenttina, joten tokeniasi käyttävä asiakasohjelma ei pääse kenenkään muun tietoihin, edes pyytämällä niitä.

Kirjoitustoiminnot vahvistetaan, ei estetä

Tämä ei ole pelkkä lukuoikeusintegraatio: 14 kaikkiaan 41 työkalusta tekee muutoksia. Turvanasi ovat vahvistusvaihe, tilauksesi kuukausirajat sekä se, että julkaiseminen käy läpi samat tarkistukset kuin hallintapaneelissa.

Kumoa milloin tahansa

Poista tunniste samasta API access (MCP) -kortista milloin haluat. Kumoamisen jälkeen mikään sitä käyttävä asiakasohjelma ei enää toimi.

Näytetään vain kerran

Näytämme uuden tunnisteen vain kerran sen luomisen yhteydessä. Jos kadotat sen, sitä ei voi palauttaa — luo uusi ja vaihda se tilalle.

Korjaa tarkastuksen löytämät asiat — poistumatta editoristasi.

Luo tili, luo tunniste ja osoita tekoälykoodaustyökalusi (CLI) UPGeoSEOon. Havaintosi ja korjauskehotteesi suoraan siellä, missä koodaat.