Storelift

Storelift › Guías › Añadir el servidor MCP de Storelift a Claude Code

Capa de IA

Añadir el servidor MCP de Storelift a Claude Code

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.

Empezar gratis →Plan gratuito: 1 app, 25 palabras clave en cada una de 2 tiendas, 30 días de historial, sin tarjeta y sin fecha de fin. Pro cuesta $20/mes.

Por Actualizado: 4 min de lectura

Seguimiento de palabras clave · historial de posiciones, movimientos de la semana y palabras clave seguidas

Cómo se comprobó esta guía

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):

Terminal
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:

Terminal
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:

Terminal
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):

JSON
{
  "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:

JSON
{
  "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 vePor 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 listEl 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.

Compruébelo con su propia app

Pegue el enlace de su app y añada sus palabras clave. Cada día se miden la posición, las apps por encima de usted y la demanda.

Plan gratuito: 1 app, 25 palabras clave en cada una de 2 tiendas, 30 días de historial, sin tarjeta y sin fecha de fin. Pro cuesta $20/mes.

Empezar gratis →
Grupos de competidores · los términos que comparte con un competidor y los que solo tiene él

Siga leyendo