Black Friday25 % Rabatt auf deinen ersten Monat bei Monatstarifen Angebot sichern

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

  1. 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.

  2. 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.

  3. 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-Tools und ihre REST-Endpunkte
MCP-ToolWas es liefertREST-Endpunkt
list_appsDeine Apps mit ihren Stores, getrackten Ländern, Keyword-Zahlen und den wichtigsten Zahlen dieser Woche. Ein guter erster Aufruf.GET /v1/apps
get_keyword_rankingsAlle 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_changesDie 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_competitorsWettbewerber, 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_keywordsDie 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_insightsStore-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_growthBetaWie 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_changesAktuelle Änderungen an deinen Store-Seiten und denen deiner Wettbewerber: Titel, Untertitel, Beschreibung, Screenshots, Version und Versionshinweise.GET /v1/store-page-changes
get_aso_scoreDein 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_briefDas 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_planBetaDer 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 starten

Free-Tarif · Keine Kreditkarte · Jederzeit kündbar