Resumen
Cin7 Core (anteriormente DEAR Inventory) a través de External API v2: productos y disponibilidad de stock por ubicación, ventas con pedidos, cumplimientos, facturas y pagos (solo lectura), compras, clientes, proveedores, ajustes y transferencias de stock. Crea ventas, compras, clientes, proveedores y transferencias. ID de cuenta y clave de aplicación.
Configuración guiada
Conecta Cin7 Core a ChatGPT en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Cin7 Core con la configuración guiada y añade tu URL MCP a ChatGPT. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
El plugin de AnythingMCP en el directorio de ChatGPT responde, en AnythingMCP Cloud, a preguntas sobre las bases de datos de tu empresa (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, solo lectura): abre la ficha (se abre en una pestaña nueva) y pulsa Install plugin. Los demás conectores se añaden a ChatGPT como servidor MCP personalizado con la URL MCP de tu AnythingMCP.
Prueba a pedir
Prompts de ejemplo para Cin7 Core
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 Core, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Cin7 Core + ChatGPT
Cin7 Core (anteriormente DEAR Inventory) a través de External API v2: productos y disponibilidad de stock por ubicación, ventas con pedidos, cumplimientos, facturas y pagos (solo lectura), compras, clientes, proveedores, ajustes y transferencias de stock. Crea ventas, compras, clientes, proveedores y transferencias. ID de cuenta y clave de aplicación.
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_CORE_ACCOUNT_ID, CIN7_CORE_APPLICATION_KEY
Paso 1 — Obtener credenciales
La configuración tarda aproximadamente 2 minutos. Necesitas una cuenta de Cin7 Core (anteriormente DEAR Inventory; inicias sesión en inventory.dearsystems.com) con acceso a Integraciones → API. El conector necesita el ID de cuenta y una clave de aplicación.
¿Core u Omni? Cin7 vende dos productos diferentes. Cin7 Core (este conector, anteriormente DEAR Systems) utiliza un ID de cuenta y una clave de aplicación. Cin7 Omni (el Cin7 original, go.cin7.com) tiene una API v1 separada con un nombre de usuario y clave de API: usa el conector de Cin7 Omni para ello. Las credenciales de uno no funcionan en el otro.
- En Cin7 Core abre la página de configuración de API, Integraciones → API (inventory.dearsystems.com/ExternalAPI).
- Haz clic en + para agregar una aplicación API y dale un nombre.
- Copia el ID de cuenta (un GUID) en
CIN7_CORE_ACCOUNT_IDy la clave de aplicación enCIN7_CORE_APPLICATION_KEY. - Instala el conector. Ejecuta
cin7_core_get_mepara verificar la conexión: devuelve el nombre de la empresa, la moneda base y la zona horaria de la cuenta.
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 las envía en los encabezados api-auth-accountid y api-auth-applicationkey. Eliminar la aplicación API en Cin7 Core revoca la clave.
¿Por dónde empezar? cin7_core_get_me para la moneda base, cin7_core_list_locations para los nombres de ubicación, luego cin7_core_list_sales y cin7_core_get_product_availability, que responden la mayoría de las preguntas.
Lo que lee: productos con niveles de precios, disponibilidad de stock por producto y ubicación (en mano, asignado, disponible, en pedido); ventas con su cotización, pedido, cumplimientos (recoger, empaquetar y enviar, con transportista y seguimiento), facturas y pagos; compras con su pedido; clientes, proveedores, reglas fiscales y términos de pago; ajustes de stock y transferencias de stock.
Crear una venta requiere dos llamadas: cin7_core_create_sale hace el encabezado (cliente, ubicación) y devuelve su ID, luego cin7_core_create_sale_order agrega las líneas. Las líneas necesitan Nombre, Cantidad, Precio, Impuesto y ReglaImpuesto más SKU o ProductID. La IA mantiene el pedido en Borrador a menos que desees que esté autorizado: AUTORIZADO asigna stock, realiza un pedido de escasez sin advertencia y bloquea el pedido contra más ediciones de API. Las compras funcionan de la misma manera, con cin7_core_create_purchase y cin7_core_create_purchase_order.
Otras escrituras: cin7_core_create_customer, cin7_core_update_customer y cin7_core_create_supplier (necesitan nombres de términos de pago y reglas fiscales y códigos de cuenta, que listan cin7_core_list_payment_terms y cin7_core_list_tax_rules), y cin7_core_create_stock_transfer (Borrador por defecto). Todos estos están activados.
Desactivado al instalar: cin7_core_create_stock_adjustment (crear un ajuste de stock). Un ajuste COMPLETADO publica movimientos de stock y entradas contables a la vez, y sus cantidades son los nuevos valores en mano, no diferencias. Actívalo en la página del conector si la IA debe usarlo; la IA te pide confirmar cada cambio.
Sin dinero y sin eliminaciones: el conector nunca registra, cambia o elimina pagos, facturas o notas de crédito, y no tiene herramientas de eliminación o anulación.
Identificadores: los registros utilizan GUIDs (ID, SaleID, TaskID). Las ubicaciones, reglas fiscales, términos de pago y niveles de precios se referencian por nombre.
Paginación: las listas toman page (desde 1) y limit (por defecto 100, como máximo 1,000); la respuesta lleva Total. updated_since o modified_since devuelven solo lo que ha cambiado. Las fechas son UTC, yyyy-MM-ddTHH:mm:ss.
Límite de tasa: 60 llamadas por minuto por aplicación API; más allá de eso, Cin7 Core responde 429 (cuentas más antiguas 503). Las páginas grandes y los filtros utilizan mejor el presupuesto que muchas llamadas pequeñas.
Errores comunes: una llamada rechazada responde 400 con [{"ErrorCode": 400, "Exception": "..."}] nombrando el problema, como un cliente, ubicación o regla fiscal desconocida, o un documento que ya está autorizado. 403 significa un ID de cuenta o clave de aplicación incorrectos.
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 ChatGPT
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
- Escribe un nombre, por ejemplo Name:
Cin7 Core. - En Connection, introduce como Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
cin7_core_get_me | Lee la cuenta de Cin7 Core a la que pertenecen las claves: nombre de la empresa, moneda base, zona horaria, fecha de bloqueo, método de cálculo de impuestos, reglas fiscales predeterminadas |
cin7_core_list_locations | Lista almacenes y ubicaciones de stock: ID, Nombre, dirección, IsDefault, bins y si está obsoleto |
cin7_core_list_products | Lista productos (o lee uno por id): ID, SKU, Nombre, Categoría, Marca, Tipo (Stock o Servicio), MétodoDeCosteo, UOM, Estado, Código de barras, precio… |
cin7_core_get_product_availability | Disponibilidad de stock por producto y ubicación (y bin o lote): SKU, Nombre, Ubicación, Bin, Lote, EnMano, Asignado, Disponible, EnPedido… |
cin7_core_list_sales | Lista ventas (cotizaciones, pedidos y facturas comparten un registro de venta): SaleID, OrderNumber, Estado, OrderDate, Cliente, CustomerID… |
cin7_core_get_sale | Lee una venta con su encabezado (cliente, contacto, direcciones, ubicación, regla fiscal, términos, nivel de precio, fecha de envío, estado) y la cotización… |
cin7_core_get_sale_order | Lee la parte del pedido de una venta: SaleOrderNumber, Estado (Borrador, Autorizado...), Memo, Líneas (ProductID, SKU, Nombre, Cantidad, Precio… |
cin7_core_get_sale_fulfilments | Lee los cumplimientos de una venta: etapas de recoger, empaquetar y enviar con su estado, líneas, cajas, transportista y números de seguimiento |
cin7_core_get_sale_invoices | Lee las facturas de una venta: TaskID, InvoiceNumber, Estado, InvoiceDate, InvoiceDueDate, líneas, totales y montos pagados |
cin7_core_get_sale_payments | Lee los pagos, anticipos y reembolsos registrados en una venta: Tipo, Monto, FechaPagada, Cuenta, Referencia, tasa de cambio |
cin7_core_list_purchases | Lista compras: ID, OrderNumber, Estado, OrderDate, Proveedor, SupplierID, InvoiceNumber, totales, moneda, OrderStatus… |
cin7_core_get_purchase | Lee una compra (simple, avanzada o servicio) con proveedor, ubicación, enfoque, regla fiscal, términos, pedido, stock recibido, facturas y… |
cin7_core_get_purchase_order | Lee la parte del pedido de una compra: Estado, Memo, Líneas (ProductID, SKU, SupplierSKU, Nombre, Cantidad, Precio, Descuento, Impuesto, ReglaImpuesto, Total)… |
cin7_core_list_customers | Lista clientes (o lee uno por id): ID, Nombre, Estado, Moneda, PaymentTerm, TaxRule, PriceTier, Descuento, CreditLimit, IsOnCreditHold… |
cin7_core_list_suppliers | Lista proveedores (o lee uno por id): ID, Nombre, Estado, Moneda, PaymentTerm, AccountPayable, TaxRule, Descuento, TaxNumber, direcciones y… |
cin7_core_list_tax_rules | Lista reglas fiscales: ID, Nombre, Código, TaxPercent, IsTaxForSale, IsTaxForPurchase, IsActive, Cuenta |
cin7_core_list_payment_terms | Lista términos de pago: ID, Nombre, Duración, Método, IsActive, IsDefault |
cin7_core_list_stock_adjustments | Lista ajustes de stock: TaskID, StocktakeNumber, EffectiveDate, Estado (Borrador, COMPLETADO, ANULADO), Referencia, Cuenta |
cin7_core_get_stock_adjustment | Lee un ajuste de stock con sus líneas (ExistingStockLines, NewStockLines: SKU, ubicación, cantidad en mano, ajuste, costo unitario, lote)… |
cin7_core_list_stock_transfers | Lista transferencias de stock entre ubicaciones: TaskID, Número, Estado (Borrador, EN TRÁNSITO, COMPLETADO, ANULADO), Desde y Hasta ubicaciones… |
cin7_core_get_stock_transfer | Lee una transferencia de stock con sus líneas (SKU, TransferQuantity, lote) y estado |
cin7_core_create_sale | Crea un encabezado de venta (cliente, ubicación, términos, regla fiscal, direcciones) |
cin7_core_create_sale_order | Agrega las líneas del pedido a una venta creada con cin7_core_create_sale |
cin7_core_create_purchase | Crea un encabezado de compra para un proveedor (punto final de compra avanzada, que sirve para compras simples y avanzadas) |
cin7_core_create_purchase_order | Agrega las líneas del pedido a una compra creada con cin7_core_create_purchase |
cin7_core_create_customer | Crea un cliente |
cin7_core_update_customer | Actualiza un cliente por ID; solo cambian los campos dados |
cin7_core_create_supplier | Crea un proveedor |
cin7_core_create_stock_adjustment | Crea un ajuste de stock |
cin7_core_create_stock_transfer | Crea una transferencia de stock entre dos ubicaciones |
Ejemplos de indicaciones
- "¿Cuántas unidades del SKU MUG-WHT-350 están disponibles en cada ubicación?"
- "Lista las ventas de este mes que están autorizadas pero no completamente cumplidas aún."
- "Muestra el cumplimiento del pedido SO-1042 con su transportista y número de seguimiento."
- "¿Qué compras aún están esperando que se reciba el stock?"
- "Crea una venta en borrador para el cliente Coffee Corner en el Almacén Principal con 24 unidades de MUG-WHT-350 a 6.50."
Preguntas frecuentes
Uso Cin7 Omni (go.cin7.com). ¿Es este el conector correcto? No. Cin7 Omni tiene una API v1 separada con un nombre de usuario y clave de API: usa el conector de Cin7 Omni. Las credenciales de un producto no funcionan en el otro.
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.
Próximos pasos
¿Te ha sido útil esta guía?