MCP-Server

Endpunkt

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

Streamable HTTP, JSON-Antworten, keine Sitzung zu halten. Senden Sie einen Schlüssel als Bearer-Header, oder lassen Sie den Client Sie mit OAuth anmelden (siehe unten).

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: Settings → Connectors → Add custom connector → die URL oben. Fügen Sie den Schlüssel als Bearer-Header hinzu, wenn der Client danach fragt; sonst meldet er Sie an.

ChatGPT und andere OAuth-Clients: Fügen Sie https://app.monoranks.com/api/mcp als MCP-Server hinzu. Der Client liest /.well-known/oauth-protected-resource, registriert sich, und Sie melden sich einmal an und genehmigen die Lese-Scopes. Schreib-Scopes werden auf diesem Weg nie vergeben.

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
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	search:read
ai_visibility	Was KI-Assistenten auf Ihre beobachteten Fragen geantwortet haben, pro Woche	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 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

site_id ist nur nötig, wenn der Schlüssel mehrere Websites abdeckt; list_sites zeigt die IDs. Ein fehlender Scope kommt als Tool-Fehler zurück, der den Scope nennt. Die Tools geben dieselben Antworten wie die REST-API, daher gelten die Details dort auch hier.

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.