# Den MCP-Server von Storelift zu Cursor hinzufügen

URL: https://storelift.net/de/guide/storelift-mcp-cursor/
Language: de
Updated: 2026-10-13

So verbinden Sie den MCP-Server von Storelift mit Cursor; Version, Voraussetzungen und Fehlermeldungen wurden am Server selbst gemessen.

## So wurde diese Anleitung geprüft

NOTE: So wurde geprüft (2026-10-11). Die Serverseite wurde mit storelift-mcp 1.1.1 gemessen: Handshake, Tool-Liste, Leseaufrufe, Fehlermeldungen und das Entfernen des Zugriffs. In Cursor beobachtet: cursor-agent 2025.09.17-25b418f · stdio, API-Schlüssel: verbindet sich, listet die 8 Tools auf. Ein Tool-Aufruf aus Cursor heraus wurde nicht ausprobiert; die Schritte unten folgen der Dokumentation von Cursor.

Dokumentation von Cursor: cursor.com.

## Version

Diese Anleitung beschreibt den Server, der aktuell live ist: storelift-mcp 1.1.1 auf npm (2026-09-14) und den gehosteten Endpunkt https://storelift.net/mcp, beide mit denselben 8 Tools: get_ai_visibility, get_charts, get_history, get_keywords, get_reviews, get_rivals, get_store_page, list_apps.

Jedes Tool dieser Version liest; keines ändert etwas in Ihrem Konto. Der lokale Server antwortet über stdio mit der Protokollversion 2024-11-05, der gehostete Endpunkt über Streamable HTTP mit 2025-06-18; der Endpunkt ist zustandslos, ohne Sitzungs-ID und ohne vom Server gesendeten Stream.

## Voraussetzungen

- Tarif. Der MCP-Zugriff setzt den Tarif Pro, Studio oder Enterprise voraus, mit einem API-Schlüssel ebenso wie mit Anmeldung (OAuth).
- Schlüssel. Storelift → Einstellungen → API-Schlüssel. Der Schlüssel beginnt mit sl_live_. Schlüssel dieser Version tragen keine Scopes: Ein Schlüssel liest jede App in seinem Workspace. Bewahren Sie ihn nur in der Konfiguration des Clients auf.
- Laufzeitumgebung. Node.js 18 oder neuer für den lokalen Server (npx lädt das Paket beim ersten Start). Für den gehosteten Endpunkt muss nichts installiert werden.
- Cursor. Der Editor und die Cursor CLI lesen dieselbe mcp.json: .cursor/mcp.json in einem Projekt oder ~/.cursor/mcp.json für alle Projekte.

## Einrichtung

Lokaler Server mit einem API-Schlüssel; fügen Sie dies in .cursor/mcp.json ein:

{
"mcpServers": {
"storelift": {
"command": "npx",
"args": [
"-y",
"storelift-mcp"
],
"env": {
"STORELIFT_API_KEY": "sl_live_..."
}
}
}
}

Oder der gehostete Endpunkt mit Anmeldung (OAuth): Bei Servern, die eine Anmeldung verlangen, öffnet Cursor sie in Ihrem Browser.

{
"mcpServers": {
"storelift": {
"url": "https://storelift.net/mcp"
}
}
}

Cursor fragt standardmäßig nach Ihrer Zustimmung, bevor es MCP-Tools verwendet. Auf der Kommandozeile prüft cursor-agent mcp list-tools storelift die Verbindung und listet die Tools mit ihren Argumenten auf.

## Erste Abfrage

Fragen Sie: „Liste meine Storelift-Apps auf und zeige dann die Keyword-Ränge der ersten in den USA.“ Der Assistent ruft zuerst list_apps auf, dann get_keywords für die App, die Sie auswählen. Die Antwort von list_apps sieht so aus (Storelift-Beispieldaten, 2026-09-28; Ihr Konto liefert Ihre eigenen Apps):

