# Ajouter le serveur MCP de Storelift à Claude Code

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

Les étapes pour connecter le serveur MCP de Storelift à Claude Code ; 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 Claude Code : 2.1.296 · stdio, clé API: se connecte, liste les 8 outils, se retire proprement avec la commande de suppression; 2.1.296 · Streamable HTTP, clé API dans un en-tête: se connecte, liste les 8 outils. Aucun appel d'outil n'a été essayé depuis Claude Code ; les étapes ci-dessous suivent la documentation de Claude Code.

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 (npx ré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 --help et 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-mcp

Ou 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/mcp

Vé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

1. 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.
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. |
| ✘ 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. |