MCP-Server und REST-API
Deine ASO-Daten, direkt in deinem KI-Assistenten
Mit dem MCP-Server von Rankglass lesen Claude Code, Cursor, Claude Desktop, Codex, die ChatGPT-Desktop-App und andere MCP-Clients deine getrackten Keywords, Rankings, Wettbewerber und Listing-Scores. Eine REST-API liefert deinen eigenen Skripten dieselben Daten.
Auf einen Blick
- MCP-Endpunkt
https://app.rankglass.com/api/mcp- Transport
- Streamable HTTP
- Authentifizierung
- Ein API-Schlüssel des Workspace, gesendet als Authorization: Bearer YOUR_API_KEY
- Zugriff
- Nur Lesezugriff
- Tarife
- Starter, Pro und Agency
- Rate Limits
- 60 Anfragen pro Minute und 2.000 pro Tag je Schlüssel
Funktioniert mit MCP-Clients, die einen Header senden können
Rankglass prüft bei jeder Anfrage einen API-Schlüssel, ein Client muss ihn also nur als Header senden. Für diese Clients findest du unten die Einrichtung:
- Claude Code
- Cursor
- Claude Desktop, über mcp-remote (benötigt Node.js)
- Codex und die ChatGPT-Desktop-App
- Andere MCP-Clients und eigene Agents, mit dem Endpunkt und Header von oben
Ein Client, der sich nur über eine OAuth-Anmeldung verbinden kann, kann den Schlüssel nicht senden und Rankglass daher noch nicht hinzufügen.
In drei Schritten eingerichtet
Schritt 1
API-Schlüssel erstellen
Öffne in Rankglass Einstellungen → Workspace → API & MCP und erstelle einen Schlüssel. Er wird nur einmal angezeigt, kopiere ihn also sofort. Ein Schlüssel liest einen Workspace; erstelle einen pro Assistent oder Skript, damit du jeden einzeln widerrufen kannst.
Schritt 2
Rankglass zu deinem Assistenten hinzufügen
Füge die Konfiguration für deinen Client ein und ersetze YOUR_API_KEY durch deinen Schlüssel.
Claude Code
Führe das in einem Terminal aus. Mit --scope user steht Rankglass in all deinen Projekten bereit.
claude mcp add --transport http --scope user rankglass https://app.rankglass.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"Cursor und andere Clients
Für Cursor fügst du das in ~/.cursor/mcp.json ein oder in .cursor/mcp.json in einem Projekt. Andere Clients speichern MCP-Server in ihren eigenen Einstellungen; mehr als Endpunkt und Header brauchen sie nicht.
{ "mcpServers": { "rankglass": { "url": "https://app.rankglass.com/api/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }Claude Desktop
Füge das in claude_desktop_config.json ein (Settings → Developer → Edit Config) und starte Claude dann neu. Es startet mcp-remote mit npx, daher muss Node.js installiert sein.
{ "mcpServers": { "rankglass": { "command": "npx", "args": [ "-y", "mcp-remote", "https://app.rankglass.com/api/mcp", "--header", "Authorization:${RANKGLASS_AUTH}" ], "env": { "RANKGLASS_AUTH": "Bearer YOUR_API_KEY" } } } }Codex und ChatGPT-Desktop-App
Füge das in ~/.codex/config.toml ein; diese Datei teilen sich die Codex CLI, die Codex-IDE-Erweiterung und die ChatGPT-Desktop-App. Lege deinen Schlüssel ohne Bearer in einer Umgebungsvariable namens RANKGLASS_API_KEY ab.
[mcp_servers.rankglass] url = "https://app.rankglass.com/api/mcp" bearer_token_env_var = "RANKGLASS_API_KEY"Clients, die den Authorization-Header nicht setzen können, senden stattdessen x-api-key: YOUR_API_KEY.
Schritt 3
Frag in eigenen Worten
Dein Assistent wählt das passende Tool. Keines davon kann etwas in deinem Workspace ändern.
Was dein Assistent lesen kann
11 Tools, die nur lesen. Zu jedem gibt es einen passenden GET-Endpunkt in der REST-API.
| MCP-Tool | Was es liefert | REST-Endpunkt |
|---|---|---|
list_apps | Deine Apps mit ihren Stores, getrackten Ländern, Keyword-Zahlen und den wichtigsten Zahlen dieser Woche. Ein guter erster Aufruf. | GET /v1/apps |
get_keyword_rankings | Alle getrackten Keywords einer App in einem Store und Land: Position, Veränderung in 7 Tagen, Ein- oder Austritt aus den Ergebnissen, beste Position, geschätzte Suchanfragen pro Monat, Schwierigkeit und Positionen der Wettbewerber. | GET /v1/keywords |
get_rank_changes | Die größten Ranking-Gewinne und -Verluste der letzten Tage, über alle Keywords, Stores und Länder, und Keywords, die in die Top 10 gekommen sind oder sie verlassen haben. | GET /v1/rank-changes |
get_competitors | Wettbewerber, denen du folgst, mit Bewertungen, bei wie vielen Keywords jede Seite vorne liegt, und Keywords, bei denen ein Wettbewerber in den Top 10 ist und du nicht. | GET /v1/competitors |
get_competitor_keywords | Die Keywords, für die ein Wettbewerber in einem Land rankt, auch solche, die du noch nicht trackst, mit Suchanfragen pro Monat, Schwierigkeit und beiden Positionen. | GET /v1/competitor-keywords |
get_competitor_insights | Store-Fakten eines Wettbewerbers, Bewertungen nach Sternen, Chart-Positionen, geschätzte monatliche Downloads und Umsatz sowie seine neueste KI-Rezensions-Zusammenfassung. | GET /v1/competitor-insights |
get_competitor_growthBeta | Wie ein Wettbewerber seine Nutzer gewinnt: Anzeigen, Social-Media-Konten, Creator, Store-Suche und Website, mit geschätzten Werbeausgaben, Installationen über Anzeigen und Social-Reichweite sowie der neuesten KI-Strategie. Pro und Agency. | GET /v1/competitor-growth |
get_store_page_changes | Aktuelle Änderungen an deinen Store-Seiten und denen deiner Wettbewerber: Titel, Untertitel, Beschreibung, Screenshots, Version und Versionshinweise. | GET /v1/store-page-changes |
get_aso_score | Dein ASO-Score von 0–100 für einen Store und ein Land, die Prüfpunkte dahinter, Quick Wins bei Keywords und die neuesten KI-Listing-Vorschläge. | GET /v1/aso-score |
get_weekly_brief | Das neueste Wochenbriefing deiner App: was sich geändert hat, die wahrscheinlichen Gründe und bis zu drei nächste Schritte. | GET /v1/weekly-brief |
get_keyword_game_planBeta | Der neueste Fahrplan für ein getracktes Keyword: die Zielposition und bis zu fünf Schritte, um sie zu erreichen. | GET /v1/keyword-game-plan |
REST-API
Dieselben Daten als JSON für deine eigenen Skripte, Dashboards und Tabellen. Jeder Endpunkt ist eine GET-Anfrage unter https://app.rankglass.com/api/v1 und nutzt denselben Schlüssel.
Eine erste Anfrage: die größten Ranking-Veränderungen der letzten sieben Tage.
curl "https://app.rankglass.com/api/v1/rank-changes?days=7" -H "Authorization: Bearer YOUR_API_KEY"Limits und Zugang
- Nur Lesezugriff. Die Tools und Endpunkte lesen nur, was Rankglass gespeichert hat; sie starten nie eine neue Suche. Kostenpflichtige Abfragen, etwa die Keywords eines Wettbewerbers in einem neuen Land zu finden, startest du im Dashboard.
- Jeder Schlüssel kann 60 Anfragen pro Minute und 2.000 pro Tag stellen, gemeinsam für MCP-Server und REST-API. Darüber hinaus erhalten Anfragen eine 429-Antwort mit einem Retry-After-Header.
- Zugang zu API und MCP ist in den Tarifen Starter, Pro und Agency enthalten. Ohne ihn erhalten Anfragen eine 403-Antwort.
- Ein Schlüssel liest alles in seinem Workspace, behandle ihn also wie ein Passwort. Auf der Einstellungsseite siehst du, wann jeder Schlüssel zuletzt genutzt wurde, und kannst ihn dort widerrufen.
Fragen zum Ausprobieren
- Welche meiner Keywords sind diese Woche gefallen?
- Auf welcher Position rankt meine App für „habit tracker“ in Deutschland, und wer steht über mir?
- Für welche Keywords rankt mein stärkster Wettbewerber, die ich noch nicht tracke?
- Was haben meine Wettbewerber diesen Monat an ihren Store-Seiten geändert?
- Wie hoch ist mein ASO-Score im Vereinigten Königreich, und was sollte ich zuerst beheben?
- Fasse das Briefing dieser Woche für jede meiner Apps zusammen.
Fragen zum MCP-Server
Funktioniert es mit ChatGPT?
Ja, in der ChatGPT-Desktop-App. Sie teilt ihre MCP-Server mit der Codex CLI und der Codex-IDE-Erweiterung in ~/.codex/config.toml, die deinen Schlüssel aus einer Umgebungsvariable senden kann (bearer_token_env_var); die Einrichtung oben zeigt die Konfiguration. ChatGPT im Web fügt Tools über Connectors hinzu, die nur eine OAuth-Anmeldung anbieten, und die können den Schlüssel noch nicht senden. Alles, was eine API mit einem Header aufrufen kann, kann stattdessen die REST-API nutzen.
Kann mein Assistent etwas in Rankglass ändern?
Nein. Jedes Tool und jeder Endpunkt liest nur. Apps hinzufügen, Keywords tracken und Suchen starten kannst du nur im Dashboard.
Wie aktuell sind die Daten?
So aktuell wie im Dashboard: In bezahlten Tarifen wird jedes getrackte Keyword einmal täglich geprüft, und das Wochenbriefing entsteht jeden Montag. Die Tools lesen, was Rankglass gespeichert hat, und starten nie einen Check.
Wohin gehen meine Daten?
Nur an den Client, der sie abfragt, und nur aus dem Workspace, zu dem der Schlüssel gehört. Von dort verarbeitet der Anbieter deines Assistenten sie nach seinen eigenen Bedingungen. Lösche den Schlüssel, um das jederzeit zu beenden.
Lieber eine Schritt-für-Schritt-Anleitung? Lies, wie du den MCP-Server von Rankglass einrichtest.
Finde heraus, was als Nächstes für deine App zu tun ist
Füge deine App mit einem Store-Link hinzu und sieh, wo du heute rankst.
Kostenlos startenFree-Tarif · Keine Kreditkarte · Jederzeit kündbar