Comment ce guide a été vérifié
Documentation de Claude Code : code.claude.com.
Version
Ce guide décrit le serveur en ligne : storelift-mcp 1.1.1 sur npm (2026-09-14) et l'endpoint hébergé https://storelift.net/mcp, tous deux avec les mêmes 8 outils : get_ai_visibility, get_charts, get_history, get_keywords, get_reviews, get_rivals, get_store_page, list_apps.
Tous les outils de cette version sont des outils de lecture ; aucun ne modifie quoi que ce soit dans votre compte. Le serveur local répond sur stdio avec la version de protocole 2024-11-05, l'endpoint hébergé en Streamable HTTP avec 2025-06-18 ; l'endpoint est sans état, sans identifiant de session ni flux envoyé par le serveur.
Prérequis
- Plan. L'accès MCP demande le plan Pro, Studio ou Enterprise, avec une clé API comme avec la connexion au compte (OAuth).
- Clé. Storelift → Réglages → Clés API. La clé commence par
sl_live_. Dans cette version, les clés ne portent pas de scopes : une clé lit toutes les apps de son espace de travail. Ne la conservez que dans la configuration du client. - Environnement d'exécution. Node.js 18 ou plus récent pour le serveur local (
npxrécupère le paquet au premier lancement). L'endpoint hébergé ne demande aucune installation. - Claude Code. N'importe quelle version récente ; les commandes ci-dessous viennent de
claude mcp add --helpet de la documentation MCP de Claude Code.
Configuration
Serveur local avec une clé API (lancez la commande dans le répertoire de votre projet ; par défaut, la portée se limite à ce projet) :
claude mcp add storelift -e STORELIFT_API_KEY=sl_live_... -- npx -y storelift-mcpOu l'endpoint hébergé, sans rien installer, avec la clé dans un en-tête :
claude mcp add --transport http storelift https://storelift.net/mcp --header "Authorization: Bearer sl_live_..."Pour vous connecter par votre compte (OAuth) au lieu d'utiliser une clé, ajoutez l'endpoint sans en-tête, puis lancez /mcp dans Claude Code :
claude mcp add --transport http storelift https://storelift.net/mcpVérifiez la connexion avec claude mcp list ; la ligne doit afficher ✔ Connected.
Première lecture
Demandez : « Liste mes apps Storelift, puis montre les rangs par mot-clé de la première aux États-Unis. » L'assistant appelle d'abord list_apps, puis get_keywords pour l'app que vous choisissez. La réponse de list_apps ressemble à ceci (données d'exemple Storelift, 2026-09-28 ; votre compte renvoie vos propres apps) :
{
"apps": [
{
"id": "sbx-lumen",
"name": "Lumen — Sleep Sounds",
"countries": [
"us",
"gb",
"de"
],
"keywords": [
"sleep sounds",
"white noise",
"rain sounds"
]
}
]
}get_keywords renvoie une ligne par mot-clé suivi :
{
"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
}
]
}Un nombre dans rank est le rang ; null signifie que le mot-clé a été mesuré et que l'app n'est pas dans les résultats ; measured: false signifie qu'il n'a pas pu être mesuré. Les trois restent distincts : compter un jour non mesuré comme un zéro donne une réponse fausse.
La connexion fonctionne. Ensuite, trois premières tâches : quels mots-clés ont reculé, qui est devant vous sur ces termes, et que dire quand un mot-clé n'a pas de mesure aujourd'hui, chacune avec la réponse à attendre.
Retirer l'accès
- Lancez
claude mcp remove storelift. Pour une connexion par compte, Claude Code supprime aussi les jetons qu'il avait stockés ;/mcp→ Clear authentication fait la même chose sans retirer le serveur. - Supprimez la clé sous Storelift → Réglages → Clés API. La requête suivante faite avec cette clé est refusée (une erreur d'outil côté serveur local, HTTP 401 côté endpoint hébergé) ; il n'y a aucune session ouverte dont il faudrait attendre la fin.
- Si vous vous êtes connecté par votre compte (OAuth), supprimez la connexion sous Réglages → API → Apps connectées ; le jeton de cette connexion reçoit un 401 à sa requête suivante.
Dépannage
| Ce que vous voyez | Pourquoi | Que faire |
|---|---|---|
| “No API key was sent…” | Le serveur local a démarré sans clé. Les outils s'affichent quand même dans la liste, et chaque appel renvoie ce message. | Ajoutez STORELIFT_API_KEY à la configuration du serveur et redémarrez le client. |
| “This API key is not valid…” | La clé est mal saisie ou a été supprimée. L'endpoint hébergé répond HTTP 401. | Créez une nouvelle clé sous Réglages → Clés API et remplacez celle de la configuration. |
| “The Public API is available on the Pro and Studio plans…” | Le plan du compte n'ouvre pas l'accès MCP (HTTP 403). Dans cette version, l'accès est ouvert sur Pro, Studio ou Enterprise. | Passez à un plan supérieur sur storelift.net/pricing ; la clé est conservée et fonctionne de nouveau dès que le plan le permet. |
| “fetch failed…” | Le serveur local n'a pas pu joindre Storelift : réseau, proxy ou pare-feu. | Vérifiez que cette machine peut joindre https: ; ne définissez STORELIFT_API que si l'on vous a donné un autre endpoint. |
✘ Failed to connect dans claude mcp list | Le serveur n'a pas démarré (Node.js absent ou trop ancien) ou l'endpoint n'a pas répondu à temps. | Lancez node --version ; si le démarrage est lent, augmentez le délai de démarrage, par exemple MCP_TIMEOUT=10000 claude. |
Vérifiez-le pour votre propre app
Collez le lien de votre app et ajoutez vos mots-clés. Position, apps au-dessus de vous et demande sont mesurées chaque jour.
Offre gratuite : 1 app, 25 mots-clés dans chacun des 2 storefronts, 30 jours d'historique, sans carte ni date de fin. Pro coûte 20 $/mois.
Commencer gratuitement →
