Resumen
Gestión de inventario y pedidos de Cin7 Omni (go.cin7.com) a través de la API v1: pedidos de venta, cotizaciones, órdenes 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, órdenes de compra, contactos y transferencias. Nombre de usuario y clave de API.
Configuración guiada
Conecta Cin7 Omni a Claude en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Cin7 Omni con la configuración guiada y añade tu URL MCP a Claude. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
Prueba a pedir
Prompts de ejemplo para Cin7 Omni
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿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 + Claude
Gestión de inventario y pedidos de Cin7 Omni (go.cin7.com) a través de la API v1: pedidos de venta, cotizaciones, órdenes 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, órdenes de compra, contactos y transferencias. Nombre de usuario y clave de API.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
CIN7_OMNI_API_USERNAME, CIN7_OMNI_API_KEY
Paso 1 — Obtener credenciales
La configuración toma aproximadamente 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: utiliza el conector de Cin7 Core para ello. Las dos APIs y sus credenciales no son intercambiables.
- En Cin7 Omni abre el menú de usuario, luego Configuración → Integraciones y API → API v1.
- Copia el Nombre de usuario de API que se muestra en la parte superior de la página en
CIN7_OMNI_API_USERNAME. - 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. - Bajo Permisos marca Lectura para cada recurso que la IA debería ver, y Crear o Actualizar para los recursos que las herramientas de escritura necesitan, luego haz clic en Guardar. Un recurso sin permiso responde 403.
- Instala el conector. Ejecuta
cin7_omni_list_branchespara verificar la conexión: lista tus sucursales con sus ids.
La nube y el autoalojamiento 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 HTTP Basic.
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; órdenes 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 habilitados. Un nuevo pedido de venta se aprueba a menos que la IA lo cree como un borrador; las órdenes de compra y transferencias se guardan como borradores a menos que sean aprobadas. 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.
Paso 2 — Instalar el adaptador
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
Paso 3 — Agregar el conector en Claude
La URL de tu servidor: en AnythingMCP, abre Servidores MCP → el servidor en el que está este conector, y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala dondequiera que esta guía muestreYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin editar ningún archivo de configuración.
- En Claude, abre Personalizar → Conectores.
- Haz clic en +, luego en Agregar conector personalizado.
- Ingresa un nombre, por ejemplo
Cin7 Omni, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, luego haz clic en Agregar. - Haz clic en Conectar e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas a continuación aparecerán en tu chat: comienza a escribir indicaciones.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
cin7_omni_list_sales_orders | Lista los pedidos de venta, los más nuevos primero: id, referencia, estado (DRAFT, APPROVED, VOID), etapa, cliente (memberId, empresa, email), branchId, fechas… |
cin7_omni_get_sales_order | Lee un pedido de venta con sus líneas, direcciones, totales, etapa, estado, fechas de factura y despacho |
cin7_omni_list_quotes | Lista las cotizaciones de ventas con cliente, sucursal, totales, etapa y líneas |
cin7_omni_list_purchase_orders | Lista las órdenes de compra, las más nuevas primero: id, referencia, proveedor (memberId, empresa), branchId, estado, etapa, estimatedArrivalDate… |
cin7_omni_get_purchase_order | Lee una orden de compra con sus líneas, proveedor, fechas y totales |
cin7_omni_list_credit_notes | Lista las notas de crédito: id, referencia, salesReference (el pedido de venta que acredita), cliente, totales, estado y líneas (cantidades negativas) |
cin7_omni_get_credit_note | Lee una nota de crédito con sus líneas y totales |
cin7_omni_list_payments | Lista los pagos registrados contra pedidos: id, orderId, orderRef, paymentDate, amount, method, direction (1 recibido, -1 pagado o reembolsado)… |
cin7_omni_list_contacts | Lista contactos (clientes, proveedores, internos): id, type, empresa, nombre y apellido, email, teléfono, direcciones, accountNumber… |
cin7_omni_get_contact | Lee un contacto con direcciones, contactos secundarios, precios y detalles de cuenta |
cin7_omni_list_products | Lista productos (estilos): id, nombre, styleCode, estado, marca, ids de categoría, descripción, control de stock y sus productOptions (variantes con… |
cin7_omni_get_product | Lee un producto con todas sus opciones, precios y dimensiones |
cin7_omni_list_product_options | Lista opciones de producto (las variantes vendibles, SKUs): id, productId, code, barcode, option1-3, retail, wholesale y precios especiales, precio… |
cin7_omni_list_product_categories | Lista categorías de productos: id, nombre, parentId (0 = nivel superior), orden |
cin7_omni_list_stock | Stock por opción de producto y sucursal: productId, productOptionId, code, barcode, branchId, branchName, available (stock en mano menos ventas abiertas… |
cin7_omni_list_branches | Lista sucursales (almacenes, tiendas): id, empresa, branchType, isActive, dirección y ubicaciones de bin |
cin7_omni_list_adjustments | Lista ajustes de stock: id, referencia, branchId, isApproved, completedDate, adjustmentReason y líneas (code, qty, unitCost) |
cin7_omni_list_branch_transfers | Lista transferencias de stock entre sucursales: id, referencia, sourceBranchId, destinationBranchId, etapa, isApproved, dispatchedDate, receivedDate… |
cin7_omni_list_users | Lista los usuarios de la cuenta de Cin7 Omni: id, firstName, lastName, jobTitle, email, isActive |
cin7_omni_create_sales_order | Crea un pedido de venta |
cin7_omni_update_sales_order | Actualiza los campos de encabezado de un pedido de venta: etapa, código de seguimiento, número de pedido del cliente, fecha estimada de entrega, instrucciones de entrega… |
cin7_omni_create_purchase_order | Crea una orden de compra a un proveedor (member_id de un contacto Proveedor) |
cin7_omni_create_contact | Crea un contacto (cliente o proveedor) |
cin7_omni_update_contact | Actualiza un contacto; solo cambian los campos dados |
cin7_omni_create_branch_transfer | Crea una transferencia de stock entre dos sucursales |
cin7_omni_create_adjustment | Crea un ajuste de stock en una sucursal (cantidad positiva añade stock, negativa lo elimina) |
Ejemplos de indicaciones
- "¿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é órdenes de compra están previstas 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."
Preguntas frecuentes
¿Funciona con Claude Code así como con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Uso Cin7 Core (DEAR Inventory). ¿Es este el conector correcto? No. Cin7 Core tiene su propia API y credenciales: utiliza el conector de Cin7 Core. Las credenciales de un producto no funcionan en el otro.
Próximos pasos
- Página de inicio del conector
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?