Cin7 Core MCP: inventario, ventas y compras

💡 ¿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

Cin7 Core (anteriormente DEAR Inventory) a través de la API Externa v2: productos y disponibilidad de stock por ubicación, ventas con pedidos, cumplimientos, facturas y pagos (solo lectura), compras, clientes, proveedores, ajustes de stock y transferencias. Crea ventas, compras, clientes, proveedores y transferencias. ID de cuenta y clave de aplicación.

Configuración

Configurar toma 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.

1. En Cin7 Core abre la página de configuración de la API, Integraciones → API (inventory.dearsystems.com/ExternalAPI).
2. Haz clic en + para agregar una aplicación API y dale un nombre.
3. Copia el ID de Cuenta (un GUID) en CIN7_CORE_ACCOUNT_ID y la Clave de Aplicación en CIN7_CORE_APPLICATION_KEY.
4. Instala el conector. Ejecuta cin7_core_get_me para 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 precio, 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 crea 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 ReglaFiscal más SKU o ProductID. La IA mantiene el pedido en Borrador a menos que desees que esté autorizado: AUTORIZADO asigna stock, realiza pedidos pendientes 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 en la instalación: 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 precio 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 desconocidos, o un documento que ya está autorizado. 403 significa un ID de cuenta o clave de aplicación incorrectos.

Requisitos previos: CIN7_CORE_ACCOUNT_ID, CIN7_CORE_APPLICATION_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 Core y pega las variables de entorno listadas bajo Requisitos previos.

Herramientas disponibles

Ejemplos de solicitudes

• "¿Cuántas unidades de 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 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."

Próximos pasos

• Conectar a Claude
• Conectar a ChatGPT