# Den MCP-Server von Storelift zu Claude Code hinzufügen

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

So verbinden Sie den MCP-Server von Storelift mit Claude Code; 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 Claude Code beobachtet: 2.1.296 · stdio, API-Schlüssel: verbindet sich, listet die 8 Tools auf, lässt sich mit dem Befehl zum Entfernen sauber wieder entfernen; 2.1.296 · Streamable HTTP, API-Schlüssel im Header: verbindet sich, listet die 8 Tools auf. Ein Tool-Aufruf aus Claude Code heraus wurde nicht ausprobiert; die Schritte unten folgen der Dokumentation von Claude Code.

Dokumentation von Claude Code: code.claude.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.
- Claude Code. Jede aktuelle Version; die Befehle unten stammen aus claude mcp add --help und aus der MCP-Dokumentation von Claude Code.

## Einrichtung

Lokaler Server mit einem API-Schlüssel (im Projektverzeichnis ausführen; standardmäßig gilt der Eintrag nur für dieses Projekt):

claude mcp add storelift -e STORELIFT_API_KEY=sl_live_... -- npx -y storelift-mcp

Oder der gehostete Endpunkt, ganz ohne Installation, mit dem Schlüssel im Header:

claude mcp add --transport http storelift https://storelift.net/mcp --header "Authorization: Bearer sl_live_..."

Wenn Sie sich anmelden möchten (OAuth), statt einen Schlüssel zu verwenden, fügen Sie den Endpunkt ohne Header hinzu und führen dann in Claude Code /mcp aus:

claude mcp add --transport http storelift https://storelift.net/mcp

Prüfen Sie die Verbindung mit claude mcp list; in der Zeile sollte ✔ Connected stehen.

## 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. Führen Sie claude mcp remove storelift aus. Bei einer Verbindung per Anmeldung löscht Claude Code auch die gespeicherten Tokens; /mcp → Clear authentication erledigt dasselbe, ohne den Server zu entfernen.
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. |
| claude mcp list zeigt ✘ Failed to connect | Der Server ist nicht gestartet (Node.js fehlt oder ist zu alt), oder der Endpunkt hat nicht rechtzeitig geantwortet. | Führen Sie node --version aus; bei langsamem Start erhöhen Sie das Start-Timeout, z. B. MCP_TIMEOUT=10000 claude. |