UPGeoSEO

Integracja MCP

Zarządzaj swoim SEO z swojego edytora.

Pobieraj wyniki audytu i gotowe do wklejenia prompty z poprawkami do dowolnego AI coding CLI przez MCP — a gdy zechcesz, pozwól mu wykonać pracę: zaplanować kalendarz, opublikować artykuł czy zarządzać stronami. Każde działanie wprowadzające zmiany wymaga najpierw Twojego potwierdzenia.

Pętla pracy, do której to służy

Audyt → prompt z poprawką → Twój agent programistyczny.

get_fix_prompt zwraca instrukcję przygotowaną dla agenta programistycznego, a nie ludzką listę kontrolną: co oznacza problem, jak go naprawić oraz jakiej wagi i obszaru dotyczy. Twój asystent odczytuje problem z audytu, prosi o prompt z poprawką i stosuje go w już otwartym repozytorium — audyt i kod nigdy nie opuszczają Twojego edytora.

  1. 1

    Uruchom darmowy audyt swojej strony — bez konieczności zakładania konta.

  2. 2

    Połącz serwer MCP za pomocą swojego tokena (poniżej).

  3. 3

    Poproś asystenta o pobranie wykrytego problemu oraz prompta z poprawką i wdrożenie go.

Warto wiedzieć

Audyty uruchamia się w panelu — żadne narzędzie MCP ich nie rozpoczyna. Przez MCP odczytujesz przebiegi i ich wyniki. Prompt z poprawką to wskazówka dla Twojego agenta dla danego typu problemu; nie jest to gotowy patch, a Twój agent nadal musi wprowadzić i sprawdzić zmianę.

Co zyskujesz

41 narzędzi, które Twój asystent może wywołać.

Po połączeniu Twoje CLI do kodowania AI może zapytać UPGeoSEO o Twoje strony, audyty i poprawki — oraz na nich działać. Poniższa lista jest generowana bezpośrednio z serwera, więc odzwierciedla to, co jest faktycznie zarejestrowane dzisiaj, a nie dawno spisane podsumowanie.

Odczyt — 27 narzędzi

Te narzędzia tylko odczytują. Zwracają Twoje dane i niczego nie zmieniają.

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

Zapis — 14 narzędzi

Te narzędzia wprowadzają zmiany: dodają witrynę, planują kalendarz, publikują lub usuwają. Większość wymaga potwierdzenia (poniżej); wszystkie są ograniczone do witryn, które możesz otworzyć.

  • 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_focuswymaga potwierdzenia

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

  • delete_articlewymaga potwierdzenia

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

  • generate_calendarwymaga potwierdzenia

    Plan a content calendar for one of your sites.

  • launch_localewymaga potwierdzenia

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

  • publish_articlewymaga potwierdzenia

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

  • publish_translationswymaga potwierdzenia

    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_keywordswymaga potwierdzenia

    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.

Zanim cokolwiek ulegnie zmianie

Każda akcja pyta najpierw o zgodę.

Narzędzia wprowadzające zmiany na stronie lub zużywające część miesięcznego limitu działają w modelu dwuetapowym. Pierwsze wywołanie niczego nie zmienia — zwraca podgląd tego, co dokładnie by się stało, oraz informację o wymaganym potwierdzeniu. Dopiero drugie wywołanie z parametrem confirm:true wykonuje operację. Twój asystent wyświetla w tym czasie podgląd, więc agent nie może po cichu nic opublikować ani zużyć limitu w Twoim imieniu.

Co zwraca pierwsze wywołanie

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

Kilka narzędzi zapisu nie wymaga potwierdzenia, ponieważ ich działanie jest tanie i odwracalne — dodanie strony, ponowne skanowanie, edycja profilu czy przesunięcie elementu w kalendarzu. Żadne narzędzie publikujące treści nie należy do tej grupy.

Pobierz swój token

Wygeneruj token — wystarczy raz.

Każdy z poniższych klientów uwierzytelnia się w ten sam sposób: za pomocą osobistego tokena działającego w Twoim imieniu. Oto gdzie go pobrać.

1

Zaloguj się na swoje konto UPGeoSEO (lub załóż je — start jest bezpłatny).

