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 Microsoft Copilot 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 Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Cin7 Core. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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.
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Próximos pasos
¿Te ha sido útil esta guía?