Claude te hará unas preguntas, te recomendará una vía y te dirá exactamente qué pulsar en Lightspeed. Solo tienes que seguirle.
Quiero conectar mi tienda Lightspeed a Claude Code para que puedas consultar mis pedidos, productos y clientes. No soy técnico: guíame paso a paso, un paso cada vez, y espera a que te confirme antes de seguir.
CONTEXTO PARA TI
- Lightspeed vende varias cosas con el mismo nombre. Esto es para la tienda online clásica (Lightspeed la llama "eCom"). Si mi tienda viene de Ecwid, o si Lightspeed es solo mi caja registradora física, este plan no encaja: dímelo.
- No hay conector listo del propio Lightspeed ni complemento de Claude ya preparado. Hay dos vías:
1. Vía oficial, la API de Lightspeed (la recomendada): necesita el plan Advanced o Professional. En el panel de administración, Settings > API, se crea una clave y un código secreto. Importa si la tienda está alojada en Europa o en Estados Unidos, porque cambia la dirección a la que llamas. Se autentica con la clave y el secreto juntos en cada llamada, por ejemplo: curl -s -u "$LIGHTSPEED_API_KEY:$LIGHTSPEED_API_SECRET" "https://$LIGHTSPEED_CLUSTER/products.json?limit=20". Puede leer y cambiar productos, pedidos, clientes y descuentos, y avisar de eventos (un pedido nuevo, poco stock). Hay un límite de llamadas por minuto.
2. Atajo de Apideck (una conexión MCP hecha por otra empresa): cuenta gratuita en Apideck, se conecta la tienda desde su panel (Vault) y te da tres códigos: API key, App ID y Consumer ID. Solo cubre pedidos, productos y clientes, los datos pasan por los sistemas de Apideck y puede tener coste. Si Apideck cae o deja de mantenerlo, deja de funcionar.
QUÉ QUIERO QUE HAGAS
1. ENTENDER: pregúntame, de una en una y con opciones para elegir: qué tipo de Lightspeed tengo (tienda online eCom, Ecwid, caja registradora o no lo sé), qué quiero conseguir (solo consultar, o también cambiar stock, productos o pedidos), si sé qué plan tengo (Advanced, Professional, otro o no lo sé) y si es para probar rápido o para usarlo en serio a largo plazo.
2. RECOMENDAR: dime en dos frases qué vía encaja y por qué. Por defecto, la vía oficial si mi plan es Advanced o Professional: no depende de otra empresa y yo decido qué puede tocar Claude. Propón el atajo de Apideck solo si quiero probar rápido y me bastan pedidos, productos y clientes, y avísame de que mis datos pasan por Apideck.
3. REVISAR: comprueba tú mismo lo que puedas en este ordenador (si está curl y si ya existen las variables LIGHTSPEED_API_KEY, LIGHTSPEED_API_SECRET y LIGHTSPEED_CLUSTER). Ayúdame a comprobar si mi tienda está en Europa o en Estados Unidos. Instala lo que falte pidiéndome permiso antes.
4. GUIARME EN LIGHTSPEED (o en Apideck): dime exactamente qué menú y qué botón pulsar, un paso cada vez. Si algo no coincide con lo que veo, pídeme una captura de pantalla.
5. CÓDIGOS SECRETOS: nunca me pidas que te escriba la clave, el secreto ni los códigos de Apideck en el chat; basta con que los copie. Hazlo así, un dato cada vez: dime exactamente qué copiar y de dónde; cuando te diga «OK», léelo tú del portapapeles (pbpaste en Mac; Get-Clipboard de PowerShell en Windows) y guárdalo directamente donde toque, sin mostrarlo, repetirlo ni escribirlo en el chat. Comprueba solo que no está vacío y después vacía el portapapeles. Guárdalos como variables de entorno de usuario (en Mac, una línea export en ~/.zshrc; en Windows, [Environment]::SetEnvironmentVariable con ámbito User) (para la vía oficial, LIGHTSPEED_API_KEY y LIGHTSPEED_API_SECRET, más LIGHTSPEED_CLUSTER con la dirección de Europa o Estados Unidos), nunca en un fichero del proyecto, y léelos desde ahí.
6. PROBAR: haz una consulta pequeña de solo lectura (por ejemplo, listar 5 productos o mis últimos 5 pedidos) y enséñame el resultado para confirmar que funciona.
7. RECORDAR: crea una skill personal con cómo conectarte, si mi tienda está en Europa o en Estados Unidos, qué puedes hacer y la regla de que por defecto es solo lectura. Así la próxima vez me basta con preguntarte. Si más gente de mi equipo lo va a usar, dime cómo dejarlo en la configuración compartida de la empresa.
Reglas: nada de cambiar pedidos, stock, productos ni clientes salvo que yo lo pida de forma explícita, y en ese caso enséñame antes exactamente qué vas a cambiar y espera mi OK. Si el código secreto se filtra alguna vez, ayúdame a cambiarlo enseguida. Si algo falla, explícamelo en lenguaje sencillo antes de intentar arreglarlo.
CÓMO TRABAJAR CONMIGO
- Explícame cada paso como a un niño de 10 años: frases cortas, sin jerga y, si usas una palabra técnica, dime en una línea qué es. Si te digo que soy técnico, ve al grano.
- Cuando tengas que preguntarme algo, hazlo de una pregunta en una y con opciones para elegir (usa la herramienta de preguntas con opciones si la tienes), con una línea que explique cada opción.
- Si hay que instalar algo, dime en una línea qué es y para qué sirve, y ofrécete a instalarlo tú con mi permiso. Si algo falla, cuéntame en palabras sencillas qué ha pasado y cuál es el siguiente intento, antes de probarlo.
- Lo que te cuento arriba puede haberse quedado viejo. Antes de empezar, comprueba en la documentación oficial que sigue vigente; si algo no coincide, manda la documentación y dime qué ha cambiado.
- Si tienes navegador (el navegador integrado de la app de Claude o Claude in Chrome), hazlo tú todo lo que puedas en vez de mandarme a una web: ábrela tú, navega hasta la pantalla exacta, rellena lo que no sea secreto y léeme lo que haga falta. Si arriba pone que yo vaya a una página o pulse algo, tómalo como lo que hay que conseguir y hazlo tú con el navegador. Pídeme a mí, de un paso en uno, solo lo que no puedes hacer: iniciar sesión, aprobar permisos, pagar o copiar una clave; tú no escribes contraseñas ni claves en ninguna web. Si no tienes navegador, entonces guíame con instrucciones.
- Si hacen falta claves o algo más para conectarte (scripts, configuración), guárdalo en un sitio fijo de mi usuario, fuera de esta carpeta y de cualquier repositorio, que solo yo pueda leer. Nunca en el chat ni dentro de una skill.
- La skill de RECORDAR, hazla personal (que funcione desde cualquier carpeta) y apunta en ella: cómo conectarte, con qué cuenta o usuario, dónde están las claves (el sitio, nunca el valor), qué suelo pedirte, las reglas de arriba y la fecha en que comprobaste la documentación. Si algo deja de funcionar porque el servicio cambió, mira la documentación, arréglalo y actualiza la skill.
- Mis preferencias y lo que haya fallado van en un LEARNINGS.md aparte, en la misma carpeta de esa skill (una línea por aprendizaje, con fecha y el porqué). El primer paso de la skill es leerlo y aplicarlo. Para que nunca se te olvide proponer aprendizajes nuevos al terminar, añade al frontmatter de su SKILL.md este hook, cambiando <nombre-de-la-skill> por su nombre (inyecta un recordatorio una vez por uso; no lo cambies por un bloqueo, que entra en bucle):
hooks:
Stop:
- hooks:
- type: command
once: true
command: |
grep -q '"stop_hook_active":true' && exit 0
echo '{"hookSpecificOutput":{"hookEventName":"Stop","additionalContext":"Antes de terminar: si en este uso de la skill <nombre-de-la-skill> el usuario corrigió algo, algo falló o mostró una preferencia, propón de 0 a 3 aprendizajes para su LEARNINGS.md (fecha, una línea y el porqué), enséñalos y pide OK antes de escribirlos. Si ya propusiste aprendizajes en este turno, no los repitas. Si no hay nada que aprender, termina sin añadir nada."}}'