MCP para Tortillerías | Maizapp MCP API — Documentación | Maizapp

Empieza aquí

¿Eres usuario de Maizapp? Solo necesitas hacer una cosa: generar tu API key. De todo lo demás puede encargarse tu asistente de IA — no necesitas saber nada técnico.

1
Genera tu API key en Maizapp
Entra a Configuración → API Keys (solo el dueño de la organización puede hacerlo), crea una key con los permisos que quieras dar y cópiala: se muestra una sola vez.
2
Dale la key y esta documentación a tu agente
Abre tu asistente de IA (Claude, ChatGPT u otro) y pídele que se conecte. Puedes copiarle algo como esto:
text
```
Conéctate al servidor MCP de Maizapp.
La documentación está en https://www.maizapp.com/docs/mcp/llms.txt
Mi API key es: mz_live_TU_API_KEY
```
3
Listo: pregúntale lo que quieras
Tu agente hará toda la conexión técnica por ti. Después podrás preguntarle cosas como “¿cuántos pedidos pendientes tengo hoy?” o “¿qué productos están por debajo del stock mínimo?”.

Recomendación: deja que tu agente lleve toda la conexión. Esta página tiene una versión especial para IA que tu asistente puede leer para configurarse solo. El resto de esta documentación es la referencia técnica, por si quieres conectarte manualmente.

Introducción

MCP (Model Context Protocol) es el estándar abierto que usan los asistentes de IA para conectarse a sistemas externos. Maizapp expone un servidor MCP remoto: con una API key tu IA obtiene acceso de solo lectura a los datos de tu organización, limitado a los permisos que asignes.

Solo lectura

Nunca crea, modifica ni borra datos.

Aislado por organización

Cada key ve solo sus propios datos.

Revocable al instante

Desactiva una key cuando quieras.

Endpoint

Esta es la URL del servidor MCP. Usa el transporte Streamable HTTP (métodos POST, GET y DELETE).

url

https://www.maizapp.com/api/mcp

Autenticación

Cada petición debe incluir tu API key en el encabezado de autorización:

header

Authorization: Bearer mz_live_TU_API_KEY

El dueño de la organización genera las API keys dentro de Maizapp en Configuración → API Keys. La key se muestra una sola vez al crearla.

Permisos (scopes)

Cada key se crea con uno o más permisos. Hoy todos son de solo lectura.

orders:readLeer pedidos

products:readLeer productos

inventory:readLeer inventario

customers:readLeer clientes

Conexión

Conector remoto (Claude, ChatGPT, agentes)

En la configuración de conectores de tu asistente, agrega un servidor MCP remoto con la URL del endpoint y, como autenticación, el encabezado Authorization: Bearer ….

Claude Desktop

Agrega esto a tu claude_desktop_config.json:

json

{
  "mcpServers": {
    "maizapp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.maizapp.com/api/mcp",
        "--header",
        "Authorization: Bearer mz_live_TU_API_KEY"
      ]
    }
  }
}

Probar con curl

Verifica tu key y lista las herramientas disponibles:

bash

curl -X POST https://www.maizapp.com/api/mcp \
  -H "Authorization: Bearer mz_live_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Herramientas

list_orders()orders:read

Lista pedidos de la organización. Permite filtrar por estado, búsqueda de cliente y rango de fechas (sobre la fecha programada).

statusopc

PENDING | PREPARED | ON_ROUTE | DELIVERED | CANCELLED — Estado del pedido

searchopc

string — Nombre o teléfono del cliente

fromopc

string (YYYY-MM-DD) — Fecha inicial

toopc

string (YYYY-MM-DD) — Fecha final

limitopc

number (1-100) — Máximo de resultados (default 20)

get_order()orders:read

Obtiene el detalle de un pedido por su ID, incluyendo productos y pagos.

orderIdreq

string — ID del pedido

list_products()products:read

