Servidor Cin7 Omni MCP: inventario y pedidos

💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Cin7 Omni, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Cin7 Omni

Gestión de inventario y pedidos de Cin7 Omni (go.cin7.com) a través de la API v1: pedidos de venta, cotizaciones, pedidos de compra, notas de crédito, contactos, productos, stock por sucursal, sucursales, pagos (solo lectura), ajustes de stock, transferencias entre sucursales y usuarios. Crea pedidos, pedidos de compra, contactos y transferencias. Nombre de usuario y clave de API.

Configuración

Configurar lleva unos 3 minutos. Necesitas una cuenta de Cin7 Omni (inicias sesión en go.cin7.com) y un administrador que pueda añadir una conexión de API v1. El conector necesita el nombre de usuario de la API y una clave de API.

¿Omni o Core? Cin7 vende dos productos diferentes. Cin7 Omni (este conector) inicia sesión en go.cin7.com y tiene API v1 con un nombre de usuario y clave de API. Cin7 Core (anteriormente DEAR Inventory) inicia sesión en inventory.dearsystems.com y tiene su propia API con un ID de cuenta y una clave de aplicación: usa el conector de Cin7 Core para ello. Las dos APIs y sus credenciales no son intercambiables.

1. En Cin7 Omni abre el menú de usuario, luego Configuración → Integraciones y API → API v1.
2. Copia el Nombre de usuario de API que aparece en la parte superior de la página en CIN7_OMNI_API_USERNAME.
3. Haz clic en Agregar nueva conexión de API, dale un nombre y copia su clave de API en CIN7_OMNI_API_KEY. Regenerar clave reemplaza una clave perdida.
4. Bajo Permisos marca Lectura para cada recurso que la IA debería ver, y Crear o Actualizar para los recursos que necesitan herramientas de escritura, luego haz clic en Guardar. Un recurso sin permiso responde 403.
5. Instala el conector. Ejecuta cin7_omni_list_branches para verificar la conexión: lista tus sucursales con sus ids.

La nube y la autoalojada funcionan de la misma manera: las credenciales son las mismas, y no hay URL de redirección que configurar. El conector envía el nombre de usuario y la clave como autenticación básica HTTP.

Por dónde empezar: cin7_omni_list_branches para ids de sucursales, cin7_omni_list_sales_orders para pedidos recientes, cin7_omni_list_stock para stock por sucursal, y cin7_omni_list_contacts para encontrar un cliente o proveedor.

Lo que lee: pedidos de venta, cotizaciones y notas de crédito con sus líneas; pagos registrados contra pedidos; pedidos de compra; productos, sus opciones (los SKUs vendibles) con precios y categorías; stock por opción de producto y sucursal (disponible, en mano, ventas abiertas, entrantes); ajustes de stock y transferencias entre sucursales; contactos y usuarios.

Lo que escribe: cin7_omni_create_sales_order, cin7_omni_update_sales_order (solo campos de encabezado, como etapa, código de seguimiento e instrucciones de entrega), cin7_omni_create_purchase_order, cin7_omni_create_contact, cin7_omni_update_contact y cin7_omni_create_branch_transfer están activados. Un nuevo pedido de venta se aprueba a menos que la IA lo cree como un borrador; los pedidos de compra y las transferencias se guardan como borradores a menos que sean aprobados. El despacho y la recepción de transferencias ocurren en Cin7.

Desactivado al instalar: cin7_omni_create_adjustment (crear un ajuste de stock en una sucursal). Un ajuste aprobado cambia el stock en mano y el valor del stock a la vez. Actívalo en la página del conector si la IA debería usarlo; la IA te pide que confirmes cada cambio.

Verifica la respuesta de cada escritura: Cin7 responde HTTP 200 con una lista de {index, success, id, code, errors}, también cuando rechaza el registro. La IA verifica success y errors antes de informar que una escritura se ha completado.

Los pagos son solo lectura: el conector nunca registra, cambia o elimina un pago, y no despacha, factura o anula pedidos.

Filtrado: where toma condiciones al estilo SQL sobre los campos del registro, no de sus líneas. Cadenas y fechas van entre comillas simples, los números se dejan sin comillas: modifiedDate>='2026-01-01T00:00:00Z' AND branchId=3, reference LIKE 'SO-10%', id IN (21,24). Las fechas son UTC, yyyy-MM-ddTHH:mm:ssZ. fields recorta la respuesta (id,reference,total,lineItems(code,qty)), lo que ayuda con las listas de pedidos, porque son grandes.

Paginación: page comienza en 1 y rows es como máximo 250 (por defecto 50, 25 en listas de pedidos). La IA pide la siguiente página hasta que una vuelva vacía.

Límites de tasa: Cin7 Omni permite 3 llamadas por segundo, 60 por minuto y 5,000 por día por cuenta; más allá de eso responde 429 con Retry-After. Grandes rows con filtros where estrechos utilizan mejor el presupuesto que muchas llamadas pequeñas.

Valores: el status del pedido es DRAFT, APPROVED o VOID, y stage es una etapa de flujo de trabajo de texto libre (Nuevo, Esperando Pago, Procesando, En Espera, Despachado). El stock available es el stock en mano menos las ventas abiertas. El type de contacto es Cliente, Proveedor o Interno. Las escrituras toman montos en la moneda del pedido; las lecturas devuelven valores en moneda base con el tipo de cambio. Los nuevos usuarios pueden tardar hasta 2 horas en aparecer en cin7_omni_list_users.

Errores comunes: 403 significa que la conexión de API no tiene permiso para ese recurso: márcalo bajo Permisos y guarda. 429 es el límite de tasa: espera el tiempo de Retry-After.

Requisitos previos: CIN7_OMNI_API_USERNAME, CIN7_OMNI_API_KEY

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige Cin7 Omni y pega las variables de entorno listadas bajo Requisitos previos.

Herramientas disponibles

Ejemplos de solicitudes

• "¿Qué pedidos de venta fueron aprobados esta semana y aún no han sido despachados?"
• "¿Cuánto stock del SKU TSHIRT-BLK-M está disponible en cada sucursal?"
• "¿Qué pedidos de compra están programados para llegar este mes, y de qué proveedores?"
• "Encuentra al cliente con el email [email protected] y muestra su saldo pendiente."
• "Crea una transferencia borrador de 20 unidades de TSHIRT-BLK-M desde el almacén principal a la tienda de la ciudad."

Próximos pasos

• Conectar a Claude
• Conectar a ChatGPT