Comment ce guide a été vérifié
Documentation de Cursor : cursor.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. - Cursor. L'éditeur et Cursor CLI lisent le même
mcp.json:.cursor/mcp.jsondans un projet, ou~/.cursor/mcp.jsonpour tous les projets.
Configuration
Serveur local avec une clé API. Ajoutez ceci à .cursor/mcp.json :
{
"mcpServers": {
"storelift": {
"command": "npx",
"args": [
"-y",
"storelift-mcp"
],
"env": {
"STORELIFT_API_KEY": "sl_live_..."
}
}
}
}Ou l'endpoint hébergé avec connexion au compte (OAuth) : Cursor ouvre la connexion dans votre navigateur pour les serveurs qui la demandent.
{
"mcpServers": {
"storelift": {
"url": "https://storelift.net/mcp"
}
}
}Par défaut, Cursor demande une approbation avant d'utiliser des outils MCP. En ligne de commande, cursor-agent mcp list-tools storelift vérifie la connexion et liste les outils avec leurs arguments.
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
- Dans Cursor, désactivez le serveur ou retirez-le sous Customize, ou supprimez l'entrée
storeliftdemcp.json. Depuis la CLI,cursor-agent mcp disable storeliftempêche son chargement. - 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. |
| L'endpoint hébergé vous demande de vous connecter alors que vous avez défini un en-tête Authorization | Cursor CLI 2025.09.17 n'envoyait pas l'en-tête configuré à la connexion ; l'endpoint répondait donc 401 et demandait une connexion au compte. | Utilisez le serveur local (la clé va dans env) ou connectez-vous par votre compte. |
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 →
