RebundleRebundle Stack
Claude Code Hub

Integraciones · Lightspeed

Conecta Lightspeed a Claude Code

Pega un prompt. Claude te pregunta qué necesitas, elige la mejor forma de conectar tu tienda y te guía paso a paso.

Es para la tienda online clásica de Lightspeed (eCom) y necesitas acceso a su panel de administración. Claude empieza en modo solo lectura y nunca te pedirá que pegues un código secreto en el chat.
1

Abre Claude Code

Tú haces esto
  1. 1Abre Claude Desktop
  2. 2Haz clic en la pestaña Claude Code
  3. 3Elige cualquier carpeta para trabajar
2

Pega este prompt

Claude Code

Claude te hará unas preguntas, te recomendará una vía y te dirá exactamente qué pulsar en Lightspeed. Solo tienes que seguirle.

dile esto a claude
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."}}'

Después, prueba con estos

Cuando Claude confirme que está conectado, pídele cosas como:

¿Cuántos pedidos entraron hoy?

¿Qué productos tienen menos de 5 unidades en stock?

¿Cuáles son mis últimos 5 pedidos?

Busca el producto X en el catálogo

Las dos vías en detalle

Lo que el prompt sopesa por ti, para quien prefiera montarlo a mano.

Lightspeed vende más de una cosa bajo el mismo nombre. Esta guía es para la tienda online clásica (a la que Lightspeed llama "eCom"). Si tu tienda en realidad viene de Ecwid (una empresa que Lightspeed compró y que también vende con su propio nombre), o si Lightspeed es solo tu caja registradora física, esta guía no encajará del todo con lo que tienes — si no estás seguro, pregúntale a quien montó tu tienda. Tampoco existe un conector listo hecho por el propio Lightspeed, ni ningún complemento de Claude ya preparado para esto: las dos opciones reales son la vía oficial de aquí abajo, o un atajo ya construido por otra empresa (Apideck).
Oficial · directo con Lightspeed

La vía oficial

Claude habla directo con Lightspeed, sin nada en medio. La opción más sólida, y la que te da más control.

Lightspeed tiene una puerta oficial para que otros programas, como Claude, hablen con tu tienda. En la jerga técnica se llama API — imagínatelo como una recepción muy bien vigilada que solo deja pasar a quien tiene la llave correcta. A través de ella, Claude puede consultar (y, si tú lo permites, cambiar) tus productos, pedidos, clientes, descuentos y más, siguiendo exactamente las mismas reglas que usa el propio Lightspeed.

Qué necesitas
  • Tu tienda necesita el plan Advanced o Professional de Lightspeed — los planes básicos no incluyen esta puerta.
  • Una clave y un código secreto, generados por ti desde tu panel de administración de Lightspeed — piénsalo como una contraseña especial solo para Claude.
  • Saber si tu tienda está alojada en Europa o en Estados Unidos — Claude puede ayudarte a comprobarlo, solo cambia un detalle técnico por detrás.
Qué puede hacer
  • Puede leer, y también cambiar, tus productos, pedidos, clientes y descuentos — prácticamente todo lo que tiene tu tienda.
  • Puede avisarte automáticamente cuando pasa algo — un pedido nuevo, poco stock — sin que tengas que preguntar.
  • Tú decides exactamente qué partes de tu tienda puede tocar Claude.
Lo que no hace
  • Solo está disponible en los planes más caros de Lightspeed.
  • No hay una app lista para instalar — quien lo monte tiene que escribir algo de código (Claude puede encargarse de casi todo eso por ti).
  • Hay un límite de cuántas preguntas se pueden hacer por minuto — algo que no notarás en el día a día.
Riesgos
  • Guarda ese código secreto en un lugar seguro — nunca lo pegues en el chat, ni lo guardes donde otros puedan verlo.
  • Si le das permiso a Claude para hacer cambios, podría modificar pedidos o stock de verdad — empieza dejando que solo mire, no que toque nada.
  • Si ese código secreto llega a filtrarse, quien lo tenga puede entrar a toda tu tienda — cámbialo enseguida si eso pasa.
Para quien lo monte (unos detalles técnicos)
  1. 1Que Claude cree una pequeña carpeta de proyecto para esto, con un archivo corto que explique qué puede hacer — por defecto, solo mirar, nunca cambiar nada, salvo que tú digas lo contrario.
  2. 2Guarda tu clave y tu código secreto en un lugar seguro de tu ordenador (Claude puede montarte esto) — nunca los escribas dentro de ese archivo ni los pegues en el chat.
  3. 3Claude usa tu clave y tu código secreto juntos, cada vez, para demostrarle a Lightspeed que de verdad eres tú quien pregunta.
  4. 4Si más de una persona de tu equipo va a usar esto, guárdalo en la configuración compartida de la empresa para que todos tengan el mismo acceso revisado.
# 1. List products (read-only)
curl -s -u "$LIGHTSPEED_API_KEY:$LIGHTSPEED_API_SECRET" \
"https://$LIGHTSPEED_CLUSTER/products.json?limit=20"

# 2. A specific order
curl -s -u "$LIGHTSPEED_API_KEY:$LIGHTSPEED_API_SECRET" \
"https://$LIGHTSPEED_CLUSTER/orders/12345.json"
Atajo · hecho por Apideck

