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.