# Conectar Storelift a Claude como conector personalizado

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

Los pasos para conectar el servidor MCP de Storelift a Claude; 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: claude.ai custom connector · Streamable HTTP, inicio de sesión: se conecta, lista las 8 herramientas. Todavía no se ha probado una llamada a una herramienta desde dentro de Claude; los pasos de abajo siguen la documentación del propio Claude.

Documentación de Claude: support.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.
- Claude. Los conectores personalizados funcionan en los planes Free, Pro, Max, Team y Enterprise de Claude; Free está limitado a un conector personalizado y, en Team, solo los propietarios (Owners) pueden añadirlos. Un conector añadido en Claude también está disponible en Claude Desktop.

## Configuración

1. En Claude, abra Customize → Connectors, haga clic en + Add y luego en Add custom connector. En Team y Enterprise, un propietario va a Organization settings → Connectors → Add → Custom → Web.
2. Póngale el nombre Storelift, introduzca https://storelift.net/mcp como URL y guarde.
3. Haga clic en Connect. Claude le lleva a una página de Storelift que indica la app que solicita el acceso y la dirección a la que volverá; inicie sesión si hace falta y permita el acceso.
4. En un chat nuevo, compruebe en el menú de herramientas que Storelift está activado: aparecen list_apps y las demás herramientas.

Claude también puede añadir un conector con una cabecera fija (una clave de API); con Storelift, el inicio de sesión es el camino más corto y no hay ninguna clave que copiar.

## 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 Claude, abra Customize → Connectors y elija Remove junto a Storelift (en Team y Enterprise lo hace un propietario en Organization settings).
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 |
| --- | --- | --- |
| “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. |
| No se ofrece Add custom connector | En el plan Free de Claude el límite es un conector personalizado, y en Team solo los propietarios (Owners) añaden conectores. | Quite otro conector personalizado o pida a un propietario que añada Storelift. |