El atajo de Apideck

Una empresa llamada Apideck ya construyó esta conexión por ti. Se monta mucho más rápido, pero tus datos también pasan por sus sistemas.

Lightspeed no ofrece un atajo propio. Una empresa llamada Apideck construyó uno: creas una cuenta gratuita con ellos, conectas tu tienda Lightspeed desde su panel (llamado Vault), y te dan un par de códigos para conectar directo a Claude. A partir de ahí, cada pregunta que hace Claude pasa primero por Apideck, y de ahí a Lightspeed. Solo cubre pedidos, productos y clientes — no todo lo que tiene tu tienda.

Qué necesitas
  • Una cuenta gratuita en Apideck, con tu tienda Lightspeed conectada desde su panel.
  • El par de códigos que te da su panel justo después de conectar.
  • Pedirle a Claude que añada esta conexión usando esos códigos — un montaje de una sola vez.
Qué puede hacer
  • Preguntar y actuar en lenguaje natural sobre pedidos, productos y clientes — sin escribir código.
  • Listo en minutos — no tienes que construir ni mantener nada.
  • Cualquiera de tu equipo con acceso lo usa exactamente igual.
Lo que no hace
  • Solo cubre pedidos, productos y clientes — no el resto de lo que puede hacer Lightspeed.
  • No lo hace Lightspeed — si Apideck tiene una caída o deja de mantenerlo, esto deja de funcionar también.
  • La información de tu tienda viaja por los sistemas de Apideck de camino a Claude.
Riesgos
  • Revisa las condiciones y la reputación de Apideck antes de darle información real de pedidos o clientes.
  • Tus códigos de conexión viven dentro del panel de Apideck, no bajo tu control total — trata esa cuenta como tratarías el acceso a un banco.
  • Si Apideck cambia sus precios o planes más adelante, esta conexión depende de esa decisión externa.

Cara a cara

La vía oficialEl atajo de Apideck
Soporte oficialSí, de LightspeedNo, de otra empresa
Cómo se montaCon ayuda técnica (o de Claude)Cuenta gratis + un par de códigos
Qué puede ver y tocarPrácticamente toda tu tiendaSolo pedidos, productos y clientes
¿Solo mira, o también cambia cosas?Ambas, según lo que tú permitasAmbas, pero solo en esas 3 áreas
Control sobre ClaudeAlto — decides túMedio — es una herramienta genérica
CostePlan alto de LightspeedTu plan de Lightspeed + posible coste de Apideck
MantenimientoQuien lo montóApideck
Mejor paraUso serio, a largo plazoProbarlo rápido

Recomendación

Si puedes, elige la vía oficial: no depende de otra empresa, con el tiempo puede llegar a cualquier parte de tu tienda, y tú decides exactamente qué puede tocar Claude. El atajo de Apideck es más rápido de probar, pero solo cubre pedidos, productos y clientes, y tus datos pasan por los sistemas de Apideck en el camino. Sea cual sea el camino: empieza dejando que Claude solo mire, sin cambiar nada, y guarda tus códigos secretos en un lugar seguro — nunca los pegues en el chat ni los guardes donde otros puedan verlos.

Paso a paso

Elige tu vía

1

Consigue tu clave

Tú haces esto

Entra al panel de administración de tu tienda Lightspeed → Settings → API, y crea una clave y un código secreto. ¿No sabes si tu tienda está alojada en Europa o en Estados Unidos? Claude puede ayudarte a comprobarlo.

2

Deja que Claude monte la conexión

Claude Code

Claude Code se encarga de la parte técnica: guarda tus códigos en un lugar seguro de tu ordenador y comprueba que todo funciona.

dile esto a claude
Quiero conectar mi tienda Lightspeed a Claude Code. Haz esto en orden: 1. Crea una pequeña carpeta de proyecto para esta conexión, con un archivo corto que documente: si mi tienda está en Europa o en Estados Unidos, qué puede hacer, y que por defecto es de solo lectura (mirar, no cambiar nada). 2. Pídeme mi clave y mi código secreto de Lightspeed y guárdalos de forma segura en mi ordenador (nunca los escribas en ese archivo ni en el chat). 3. Prueba la conexión con una comprobación de solo lectura — por ejemplo, lista algunos productos para confirmar que funciona. 4. Si funciona, recuerda que uso esta conexión para leer (y, si lo autorizo más adelante, cambiar) mi catálogo y pedidos de Lightspeed desde Claude Code.
3

Pregúntale con tus propias palabras

Tú haces esto

A partir de aquí, simplemente pregunta cosas como "¿cuántos pedidos entraron hoy?" o "actualiza el stock del producto X" — Claude se encarga de la parte técnica.

Prueba con estos prompts

Una vez conectado, simplemente pídeselo a Claude con tus palabras — funciona igual sin importar qué vía elegiste:

¿Cuántos pedidos entraron hoy?

Busca el producto X en el catálogo

¿Qué productos tienen menos de 5 unidades en stock?

Actualiza el stock del producto Y a 20 unidades

Rebundle · Stack de IA curado