UPGeoSEO

MCP-Integration

Steuern Sie Ihre SEO direkt aus Ihren Editor.

Holen Sie sich Audit-Ergebnisse und einsatzbereite Fix-Prompts über MCP in jedes KI-Coding-CLI – und lassen Sie es bei Bedarf auch die Arbeit erledigen: Redaktionsplan erstellen, Artikel schreiben, veröffentlichen. Jede Aktion, die Änderungen vornimmt, erfordert vorab Ihre Bestätigung.

Der Workflow dahinter

Audit → Fix-Prompt → Ihr Coding-Agent.

get_fix_prompt liefert Anweisungen speziell für Coding-Agenten, keine Checkliste für Menschen: was das Ergebnis bedeutet, wie es behoben wird, sowie Schweregrad und betroffener Bereich. Ihr Assistent liest einen Befund aus Ihrem Audit, ruft den passenden Fix-Prompt ab und wendet ihn direkt auf das geöffnete Repository an – Audit und Code verlassen zu keinem Zeitpunkt Ihren Editor.

  1. 1

    Führen Sie ein kostenloses Audit für Ihre Website durch – kein Konto erforderlich.

  2. 2

    Verbinden Sie den MCP-Server mit Ihrem Token (siehe unten).

  3. 3

    Bitten Sie Ihren Assistenten, ein Ergebnis samt Fix-Prompt abzurufen und umzusetzen.

Gut zu wissen

Audits werden im Dashboard gestartet – kein MCP-Tool stößt sie an. Über MCP lesen Sie die Durchläufe und deren Ergebnisse aus. Ein Fix-Prompt ist eine Handlungsanweisung für Ihren Agenten je nach Befundtyp; es handelt sich nicht um einen fertigen Patch, und Ihr Agent muss die Änderung weiterhin selbst vornehmen und überprüfen.

Was Sie bekommen

39 Tools, die Ihr Assistent aufrufen kann.

Nach der Verbindung kann Ihr KI-Coding-CLI UPGeoSEO nach Ihren Websites, Audits und Fixes abfragen – und entsprechend handeln. Die folgende Liste wird direkt vom Server generiert und spiegelt wider, was heute tatsächlich registriert ist, keine veraltete Zusammenfassung.

Lesen – 22 Tools

Diese lesen nur. Sie geben Ihre eigenen Daten zurück und ändern nichts.

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

Schreiben – 17 Tools

Diese verändern Daten: Sie fügen Websites hinzu, planen Redaktionspläne, schreiben, übersetzen, veröffentlichen oder löschen. Die meisten erfordern eine Bestätigung (siehe unten); alle sind strikt auf Ihr eigenes Konto beschränkt.

  • 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_focusfragt nach

    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_articlefragt nach

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

  • generate_articlefragt nach

    Write ONE article now for a site (inline, ~30-60s).

  • generate_articles_bulkfragt nach

    Enqueue many background article-generate jobs at once (returns immediately).

  • generate_calendarfragt nach

    Plan a content calendar for one of your sites.

  • launch_localefragt nach

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

  • publish_articlefragt nach

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

  • publish_translationsfragt nach

    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_keywordsfragt nach

    Refresh a non-primary locale's keyword ideas: purge unscheduled backlog keywords and re-discover fresh native ones.

  • refresh_og_imagesfragt nachNur Admin

    ADMIN ONLY.

  • reschedule_item

    Move a PLANNED calendar item to a new publish date.

  • research_keywordsfragt nachNur Admin

    ADMIN ONLY.

  • translate_articlefragt nach

    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.

Bevor sich etwas ändert

Jede Aktion fragt Sie zuerst.

Tools, die Kosten verursachen oder Ihre Website verändern, nutzen einen zweistufigen Ablauf. Der erste Aufruf ändert nichts – er liefert eine Vorschau der genauen Aktionen sowie den Hinweis, dass eine Bestätigung erforderlich ist. Erst ein zweiter Aufruf mit confirm:true führt die Aktion aus. Ihr Assistent zeigt Ihnen zuvor die Vorschau, sodass kein Agent unbemerkt in Ihrem Namen veröffentlichen oder Kosten verursachen kann.

Was der erste Aufruf zurückgibt

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

Eine Handvoll Schreib-Tools erfordert keine Bestätigung, da sie ressourcenschonend und reversibel sind – das Hinzufügen einer Website, ein erneutes Crawlen, das Bearbeiten des Profils oder das Verschieben eines Kalendereintrags. Nichts, was veröffentlicht oder Kosten verursacht, gehört zu dieser Gruppe.

