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
Führen Sie ein kostenloses Audit für Ihre Website durch – kein Konto erforderlich.
- 2
Verbinden Sie den MCP-Server mit Ihrem Token (siehe unten).
- 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
41 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 – 27 Tools
Diese lesen nur. Sie geben Ihre eigenen Daten zurück und ändern nichts.
detect_localesShow the languages detected on one of your sites.
get_ai_visibilityThe 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_analyticsGoogle Analytics 4 report for one of your sites.
get_analytics_realtimeGA4 realtime active users, by country and page.
get_articleLook 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_impactSEO + GEO impact deltas/trend for one article vs. its pre-publish baseline.
get_audit_findingsPAGINATED — 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_performanceBing Webmaster traffic, per-page stats, and crawl stats for one of your sites.
get_calendarPAGINATED — 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_planA 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_promptGet a ready-to-paste remediation prompt for a finding type.
get_geo_summaryLive GA4 rollup of AI-assistant referral traffic (ChatGPT, Perplexity, Gemini, Claude, Copilot, You.com).
get_impact_reportThe 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_statusStored Google index verdicts for one of your sites' articles.
get_indexnow_setupShow 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_schemasGet 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_metricsThe STORED search metrics for one keyword on one of your sites (volume, competition, CPC, difficulty, market, source, measured-at).
get_keywordsPAGINATED — 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_performanceGoogle Search Console performance for one of your sites (clicks, impressions, CTR, position).
get_site_speedThe last stored PageSpeed Insights check (mobile + desktop).
get_usageShow this month's action usage for one of your sites — what each limit counts, used/total, reset date.
list_auditsList recent audit runs for one of your sites.
list_rivalsThe rivals YOU named (up to 10) and how you compare over the last four weeks of AI answers.
list_sitesList 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_questionsThe 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_rivalStop comparing with a rival.
remove_tracked_questionStop tracking one of your questions.
Schreiben – 14 Tools
Diese ändern etwas: Sie fügen eine Website hinzu, planen einen Kalender, veröffentlichen oder löschen. Die meisten erfordern eine Bestätigung (siehe unten); alle sind auf die Websites beschränkt, die Sie öffnen können.
add_rivalName 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_siteAdd 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_questionTrack one more question in AI answers for a language of the site.
connect_publishAdd 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_focusfragt nachConcentrate the next days on a new feature (other articles of that language mention it) or a newly launched language, without adding articles.
delete_articlefragt nachPermanently delete one article, or every non-primary translation of a group.
generate_calendarfragt nachPlan a content calendar for one of your sites.
launch_localefragt nachRe-run market research for one of this site's already-enabled languages.
publish_articlefragt nachPublish a DRAFT article to the site's connected destination.
publish_translationsfragt nachCascade-publish a whole translation group: the primary plus every draft sibling.
recrawl_siteRe-learn one of your sites: re-read it and refresh its brand profile and brand colors.
refresh_locale_keywordsfragt nachRefresh a non-primary language's keyword ideas: replace the ones not yet on your calendar with freshly researched ones.
reschedule_itemMove a PLANNED calendar item to a new publish date.
update_site_profileComplete or edit a site's onboarding / brand profile, switch Autopilot on or off (publishMode), and (admin-only) set its publishing schedule.
Bevor sich etwas ändert
Jede Aktion fragt Sie zuerst.
Tools, die Ihre Website ändern oder einen Teil Ihres monatlichen Kontingents verbrauchen, nutzen einen Ablauf mit zwei Aufrufen. Der erste Aufruf ändert nichts — er liefert eine Vorschau dessen, was genau passieren würde, und einen Hinweis, dass eine Bestätigung erforderlich ist. Erst ein zweiter Aufruf mit confirm:true führt die Aktion aus. Ihr Assistent zeigt Ihnen dazwischen die Vorschau, sodass ein Agent nicht heimlich in Ihrem Namen veröffentlichen oder Ihr Kontingent verbrauchen kann.
Was der erste Aufruf zurückgibt
{
"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."
}Eine Handvoll Schreib-Tools erfordert keine Bestätigung, da sie ressourcenschonend und umkehrbar sind — das Hinzufügen einer Website, ein erneuter Crawl, das Bearbeiten ihres Profils oder das Verschieben eines Kalendereintrags. Nichts, was veröffentlicht, gehört zu dieser Gruppe.
Holen Sie Ihr Token
Erzeugen Sie ein Token, einmal.
Jeder unten aufgeführte Client authentifiziert sich auf dieselbe Weise: mit einem persönlichen Token, das in Ihrem Namen agiert. Hier erfahren Sie, wo Sie es erhalten.
Melden Sie sich bei Ihrem UPGeoSEO-Konto an (oder erstellen Sie eines — der Einstieg ist kostenlos).
Öffnen Sie Dashboard → Ihr Profil und finden Sie die Karte API access (MCP).
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.
Die Namen der Tools brauchen Sie nicht zu kennen. Schreiben Sie Ihrem Assistenten, was Sie wissen möchten, und er wählt das passende Tool. Zum Beispiel:
“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 Zugriff, und nur Ihrer
Ein Token agiert in Ihrem Namen: Es erreicht jede Website, die Sie bereits im Dashboard öffnen können, in Ihrem eigenen Konto sowie in jedem Konto, zu dem Sie gehören, mit der Rolle, die Sie jeweils innehaben. Kein Tool akzeptiert eine Account-ID als Argument, sodass ein Client mit Ihrem Token nicht auf die Daten anderer zugreifen kann, auch nicht, indem er danach fragt.
Schreibzugriffe sind abgesichert, nicht blockiert
Dies ist keine reine Lese-Integration: 14 der 41 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.