2

Otwórz Pulpit → Twój profil i znajdź sekcję Dostęp API (MCP).

3

Kliknij Generuj token. Skopiuj go od razu — zaczyna się od ugs_live_ i jest wyświetlany tylko raz.

Połącz swojego klienta

Skieruj swoje AI coding CLI na serwer.

UPGeoSEO obsługuje standardowy protokół MCP przez Streamable HTTP z autoryzacją bearer, dzięki czemu działa z każdym klientem wspierającym zdalny serwer HTTP i niestandardowy nagłówek. Wybierz swoje narzędzie poniżej i zastąp YOUR_TOKEN wygenerowanym tokenem.

Claude Code (CLI)

Wystarczy jedno polecenie — uruchom je z dowolnego miejsca:

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

Cursor

Dodaj wpis do ~/.cursor/mcp.json (globalnie) lub .cursor/mcp.json w swoim projekcie:

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

Dodaj go do pliku mcp_config.json w Windsurf z tą samą strukturą url + headers:

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

Uwaga: niektóre wersje Windsurf nazywają to pole serverUrl zamiast url. Jeśli url nie działa, zmień tylko ten jeden klucz — cała reszta pozostaje bez zmian.

Cline i inne rozszerzenia MCP dla VS Code

Dodaj serwer do pliku .mcp.json (lub w ustawieniach MCP rozszerzenia), standardowo podając url + headers:

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

Dowolny inny klient MCP — podstawowe informacje

Jeśli Twój klient obsługuje zdalny serwer MCP przez HTTP z niestandardowymi nagłówkami, to zadziała. Potrzebuje tylko trzech rzeczy:

  • Transport: Streamable HTTP
  • Punkt końcowy: https://app.upgeoseo.com/api/mcp
  • Uwierzytelnianie: Nagłówek HTTP Authorization: Bearer <token>

Dokładne ścieżki plików konfiguracyjnych i nazwy pól różnią się w zależności od klienta i wersji. Stała pozostaje zawsze ta sama: powyższy URL oraz nagłówek Authorization: Bearer z Twoim tokenem.

Wypróbuj

Po połączeniu po prostu zapytaj.

Nie wywołujesz narzędzi po nazwie — rozmawiasz ze swoim asystentem, a on sam je wybiera. Kilka przykładów do wypróbowania:

“Wymień moje witryny.”

“Pokaż otwarte błędy dla example.com.”

“Pobierz prompt naprawczy dla h1_missing i zastosuj go w tym repozytorium.”

Bezpieczeństwo

Przypisane do Ciebie, wymagające potwierdzenia, odwoływalne.

Twój dostęp i tylko Twój

Token działa w Twoim imieniu: ma dostęp do każdej witryny, którą możesz już otworzyć w panelu, na Twoim własnym koncie oraz na dowolnym koncie, do którego należysz, z rolą, jaką na nim posiadasz. Żadne narzędzie nie przyjmuje identyfikatora konta jako argumentu, więc klient posiadający Twój token nie uzyska dostępu do danych nikogo innego, nawet jeśli o nie poprosi.

Operacje zapisu wymagają zgody, nie są zablokowane

To nie jest integracja tylko do odczytu: 14 z 41 narzędzi wprowadza zmiany. Przed niepożądanymi działaniami chroni Cię krok potwierdzenia, miesięczne limity planu oraz fakt, że publikacja przechodzi przez te same kontrole, co w panelu.

Unieważnij w dowolnym momencie

Usuń token z karty Dostęp do API (MCP), kiedy tylko chcesz. Po unieważnieniu każdy klient, który z niego korzysta, natychmiast przestanie działać.

Wyświetlany tylko raz

Nowy token pokazujemy tylko raz, podczas jego generowania. Jeśli go zgubisz, nie można go odzyskać — musisz wygenerować nowy i go podmienić.

Naprawiaj błędy wykryte w audycie — bez opuszczania edytora.

Utwórz konto, wygeneruj token i połącz swoje CLI do kodowania AI z UPGeoSEO. Twoje wyniki audytu i prompty naprawcze dokładnie tam, gdzie piszesz kod.