Entwicklerdokumentation

MCP-Server

MonoRanks spricht das Model Context Protocol. Geben Sie einem Assistenten eine URL, und er kann Ihre Audits lesen und danach handeln.

Endpunkt

https://app.monoranks.com/api/mcp

Streamable HTTP über POST, JSON-Antworten, keine Sitzung zu halten. Senden Sie einen Schlüssel als Authorization: Bearer mr_ws_… (ein Website-Schlüssel mr_site_… geht auch), oder lassen Sie den Client Sie mit OAuth 2.1 anmelden (siehe unten). Scopes, die Stundengrenze (1.200 Aufrufe pro Schlüssel) und der Zugriff der Person hinter dem Schlüssel werden bei jedem Tool-Aufruf geprüft, wie bei der REST-API.

Verbinden

Claude Code

claude mcp add --transport http monoranks https://app.monoranks.com/api/mcp \
  --header "Authorization: Bearer mr_ws_…"

Claude.ai und Claude Desktop: Fügen Sie die URL oben als benutzerdefinierten Connector hinzu (nicht geprüft: Die Menünamen in diesen Apps ändern sich oft). Wo der Client einen Header erlaubt, senden Sie den Schlüssel als Bearer-Header; sonst meldet er Sie mit OAuth an.

ChatGPT und andere OAuth-Clients: Fügen Sie https://app.monoranks.com/api/mcp als MCP-Server hinzu. Ohne Schlüssel antwortet der Endpunkt mit 401 und verweist den Client auf /.well-known/oauth-protected-resource. Der Client registriert sich (/api/oauth/register), schickt Sie zur Anmeldung und Genehmigung des Zugriffs (/oauth/authorize, mit PKCE) und holt sein Token von /api/oauth/token. Er kann nur die Lese-Scopes und issues:recheck anfragen; audits:run und actions:apply werden auf diesem Weg nie vergeben, daher brauchen start_audit, die apply-Tools und update_outreach_target einen Schlüssel. Siehe API-Schlüssel und Berechtigungen.

Tools

Lesen

Tool Macht Scope
list_sites Websites des Schlüssels, mit IDs sites:read
portfolio Alle Websites in einem Aufruf: Werte und ihre Änderung, Probleme, Aktionen, letztes und nächstes Audit und Search-Console-Klicks (mit search:read) sites:read
site_summary Werte, letztes Audit, offene Probleme, WordPress-Zugriff, wie aktuell jede Verbindung ist sites:read
speed_results Geschwindigkeit pro getesteter Seite: Labortest und echte Besucherdaten sites:read
audit_status Die letzten Audits, oder ein Audit über audit_id, mit gecrawlten Seiten und Seitenbudget sites:read
list_issues Probleme, dieselbe Liste wie auf dem Issues-Bildschirm issues:read
issue_detail Ein Problem mit Seiten, Belegen, Erklärung und vorgeschlagenen neuen Werten (je 100, suggestions_offset für mehr) issues:read
list_actions Priorisierte Aktionen mit geschätztem Gewinn und wie lange jede schon offen ist issues:read
page_findings Befunde für eine Seite, über ID oder Adresse pages:read
page_history Was sich an einer Seite von einer Prüfung oder Nachprüfung zur nächsten geändert hat, über ID oder Adresse pages:read
search_summary Search-Console-Summen, Top-Seiten und Top-Suchanfragen search:read
search_rows Search-Console-Zeilen für einen Zeitraum, nach Suchanfrage, Seite, Suchanfrage und Seite oder Tag (geben Sie nextCursor als cursor zurück; CSV-Export gibt es nur in der REST-API) search:read
near_page_one Ihre Paare aus Suchanfrage und Seite knapp hinter der ersten Seite (standardmäßig Position 8 bis 20), die meisten Impressionen zuerst, mit den zusätzlichen Klicks, die eine Top-3-Position bringen könnte search:read
topics Die Seiten der Website in Themen gruppiert, mit Klicks, Top-Suchanfragen und ob jedes Thema stark, schwach oder ohne Klicks ist search:read
analytics_pages Conversions und Umsatz pro Einstiegsseite aus Google Analytics (GA4), neben den Search-Console-Klicks analytics:read
keywords Keywords, wie der Keywords-Bildschirm sie listet, mit Nachfrage, Position, Chance und Relevanzprüfung; themenfremde Vorschläge fehlen search:read
competitors Die Wettbewerber mit Übereinstimmungswert, der KI-Prüfung jedes Vorschlags, welche die Lücken bestimmen, gemeinsamen Keywords, Keywords, bei denen sie über Ihnen stehen, Stärke und Sichtbarkeit search:read
competitor_gaps Die Position jedes Wettbewerbers und Ihre pro Keyword (gaps, content, lost, lead). Jede Zeile nennt außerdem die Seite, auf der der jeweilige Wettbewerber rankt. search:read
content_ideas Die Keyword-Lücken in Themen gruppiert, größte Chance zuerst: ob eine neue Seite nötig ist oder eine bestehende erweitert werden sollte, Ihre Seiten im Thema, die rankenden Seiten der Wettbewerber und die wichtigsten Keywords search:read
backlinks Die Backlink-Zusammenfassung und die verweisenden Domains einer Ansicht (all, new, lost, review, strong) search:read
list_outreach_targets Seiten und Websites, die Sie um einen Link oder eine Erwähnung bitten können, sortiert, mit Grund und Status search:read
ai_visibility Was KI-Assistenten auf Ihre beobachteten Fragen geantwortet haben, pro Woche, mit den Seiten, die jede Antwort zitiert ai:read
answer_gaps Fragen, bei denen KI-Antworten andere Websites nennen, aber nicht Ihre ai:read
geo_access Zugriff von KI-Crawlern, llms.txt und Signale zur Organisation und Agenten-Bereitschaft aus dem letzten Audit ai:read
llms_txt Die live llms.txt und ein veröffentlichungsfertiger Entwurf ai:read
ai_crawler_rules Was die robots.txt jetzt jedem KI-Crawler sagt ai:read
agentic_results Ergebnisse von Agentic Browsing mit dem, was zu beheben ist, oder ein Neulauf über job_id ai:read

