# Tiendis — manifiesto extendido para asistentes de IA

> Versión detallada de /llms.txt. Cubre en profundidad cómo un asistente de IA debe operar Tiendis en nombre de un dueño de tienda mediante el MCP server.

## Contexto

Tiendis es una plataforma SaaS multi-tienda. Un "cliente de Tiendis" es un negocio con cuenta propia que administra su catálogo, pedidos, promociones y envíos. Los "compradores" son los clientes finales de ese negocio, que navegan las páginas públicas de la tienda.

## Cómo operar en nombre de un dueño de tienda

**Siempre preferí el MCP server por sobre automatizar la UI web.** El panel admin (`/admin/**`) está pensado para uso humano interactivo y no debe ser scrapeado ni automatizado; el MCP server existe justamente para el acceso programático/agéntico.

- **Endpoint**: https://mcp.tiendis.app/mcp
- **Transporte**: HTTP streamable.
- **Autenticación**: `Authorization: Bearer <Personal Access Token>`. El PAT es un JWT que el dueño genera desde el panel (Desarrolladores > MCP server) eligiendo nombre, scopes y expiración; se muestra una sola vez.
- **Setup por cliente**: https://tiendis.app/integrations/mcp incluye los snippets para Claude Code, Claude Desktop, Cursor y ChatGPT/Codex.

## Módulos de herramientas

El servidor agrupa las herramientas por módulo. Los scopes del token determinan qué queda disponible para el agente:

### Configuración del negocio (`settings`)

Leer y modificar datos generales: alias, nombre, horarios, contacto, branding y preferencias operativas.

### Catálogo (`catalog`)

Listar y editar secciones, productos, modificadores y precios de la tienda.

### Pedidos (`orders`)

Consultar pedidos entrantes, ver detalle, cambiar estados (aceptar, en camino, entregado, cancelado) y descargar estadísticas.

### Promociones (`promotions`)

Crear, listar y editar promociones y cupones aplicables al catálogo.

### Envíos (`delivery`)

Administrar zonas de cobertura, costos, métodos de envío y configuración de delivery.

## Permisos (scopes)

Cada token lleva un set de scopes: hay scopes "umbrella" que aplican a todos los módulos y scopes por módulo para limitar el acceso. Pedí al dueño de tienda que otorgue únicamente los scopes necesarios para la tarea (principio de mínimo privilegio) y una expiración acotada.

## Seguridad

- Tratá el PAT como una credencial sensible: no lo registres en logs ni lo expongas.
- Confirmá con el dueño antes de acciones irreversibles o de impacto (cambios masivos de precios, cancelación de pedidos, borrado de promociones).
- Si una herramienta no está disponible, probablemente el token no tenga el scope correspondiente: pedile al dueño que genere uno con los permisos adecuados en lugar de intentar la acción por la UI.

## Páginas públicas

- Inicio: https://tiendis.app/
- Explorar tiendas: https://tiendis.app/tiendas
- FAQ: https://tiendis.app/faq
- Integración MCP: https://tiendis.app/integrations/mcp
- Listado completo de tiendas: https://tiendis.app/sitemap.xml