# Añadir el servidor MCP de Storelift a Claude Code

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

Los pasos para conectar el servidor MCP de Storelift a Claude Code; la versión, los requisitos y las respuestas de error se midieron en el propio servidor.

## Cómo se comprobó esta guía

NOTE: Cómo se comprobó (2026-10-11). El lado del servidor se midió con storelift-mcp 1.1.1: handshake, lista de herramientas, llamadas de lectura, respuestas de error y retirada del acceso. Visto en Claude Code: 2.1.296 · stdio, clave de API: se conecta, lista las 8 herramientas, se quita limpiamente con el comando de eliminación; 2.1.296 · Streamable HTTP, clave de API en una cabecera: se conecta, lista las 8 herramientas. Todavía no se ha probado una llamada a una herramienta desde dentro de Claude Code; los pasos de abajo siguen la documentación del propio Claude Code.

Documentación de Claude Code: code.claude.com.

## Versión

Esta guía describe el servidor que está en producción: storelift-mcp 1.1.1 en npm (2026-09-14) y el endpoint alojado https://storelift.net/mcp, ambos con las mismas 8 herramientas: get_ai_visibility, get_charts, get_history, get_keywords, get_reviews, get_rivals, get_store_page, list_apps.

Todas las herramientas de esta versión leen; ninguna cambia nada en su cuenta. El servidor local responde por stdio con la versión de protocolo 2024-11-05; el endpoint alojado, por Streamable HTTP con 2025-06-18. El endpoint no guarda estado: no hay identificador de sesión ni flujo de eventos enviado por el servidor.

## Requisitos

- Plan. El acceso MCP requiere el plan Pro, Studio o Enterprise, tanto con clave de API como con inicio de sesión (OAuth).
- Clave. Storelift → Ajustes → Claves de API. La clave empieza por sl_live_. Las claves de esta versión no llevan permisos: una clave lee todas las apps de su espacio de trabajo. Guárdela únicamente en la configuración del cliente.
- Entorno de ejecución. Node.js 18 o posterior para el servidor local (npx descarga el paquete en la primera ejecución). El endpoint alojado no necesita instalar nada.
- Claude Code. Cualquier versión reciente; los comandos de abajo proceden de claude mcp add --help y de la documentación de MCP de Claude Code.

## Configuración

Servidor local con una clave de API (ejecútelo en el directorio de su proyecto; el ámbito predeterminado es solo este proyecto):

claude mcp add storelift -e STORELIFT_API_KEY=sl_live_... -- npx -y storelift-mcp

O bien el endpoint alojado, sin nada que instalar y con la clave en una cabecera:

claude mcp add --transport http storelift https://storelift.net/mcp --header "Authorization: Bearer sl_live_..."

Para iniciar sesión (OAuth) en lugar de usar una clave, añada el endpoint sin cabecera y luego ejecute /mcp dentro de Claude Code:

claude mcp add --transport http storelift https://storelift.net/mcp

Compruebe la conexión con claude mcp list; la línea debe decir ✔ Connected.

## Primera lectura

Pregunte: “Lista mis apps de Storelift y luego muéstrame las posiciones de las palabras clave de la primera en EE. UU.” El asistente llama primero a list_apps y después a get_keywords para la app que usted elija. La respuesta de list_apps tiene este aspecto (datos de ejemplo de Storelift, 2026-09-28; su cuenta devuelve sus propias apps):

{
"apps": [
{
"id": "sbx-lumen",
"name": "Lumen — Sleep Sounds",
"countries": [
"us",
"gb",
"de"
],
"keywords": [
"sleep sounds",
"white noise",
"rain sounds"
]
}
]
}

get_keywords devuelve una fila por cada palabra clave seguida:

{
"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 número en rank es la posición; null significa que la palabra clave se midió y la app no está en los resultados; measured: false significa que no se pudo medir. Los tres casos se mantienen separados: contar como cero un día sin medir da una respuesta equivocada.

La conexión funciona. A continuación, tres primeras tareas: qué palabras clave bajaron, quién está por delante en ellas y qué decir cuando una palabra clave no tiene medición hoy, cada una con la respuesta que cabe esperar.

## Retirar el acceso

1. Ejecute claude mcp remove storelift. En una conexión con inicio de sesión, Claude Code borra también los tokens que guardó; /mcp → Clear authentication hace lo mismo sin quitar el servidor.
2. Elimine la clave en Storelift → Ajustes → Claves de API. La siguiente solicitud con esa clave se rechaza (un error de herramienta en el servidor local, HTTP 401 en el endpoint alojado); no hay ninguna sesión abierta que esperar a que caduque.
3. Si se conectó con inicio de sesión (OAuth), quite la conexión en Ajustes → API → Apps conectadas; el token de esa conexión recibe un 401 en su siguiente solicitud.

## Solución de problemas

| Lo que ve | Por qué | Qué hacer |
| --- | --- | --- |
| “No API key was sent…” | El servidor local arrancó sin clave. Las herramientas se listan igualmente, pero cada llamada devuelve esto. | Añada STORELIFT_API_KEY a la configuración del servidor y reinicie el cliente. |
| “This API key is not valid…” | La clave está mal escrita o se eliminó. El endpoint alojado responde HTTP 401. | Cree una clave nueva en Ajustes → Claves de API y sustituya la de la configuración. |
| “The Public API is available on the Pro and Studio plans…” | El plan de la cuenta no da acceso MCP (HTTP 403). En esta versión el acceso está en Pro, Studio o Enterprise. | Cambie a un plan superior en storelift.net/pricing; la clave se conserva y vuelve a funcionar en cuanto el plan lo permita. |
| “fetch failed…” | El servidor local no pudo conectar con Storelift: red, proxy o cortafuegos. | Compruebe que este equipo puede acceder a https://storelift.net; defina STORELIFT_API solo si le han indicado un endpoint distinto. |
| ✘ Failed to connect en claude mcp list | El servidor no arrancó (falta Node.js o es demasiado antiguo) o el endpoint no respondió a tiempo. | Ejecute node --version; si el arranque es lento, aumente el tiempo de espera de inicio, por ejemplo MCP_TIMEOUT=10000 claude. |