# Añadir el servidor MCP de Storelift a Cursor

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

Los pasos para conectar el servidor MCP de Storelift a Cursor; 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 Cursor: cursor-agent 2025.09.17-25b418f · stdio, clave de API: se conecta, lista las 8 herramientas. Todavía no se ha probado una llamada a una herramienta desde dentro de Cursor; los pasos de abajo siguen la documentación del propio Cursor.

Documentación de Cursor: cursor.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.
- Cursor. El editor y la CLI de Cursor leen el mismo mcp.json: .cursor/mcp.json en un proyecto o ~/.cursor/mcp.json para todos los proyectos.

## Configuración

Servidor local con una clave de API; añada esto a .cursor/mcp.json:

{
"mcpServers": {
"storelift": {
"command": "npx",
"args": [
"-y",
"storelift-mcp"
],
"env": {
"STORELIFT_API_KEY": "sl_live_..."
}
}
}
}

O bien el endpoint alojado con inicio de sesión (OAuth): Cursor abre el inicio de sesión en su navegador para los servidores que lo piden.

{
"mcpServers": {
"storelift": {
"url": "https://storelift.net/mcp"
}
}
}

De forma predeterminada, Cursor pide aprobación antes de usar herramientas MCP. Desde la línea de comandos, cursor-agent mcp list-tools storelift comprueba la conexión y lista las herramientas con sus argumentos.

## 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. En Cursor, desactive el servidor o quítelo en Customize, o borre la entrada storelift de mcp.json. Desde la CLI, cursor-agent mcp disable storelift impide que se cargue.
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. |
| El endpoint alojado le pide iniciar sesión aunque configuró una cabecera Authorization | Cursor CLI 2025.09.17 no envió la cabecera configurada al conectarse, así que el endpoint respondió 401 y pidió iniciar sesión. | Use el servidor local (la clave va en env) o inicie sesión. |