Añadir el servidor MCP de Storelift a Cursor

Cómo se comprobó esta guía

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

Siga leyendo