# Connecter Storelift à Claude comme connecteur personnalisé

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

Les étapes pour connecter le serveur MCP de Storelift à Claude ; 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 : claude.ai custom connector · Streamable HTTP, connexion au compte: se connecte, liste les 8 outils. Aucun appel d'outil n'a été essayé depuis Claude ; les étapes ci-dessous suivent la documentation de Claude.

Documentation de Claude : support.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.
- Claude. Les connecteurs personnalisés fonctionnent sur les plans Free, Pro, Max, Team et Enterprise de Claude ; Free est limité à un seul connecteur personnalisé, et sur Team seuls les propriétaires en ajoutent. Un connecteur ajouté dans Claude est aussi disponible dans Claude Desktop.

## Configuration

1. Dans Claude, ouvrez Customize → Connectors, cliquez sur + Add, puis sur Add custom connector. Sur Team et Enterprise, un propriétaire passe par Organization settings → Connectors → Add → Custom → Web.
2. Nommez-le Storelift, saisissez https://storelift.net/mcp comme URL et enregistrez.
3. Cliquez sur Connect. Claude vous envoie vers une page Storelift qui indique l'app à l'origine de la demande et l'adresse vers laquelle vous revenez ; connectez-vous si nécessaire, puis autorisez l'accès.
4. Dans une nouvelle conversation, vérifiez dans le menu des outils que Storelift est activé : list_apps et les autres outils y figurent.

Claude peut aussi ajouter un connecteur avec un en-tête fixe (une clé API) ; avec Storelift, la connexion au compte est le chemin le plus court, sans clé à copier.

## 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 Claude, ouvrez Customize → Connectors et choisissez Remove à côté de Storelift (sur Team et Enterprise, un propriétaire le fait sous Organization settings).
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 |
| --- | --- | --- |
| “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. |
| Add custom connector n'est pas proposé | Sur le plan Free de Claude, la limite est d'un seul connecteur personnalisé, et sur Team seuls les propriétaires ajoutent des connecteurs. | Retirez un autre connecteur personnalisé, ou demandez à un propriétaire d'ajouter Storelift. |