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
Tee sivustollesi ilmainen auditointi — tiliä ei tarvita.
2
Yhdistä MCP-palvelin tunnisteellasi (alla).
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

39 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 — 22 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 most recent completed AI-visibility probe cycle rates.
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.
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_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.
get_index_status
Stored Google/Bing 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_sites
List the sites in your account, with each site's id, URL, and latest audit scores (foundation + AI-readiness).

Kirjoitus — 17 työkalua

Nämä tekevät muutoksia: ne lisäävät sivuston, suunnittelevat kalenterin, kirjoittavat, kääntävät, julkaisevat tai poistavat. Useimmat vaativat vahvistuksen (alla); kaikki rajautuvat omaan tiliisi.

add_site
Add a new site to your account by its URL: crawls it and builds its brand profile.
connect_publish
Add a publish destination for a site: a WordPress site or a webhook.
create_focuskysyy ensin
Concentrate promotion on a new feature (sourced through real demand; the feature name is never the keyword; 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_articlekysyy ensin
Write ONE article now for a site (inline, ~30-60s).
generate_articles_bulkkysyy ensin
Enqueue many background article-generate jobs at once (returns immediately).
generate_calendarkysyy ensin
Plan a content calendar for one of your sites.
launch_localekysyy ensin
Re-run native content 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-crawl it and refresh the crawl-derived brand profile and brand colors.
refresh_locale_keywordskysyy ensin
Refresh a non-primary locale's keyword ideas: purge unscheduled backlog keywords and re-discover fresh native ones.
refresh_og_imageskysyy ensinvain ylläpitäjille
ADMIN ONLY.
reschedule_item
Move a PLANNED calendar item to a new publish date.
research_keywordskysyy ensinvain ylläpitäjille
ADMIN ONLY.
translate_articlekysyy ensin
Translate an existing article into the site's other enabled languages (background jobs).
update_site_profile
Complete or edit a site's onboarding / brand profile and (admin-only) its publishing schedule.

Ennen kuin mitään muutetaan

Jokainen toiminto kysyy sinulta ensin.

Rahaa kuluttavat tai sivustoa muuttavat työkalut käyttävät kaksivaiheista kutsua. Ensimmäinen kutsu ei muuta mitään — se palauttaa esikatselun siitä, mitä tarkalleen tapahtuisi, sekä ilmoituksen vahvistuksen tarpeesta. Vain toinen kutsu, jossa on confirm:true, suorittaa työn. Avustajasi näyttää esikatselun välissä, joten agentti ei voi vaivihkaa julkaista tai kuluttaa saldoa puolestasi.

Mitä ensimmäinen kutsu palauttaa

{
  "confirm_required": true,
  "message": "This will generate 1 article for example.com …
              Call generate_article again with confirm:true to proceed."
}

Muutama kirjoitustyökalu ei vaadi vahvistusta, koska ne ovat edullisia ja peruttavissa — kuten sivuston lisääminen, uudelleenindeksointi, profiilin muokkaus tai kalenterimerkinnän siirtäminen. Mikään julkaiseva tai rahaa kuluttava toiminto ei kuulu tähän ryhmään.

Hanki tokenisi

Luo token kerran.

Kaikki alla olevat asiakasohjelmat tunnistautuvat samalla tavalla: henkilökohtaisella tokenilla, joka rajaa pääsyn tilillesi. Näin saat sen.

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

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

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 tilisi, ja vain sinun

Tunniste on sidottu yhteen tiliin. Jokainen työkalu hakee sivustotunnukset omalta tililtäsi eikä mikään työkalu hyväksy tilitunnusta parametrina, joten tunnisteellasi toimiva asiakasohjelma ei pääse kenenkään muun tietoihin — ei edes pyytämällä niitä.

Kirjoitustoiminnot vahvistetaan, ei estetä

Tämä ei ole pelkkä lukuoikeusintegraatio: 17 kaikkiaan 39 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.

Hoida SEO suoraan editoriisi.