# Ajouter le serveur MCP de Storelift à Cursor

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

Les étapes pour connecter le serveur MCP de Storelift à Cursor ; la version, les prérequis et les réponses d'erreur ont été mesurés sur le serveur lui-même.

## Comment ce guide a été vérifié

NOTE: Comment ce guide a été vérifié (2026-10-11). Le côté serveur a été mesuré avec storelift-mcp 1.1.1 : handshake, liste des outils, appels de lecture, réponses d'erreur et retrait de l'accès. Constaté dans Cursor : cursor-agent 2025.09.17-25b418f · stdio, clé API: se connecte, liste les 8 outils. Aucun appel d'outil n'a été essayé depuis Cursor ; les étapes ci-dessous suivent la documentation de Cursor.

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 (npx ré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.json dans un projet, ou ~/.cursor/mcp.json pour 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

1. Dans Cursor, désactivez le serveur ou retirez-le sous Customize, ou supprimez l'entrée storelift de mcp.json. Depuis la CLI, cursor-agent mcp disable storelift empêche son chargement.
2. 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.
3. 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://storelift.net ; 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. |