Conectar la IA (MCP)

Conecta Claude, Cursor u otra IA directo a tu tienda, sin instalar nada y sin copiar llaves. Hablas normalmente ("haz un banner de Black Friday arriba"), la IA lee la guía del tema, edita el borrador, te manda el enlace de la vista previa y pide la publicación. Quien publica es siempre una persona, en el panel.

La dirección es una sola, para cualquier app compatible con MCP:

https://mcp.hystore.com.br/mcp

Antes de empezar

• El plan de la tienda tiene que incluir Tema en código con la opción Conectar la IA. Sin ella, el panel rechaza la autorización y una conexión ya hecha deja de responder.
• Quien autoriza es alguien de la tienda con permisos en el tema (mira Permisos). La IA nunca hace más de lo que esa persona puede.
• Cada conexión vale para una tienda. Para editar otra tienda, conecta de nuevo y elige la otra tienda en la pantalla de autorización.

El camino, en cualquier app

1. Agrega la dirección https://mcp.hystore.com.br/mcp en la app, como servidor MCP remoto (HTTP). Los pasos de cada app están justo abajo.
2. La app abre el navegador en la pantalla Conectar una IA a tu tienda, en el panel de Hystore. Si no iniciaste sesión, inicia primero.
3. Revisa el nombre de la app, elige la tienda y lo que la IA puede hacer y haz clic en Autorizar.
4. Vuelve a la app. La conexión aparece activa, con las herramientas de Hystore.
5. Pide algo, por ejemplo: "Usa Hystore y dime qué tienda estás editando."

Claude (web y app)

Vale para claude.ai y para la app de Claude en la computadora y en el celular: los conectores quedan en tu cuenta.

1. Abre Configuración > Conectores.
2. Haz clic en Agregar conector personalizado.
3. Completa el nombre Hystore y la URL https://mcp.hystore.com.br/mcp.
4. Haz clic en Agregar y después en Conectar. El navegador abre el panel de Hystore: autoriza (mira la pantalla de autorización).
5. En una conversación nueva, abre el menú de herramientas de la conversación y revisa que Hystore esté encendido.

Los conectores personalizados dependen del plan de tu cuenta en Claude. En cuentas de empresa (Team, Enterprise), quien administra la organización agrega el conector en la configuración de la organización, y cada persona conecta su propia cuenta después.

Claude Code

En la terminal, una vez:

claude mcp add --transport http hystore https://mcp.hystore.com.br/mcp

Para tener Hystore en todos los proyectos, y no solo en la carpeta actual, agrega --scope user:

claude mcp add --transport http --scope user hystore https://mcp.hystore.com.br/mcp

Después:

1. Ejecuta claude en la carpeta donde trabajas.
2. Escribe /mcp, elige hystore y después Authenticate.
3. El navegador abre el panel: autoriza y vuelve a la terminal.
4. Pide: "Usa hystore para listar los archivos de mi tema."

Cursor

1. Abre Cursor Settings > MCP (en versiones nuevas, Tools & Integrations) y haz clic en New MCP Server. Cursor abre el archivo mcp.json.
2. Pega:

{
  "mcpServers": {
    "hystore": { "url": "https://mcp.hystore.com.br/mcp" }
  }
}

3. Guarda. Hystore aparece en la lista pidiendo inicio de sesión: haz clic en Connect (o Login) y autoriza en el navegador.
4. En el chat de Cursor (modo Agent), pide: "Usa hystore para leer el archivo layout/theme.liquid."

Para un solo proyecto, usa .cursor/mcp.json dentro de la carpeta del proyecto, con el mismo contenido.

VS Code (GitHub Copilot)

1. Crea el archivo .vscode/mcp.json en el proyecto (o ejecuta el comando MCP: Add Server... y elige HTTP):

{
  "servers": {
    "hystore": { "type": "http", "url": "https://mcp.hystore.com.br/mcp" }
  }
}

2. Haz clic en Start, que aparece encima de "hystore" en el archivo. VS Code pide iniciar sesión: acepta y autoriza en el navegador.
3. Abre el chat de Copilot en modo Agent, haz clic en el icono de herramientas y revisa que las herramientas de hystore estén marcadas.

Windsurf

En Windsurf Settings > Cascade > MCP Servers, abre el archivo de configuración y pega:

{
  "mcpServers": {
    "hystore": { "serverUrl": "https://mcp.hystore.com.br/mcp" }
  }
}

Actualiza la lista de servidores y conecta; el inicio de sesión abre en el navegador.

Otras apps

Busca en la app conector personalizado, servidor MCP remoto o MCP por HTTP y usa la misma dirección. No hace falta llave ni encabezado: la app descubre sola dónde iniciar sesión (por los documentos en https://mcp.hystore.com.br/.well-known/) y abre el panel. Si la app solo acepta servidores locales (por línea de comandos), usa la herramienta hystore en lugar del MCP.

La pantalla de autorización

Cuando la app pide acceso, el panel muestra Conectar una IA a tu tienda:

• El nombre de la app, como ella misma se presenta. Revisa que sea la app que estás conectando.
• A dónde va el acceso. Cuando es un programa en tu computadora (Claude Code, Cursor, VS Code), la pantalla avisa: solo autoriza si acabas de pedirlo.
• La tienda que la IA va a editar.
• Lo que la IA puede hacer, con casillas para desmarcar:

Haz clic en Autorizar y vuelve a la app. Rechazar no da ningún acceso.

Ejemplos de pedidos

Escribe como le hablarías a una persona. Algunos que funcionan bien:

• "Lee la guía del tema y explícame cómo está organizado mi tema."
• "En la página de inicio, cambia el título de arriba por 'Llegó la temporada 5' en portugués, inglés y español."
• "Crea una sección de Black Friday con cuenta regresiva hasta el 28/11 a las 23:59 y un botón a la categoría vips. Ponla arriba en el inicio."
• "Muestra los 8 productos más recientes de la categoría kits en tarjetas con botón de comprar."
• "Cambia el color de acento a dorado y deja los botones más redondeados."
• "Mándame el enlace de la vista previa."
• "Revisa todo el tema y corrige los errores."
• "Pide la publicación con la nota 'Banner de Black Friday'."

Después del pedido de publicación, abre Personalización > Tema en código > Pedidos de publicación, mira lo que cambió y haz clic en Aprobar y publicar (o Rechazar).

Lo que la IA puede hacer

Los argumentos y ejemplos de cada una están en la referencia del MCP.

Cada archivo pasa por la misma revisión del panel: un archivo con error vuelve a la IA con la línea y el motivo, y no se guarda nada. Si alguien cambió el archivo en el panel mientras tanto, la escritura se rechaza en vez de borrar ese cambio.

La IA no llega a pedidos, pagos, saldo, jugadores, cupones ni configuración, y no publica sola.

Desconectar

La conexión dura 30 días y se renueva sola mientras se usa la app. Aparece en Personalización > Acceso al tema > Sesiones conectadas, marcada como App de IA, con el nombre de la app. Desconectar corta el acceso al instante.

Por cada app conectada, el dueño de la tienda recibe un correo con el enlace para desconectarla. Cada cambio hecho por la IA queda en el historial del tema con el origen MCP.

Problemas comunes

Para quien crea apps e integraciones, el inicio de sesión, las rutas y los mensajes están en la referencia del MCP.