{
"apps": [
{
"id": "sbx-lumen",
"name": "Lumen — Sleep Sounds",
"countries": [
"us",
"gb",
"de"
],
"keywords": [
"sleep sounds",
"white noise",
"rain sounds"
]
}
]
}

get_keywords liefert eine Zeile pro getracktem Keyword:

{
"country": "us",
"platform": "ios",
"keywords": [
{
"term": "sleep sounds",
"measured": true,
"rank": null,
"demand": 73,
"searchDepth": 200
},
{
"term": "white noise",
"measured": true,
"rank": 57,
"demand": 37,
"searchDepth": 200
}
]
}

Eine Zahl in rank ist der Rang; null heißt, das Keyword wurde gemessen und die App steht nicht in den Ergebnissen; measured: false heißt, es konnte nicht gemessen werden. Die drei Fälle bleiben getrennt: Wer einen nicht gemessenen Tag als 0 zählt, bekommt eine falsche Antwort.

Die Verbindung steht. Als Nächstes folgen drei erste Aufgaben: welche Keywords gefallen sind, wer dort vor Ihnen liegt und was zu sagen ist, wenn für ein Keyword heute keine Messung vorliegt, jeweils mit der Antwort, die Sie erwarten können.

## Zugriff entfernen

1. Schalten Sie den Server in Cursor unter Customize aus oder entfernen Sie ihn dort, oder löschen Sie den Eintrag storelift aus mcp.json. In der CLI verhindert cursor-agent mcp disable storelift, dass er geladen wird.
2. Löschen Sie den Schlüssel unter Storelift → Einstellungen → API-Schlüssel. Die nächste Anfrage mit diesem Schlüssel wird abgelehnt (ein Tool-Fehler vom lokalen Server, HTTP 401 vom gehosteten Endpunkt); es gibt keine offene Sitzung, deren Ende Sie abwarten müssten.
3. Wenn Sie sich per Anmeldung (OAuth) verbunden haben, entfernen Sie die Verbindung unter Einstellungen → API → Verbundene Apps; das Token dieser Verbindung erhält bei der nächsten Anfrage einen 401.

## Fehlerbehebung

| Was Sie sehen | Ursache | Was Sie tun |
| --- | --- | --- |
| “No API key was sent…” | Der lokale Server wurde ohne Schlüssel gestartet. Die Tools werden trotzdem aufgelistet, aber jeder Aufruf liefert diese Meldung. | Tragen Sie STORELIFT_API_KEY in die Konfiguration des Servers ein und starten Sie den Client neu. |
| “This API key is not valid…” | Der Schlüssel enthält einen Tippfehler oder wurde gelöscht. Der gehostete Endpunkt antwortet mit HTTP 401. | Erstellen Sie unter Einstellungen → API-Schlüssel einen neuen Schlüssel und ersetzen Sie damit den Schlüssel in der Konfiguration. |
| “The Public API is available on the Pro and Studio plans…” | Der Tarif des Kontos schaltet den MCP-Zugriff nicht frei (HTTP 403). In dieser Version ist der Zugriff in Pro, Studio oder Enterprise enthalten. | Wechseln Sie unter storelift.net/pricing in einen höheren Tarif; der Schlüssel bleibt erhalten und funktioniert wieder, sobald der Tarif es zulässt. |
| “fetch failed…” | Der lokale Server hat Storelift nicht erreicht: Netzwerk, Proxy oder Firewall. | Prüfen Sie, ob dieser Rechner https://storelift.net erreicht; setzen Sie STORELIFT_API nur, wenn Sie einen anderen Endpunkt erhalten haben. |
| Der gehostete Endpunkt verlangt eine Anmeldung, obwohl Sie einen Authorization-Header gesetzt haben | Cursor CLI 2025.09.17 hat den konfigurierten Header beim Verbinden nicht gesendet; der Endpunkt antwortete deshalb mit 401 und verlangte eine Anmeldung. | Nutzen Sie den lokalen Server (der Schlüssel steht in env) oder melden Sie sich an. |