Holen Sie Ihr Token

Erzeugen Sie ein Token, einmal.

Jeder Client unten authentifiziert sich mit demselben: einem persönlichen Token, das den Zugriff auf Ihr Konto begrenzt. Hier bekommen Sie es.

1

Melden Sie sich bei Ihrem UPGeoSEO-Konto an (oder erstellen Sie eines — der Einstieg ist kostenlos).

2

Öffnen Sie Dashboard → Ihr Profil und finden Sie die Karte API access (MCP).

3

Klicken Sie auf Generate token. Kopieren Sie es jetzt — es beginnt mit ugs_live_ und wird nur einmal angezeigt.

Verbinden Sie Ihren Client

Richten Sie Ihre KI-Coding-CLI auf den Server aus.

UPGeoSEO spricht Standard-MCP über Streamable HTTP mit Bearer-Auth und funktioniert damit mit jedem Client, der einen Remote-HTTP-Server und einen eigenen Header unterstützt. Wählen Sie unten Ihren und ersetzen Sie YOUR_TOKEN durch das erzeugte Token.

Claude Code (CLI)

Ein Befehl fügt es hinzu — führen Sie ihn von überall aus:

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

Cursor

Fügen Sie einen Eintrag in ~/.cursor/mcp.json (global) oder .cursor/mcp.json in Ihrem Projekt hinzu:

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

Fügen Sie es zu Windsurfs mcp_config.json mit derselben url + headers-Struktur hinzu:

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

Hinweis: Manche Windsurf-Versionen nennen das Feld serverUrl statt url. Wenn url nicht greift, benennen Sie diesen einen Schlüssel um — alles andere bleibt gleich.

Cline & andere VS-Code-MCP-Erweiterungen

Fügen Sie einen Server zu Ihrer .mcp.json (oder den MCP-Einstellungen der Erweiterung) hinzu, url + headers wie gewohnt:

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

Jeder andere MCP-Client — die reinen Fakten

Wenn Ihr Client einen Remote-HTTP-MCP-Server mit eigenen Headern unterstützt, funktioniert es. Die einzigen drei Dinge, die er braucht:

  • Transport: Streamable HTTP
  • Endpunkt: https://app.upgeoseo.com/api/mcp
  • Auth: HTTP-Header Authorization: Bearer <token>

Die genauen Pfade der Konfigurationsdateien und Feldnamen variieren je nach Client und Version. Konstant bleibt immer dasselbe: die obige URL plus der Authorization: Bearer-Header mit Ihrem Token.

Probieren Sie es

Einmal verbunden, fragen Sie einfach.

Sie rufen die Tools nicht beim Namen auf — Sie sprechen mit Ihrem Assistenten, und er wählt sie aus. Ein paar Dinge zum Ausprobieren:

“Liste meine Sites auf.”

“Zeige die offenen Findings für example.com.”

“Hol den Fix-Prompt für h1_missing und wende ihn auf dieses Repo an.”

Sicherheit

Auf Sie beschränkt, bestätigungspflichtig, widerrufbar.

Ihr Konto und nur Ihres

Ein Token ist an genau ein Konto gebunden. Jedes Tool bezieht seine Website-IDs aus Ihrem eigenen Konto und kein Tool akzeptiert eine Account-ID als Argument. Ein Client mit Ihrem Token kann somit niemals auf Daten anderer zugreifen – selbst wenn er danach fragt.

Schreibzugriffe sind abgesichert, nicht blockiert

Dies ist keine reine Lese-Integration: 17 der 39 Tools nehmen Änderungen vor. Geschützt sind Sie durch den Bestätigungsschritt, die monatlichen Limits Ihres Tarifs und die Tatsache, dass Veröffentlichungen dieselben Prüfungen wie im Dashboard durchlaufen.

Jederzeit widerrufen

Löschen Sie ein Token von derselben Karte API access (MCP), wann immer Sie wollen. Einmal widerrufen, hört jeder Client, der es noch hält, sofort auf zu funktionieren.

Einmal angezeigt

Wir zeigen ein neues Token ein einziges Mal, bei der Erzeugung. Wenn Sie es verlieren, bekommen Sie es nicht zurück — Sie erzeugen ein frisches und tauschen es aus.

Beheben Sie, was das Audit findet — ohne Ihren Editor zu verlassen.

Erstellen Sie ein Konto, erzeugen Sie ein Token und richten Sie Ihre KI-Coding-CLI auf UPGeoSEO aus. Ihre Findings und Fix-Prompts, genau dort, wo Sie Code schreiben.