Lista productos de la organización. Permite buscar por nombre, SKU o código interno.

searchopc

string — Nombre, SKU o código interno

activeOnlyopc

boolean — Solo productos activos (default true)

limitopc

number (1-100) — Máximo de resultados (default 50)

check_inventory()inventory:read

Consulta el stock actual de los productos. Permite filtrar solo los que están en o por debajo del stock mínimo.

lowStockOnlyopc

boolean — Solo productos bajos de mínimo

searchopc

string — Nombre del producto

limitopc

number (1-100) — Máximo de resultados (default 50)

list_customers()customers:read

Lista clientes de la organización. Permite buscar por nombre, teléfono o código de cliente.

searchopc

string — Nombre, teléfono o código de cliente

limitopc

number (1-100) — Máximo de resultados (default 50)

Ejemplos

Cosas que puedes pedirle a tu IA una vez conectada:

“¿Cuántos pedidos pendientes tengo para hoy?”

“Dame el detalle del pedido #1043.”

“¿Qué productos están por debajo del stock mínimo?”

“Busca al cliente Tortillería La Esperanza y dime su saldo de crédito.”

“Lista los pedidos entregados esta semana.”

Seguridad

Cada API key solo accede a los datos de su propia organización.
El acceso es de solo lectura: no es posible crear, modificar ni eliminar datos.
Las keys pueden revocarse en cualquier momento y dejan de funcionar al instante.
Trata tus API keys como contraseñas: no las compartas ni las publiques.

Empieza aquí

¿Eres usuario de Maizapp? Solo necesitas hacer una cosa: generar tu API key. De todo lo demás puede encargarse tu asistente de IA — no necesitas saber nada técnico.

Genera tu API key en Maizapp

Entra a Configuración → API Keys (solo el dueño de la organización puede hacerlo), crea una key con los permisos que quieras dar y cópiala: se muestra una sola vez.

Dale la key y esta documentación a tu agente

Abre tu asistente de IA (Claude, ChatGPT u otro) y pídele que se conecte. Puedes copiarle algo como esto:

text

Conéctate al servidor MCP de Maizapp.
La documentación está en https://www.maizapp.com/docs/mcp/llms.txt
Mi API key es: mz_live_TU_API_KEY

Listo: pregúntale lo que quieras

Tu agente hará toda la conexión técnica por ti. Después podrás preguntarle cosas como “¿cuántos pedidos pendientes tengo hoy?” o “¿qué productos están por debajo del stock mínimo?”.

Introducción

Solo lectura

Nunca crea, modifica ni borra datos.

Aislado por organización

Cada key ve solo sus propios datos.

Revocable al instante

Desactiva una key cuando quieras.

Conexión

Conector remoto (Claude, ChatGPT, agentes)

En la configuración de conectores de tu asistente, agrega un servidor MCP remoto con la URL del endpoint y, como autenticación, el encabezado Authorization: Bearer ….

Claude Desktop

Agrega esto a tu claude_desktop_config.json:

json

{
  "mcpServers": {
    "maizapp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.maizapp.com/api/mcp",
        "--header",
        "Authorization: Bearer mz_live_TU_API_KEY"
      ]
    }
  }
}

Probar con curl

Verifica tu key y lista las herramientas disponibles:

bash

curl -X POST https://www.maizapp.com/api/mcp \
  -H "Authorization: Bearer mz_live_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Conecta tu IA a Maizapp

Empieza aquí

Introducción

Endpoint

Autenticación

Permisos (scopes)

Conexión

Conector remoto (Claude, ChatGPT, agentes)

Claude Desktop

Probar con curl

Herramientas

Ejemplos

Seguridad

Conecta tu IA a Maizapp

Empieza aquí

Introducción

Endpoint

Autenticación

Permisos (scopes)

Conexión

Conector remoto (Claude, ChatGPT, agentes)

Claude Desktop

Probar con curl

Herramientas

Ejemplos

Seguridad