Handeln

Tool Macht Scope
recheck Eine erneute Prüfung eines Problems einplanen issues:recheck
run_agentic_check Die Agentic-Browsing-Prüfung für eine Seite neu ausführen issues:recheck
start_audit Jetzt ein vollständiges Audit starten, optional mit Seitenbudget audits:run
apply Neue SEO-Titel, Beschreibungen, Canonicals oder noindex einer Aktion genehmigen und in WordPress schreiben actions:apply
apply_llms_txt Eine neue llms.txt genehmigen und in WordPress schreiben actions:apply
apply_ai_crawler_rules Erlauben- oder Sperren-Regeln für KI-Crawler genehmigen und in die robots.txt schreiben actions:apply
update_competitors Einen Wettbewerber auswählen, ausblenden oder hinzufügen; Auswählen oder Hinzufügen fragt seine Keyword-Lücken innerhalb Ihres Datenlimits ab actions:apply
update_outreach_target Status (zu kontaktieren, kontaktiert, aufgenommen, abgelehnt) und Notiz eines Outreach-Ziels setzen actions:apply

Beispielgespräch

„Welche meiner Websites hat diesen Monat die meisten Klicks verloren, und was ist die wichtigste Aktion dafür?“

Der Assistent ruft einmal portfolio auf, wählt die Website mit dem größten Rückgang, ruft dann list_actions für sie auf und antwortet mit der Aktion und ihrem geschätzten Gewinn. Wenn Sie „wende es an“ sagen, liest er die vorgeschlagenen Werte mit issue_detail, ruft apply auf, und die Änderung erscheint in der Aktivität der App mit Undo.

Häufige Fragen

Welche Clients funktionieren?

Alles, was MCP über Streamable HTTP unterstützt: Claude Code, Claude.ai, Claude Desktop, ChatGPT (Connectors im Entwicklermodus), Cursor, Windsurf und andere.

Kann der Assistent meine Website kaputt machen?

Nur drei Tools ändern Ihre Website: apply, apply_llms_txt und apply_ai_crawler_rules. Sie folgen denselben Regeln wie die Schaltflächen in der App: nur verbundene WordPress-Websites, die Person hinter dem Schlüssel wird als Genehmiger festgehalten, danach folgt eine Prüfung, und in der App gibt es 30 Tage lang Undo. recheck, run_agentic_check und start_audit lesen Ihre Website nur erneut. update_outreach_target und update_competitors ändern nur Daten in MonoRanks: Status und Notiz eines Ziels oder welche Wettbewerber Sie verfolgen.

Warum braucht ChatGPT keinen Schlüssel?

Clients, die die Anmeldung selbst finden, nutzen OAuth 2.1: Sie werden zur Anmeldung geschickt und genehmigen den Zugriff einmal; können Sie mehr als Ihre eigenen Websites öffnen, wird gefragt, wohin verbunden werden soll. Das Token, das der Client erhält, steht für einen Workspace-Schlüssel mit den Lese-Scopes und erneuten Prüfungen, die Sie genehmigt haben, nie mit Audits oder Schreibzugriff. Es ist unter Settings → Developer access aufgelistet und widerrufbar.