Resumen
MoySklad (МойСклад) JSON API 1.2 para la gestión de comercio y almacenes: surtido y productos, informes de stock, contrapartes, pedidos de clientes, envíos, suministros, facturas, tiendas e informes de beneficios y facturación. Token de acceso.
Configuración guiada
Conecta MoySklad a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta MoySklad con la configuración guiada y añade tu URL MCP a tu asistente de IA. 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 MoySklad
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 → MoySklad, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
MoySklad
MoySklad (МойСклад) JSON API 1.2 para la gestión de comercio y almacenes: surtido y productos, informes de stock, contrapartes, pedidos de clientes, envíos, suministros, facturas, tiendas e informes de beneficios y facturación. Token de acceso.
Configuración
Configurar toma aproximadamente 3 minutos.
- En MoySklad abre la configuración (Настройки) y la sección de tokens de acceso (Токены), crea un token para el usuario con el que la IA debe actuar y cópialo. Se muestra solo una vez.
- Pégalo en
MOYSKLAD_TOKEN.
Sin esa sección, también se puede emitir un token con el inicio de sesión y la contraseña: un POST a /security/token con HTTP Basic responde con access_token (esto revoca los tokens anteriores del usuario). El token actúa con los derechos de su usuario, por lo que un usuario con derechos de solo lectura crea un conector de solo lectura.
El conector envía Authorization: Bearer, Accept-Encoding: gzip y Accept: application/json;charset=utf-8 en cada llamada. MoySklad rechaza llamadas sin gzip con 415 y sin cuerpo.
Por dónde empezar: moysklad_get_employee_context muestra al usuario y sus derechos. moysklad_list_assortment busca todo lo que se puede vender, moysklad_get_current_stock proporciona números de stock rápidamente, y moysklad_list_customer_orders lista los pedidos.
Catálogo: moysklad_list_assortment, moysklad_list_products, moysklad_get_product, moysklad_create_product, moysklad_update_product, moysklad_list_product_folders.
Stock: moysklad_get_stock_report (todos los almacenes, con costo y precio de venta), moysklad_get_stock_by_store (por almacén) y moysklad_get_current_stock (ids y un número, sin paginación, bueno para verificaciones frecuentes). Los dos informes extendidos cuentan como 5 solicitudes cada uno.
Contrapartes: moysklad_list_counterparties, moysklad_get_counterparty, moysklad_create_counterparty, moysklad_update_counterparty.
Documentos: moysklad_list_customer_orders, moysklad_get_customer_order, moysklad_get_customer_order_metadata (estados), moysklad_create_customer_order, moysklad_update_customer_order; moysklad_list_demands y moysklad_get_demand (envíos); moysklad_list_supplies y moysklad_get_supply (bienes recibidos); moysklad_list_invoices_out y moysklad_get_invoice_out. Referencias: moysklad_list_stores, moysklad_list_organizations.
Informes: moysklad_get_profit_by_product, moysklad_get_profit_by_counterparty, moysklad_get_turnover, moysklad_get_dashboard.
Paginación: las listas devuelven como máximo 1000 filas por llamada (limit, aquí por defecto 100) desde offset; meta.size es el total y meta.nextHref está presente mientras haya más filas. Con expand el límite es 100: un límite mayor hace que MoySklad ignore el expand. Las líneas del documento más allá de las primeras 1000 se leen a través de las posiciones del documento.
Dinero y fechas: todos los montos y precios están en kopecks (unidades menores): 150000 significa 1500.00. Las fechas son YYYY-MM-DD HH:MM:SS en hora de Moscú. Los ids son UUIDs.
Referencias (meta): otro objeto se referencia como un objeto con meta que contiene href, type y mediaType, nunca por un id desnudo. Cada fila lleva su propio meta: cópialo cuando una herramienta pida una referencia (almacén, estado, el surtido de una línea de pedido). En los filtros de lista, una referencia es su href; en el informe de stock corto es el id desnudo.
Filtros: filter une condiciones con ;. Operadores: =, !=, >, <, >=, <=, ~ contiene, ~= comienza con, =~ termina con. search es una búsqueda de texto completo. order ordena, por ejemplo, moment,desc.
Límites: un token de usuario obtiene 45 unidades por 3 segundos y cada solicitud cuesta varias unidades (4 desde el 1 de diciembre de 2026, así que aproximadamente 11 solicitudes por 3 segundos; los dos informes de stock extendidos cuestan 5). Como máximo 5 llamadas de un usuario en paralelo. Un 429 lleva X-Lognex-Retry-After en milisegundos. MoySklad desactiva el acceso a la API para usuarios que siguen enviando llamadas fallidas (más de 200 solicitudes idénticas fallidas por minuto), así que no intentes reintentar errores en un bucle. Eliminar objetos y pagos no es parte de este conector.
Requisitos previos: MOYSKLAD_TOKEN
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 MoySklad y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
moysklad_get_employee_context | Lee el empleado al que pertenece el token: nombre, correo electrónico, la cuenta y los permisos por entidad. Úsalo para verificar el token y lo que puede… |
moysklad_list_assortment | Lista todo lo que se puede vender en una lista: productos, variantes (modificaciones), servicios, paquetes y consignaciones, cada uno con id, meta… |
moysklad_list_products | Lista productos: id, nombre, código, artículo, descripción, productFolder, uom, salePrices, buyPrice y minPrice en kopecks, códigos de barras, vat… |
moysklad_get_product | Lee un producto con sus precios en kopecks, códigos de barras, unidades, carpeta, proveedor, campos personalizados (atributos) y configuraciones de seguimiento. Solo lectura |
moysklad_create_product | Crea un producto con un nombre y opcionalmente código, artículo, descripción, IVA, peso y precio de compra. Devuelve el producto con su id y… |
moysklad_update_product | Actualiza un producto: solo cambian los campos dados. Devuelve el producto actualizado. MoySklad bloquea a un usuario que envía más de 100 actualizaciones del… |
moysklad_list_product_folders | Lista grupos de productos (carpetas): id, nombre, pathName (la ruta de grupos padres), código, descripción y archivado. Devuelve meta (tamaño, límite… |
moysklad_get_stock_report | Informe de stock extendido por artículo en todos los almacenes: nombre, código, artículo, stock, reserva, en tránsito y cantidad (disponible), precio (costo) y… |
moysklad_get_stock_by_store | Informe de stock por artículo y almacén: cada fila tiene el meta del artículo y stockByStore con nombre, stock, reserva y en tránsito por almacén. Cada llamada… |
moysklad_get_current_stock | Informe corto de stock para verificaciones frecuentes: solo assortmentId (y storeId con alcance por almacén) con un número, en una sola respuesta sin… |
moysklad_list_counterparties | Lista contrapartes (clientes y proveedores): id, nombre, código, companyType, inn, kpp, legalTitle, teléfono, correo electrónico, dirección real, etiquetas… |
moysklad_get_counterparty | Lee una contraparte con detalles legales (inn, kpp, legalAddress), contactos, cuentas bancarias, etiquetas, descuentos, tipo de precio y campos personalizados.… |
moysklad_create_counterparty | Crea una contraparte (cliente o proveedor) con un nombre y opcionalmente tipo, números fiscales, direcciones, teléfono, correo electrónico y etiquetas. Devuelve el… |
moysklad_update_counterparty | Actualiza una contraparte: solo cambian los campos dados; una lista de etiquetas dada reemplaza la anterior. Devuelve la contraparte actualizada |
moysklad_list_customer_orders | Lista pedidos de clientes: id, nombre (el número del pedido), momento, suma, payedSum, shippedSum, invoicedSum y reservedSum en kopecks, aplicable… |
moysklad_get_customer_order | Lee un pedido de cliente: número, momento, sumas en kopecks, contraparte (agente), organización, almacén, estado, dirección de envío, comentario y… |
moysklad_get_customer_order_metadata | Lee los metadatos de los pedidos de clientes: los estados (estatus) con id, nombre, stateType y meta, y los campos personalizados (atributos). El… |
moysklad_create_customer_order | Crea un pedido de cliente para una organización (tu entidad legal) y una contraparte, con líneas de pedido. Devuelve el pedido con su id, número… |
moysklad_update_customer_order | Actualiza un pedido de cliente: comentario, fecha de envío planificada, estado, almacén o la bandera de borrador. Solo cambian los campos dados. Para cambiar el pedido… |
moysklad_list_demands | Lista demandas (envíos a clientes): id, nombre, momento, suma y payedSum en kopecks, agente, organización, almacén, estado, el pedido del cliente… |
moysklad_get_demand | Lee una demanda (envío): número, momento, suma en kopecks, contraparte, almacén, detalles del consignatario y del transportista y el pedido de cliente vinculado… |
moysklad_list_supplies | Lista suministros (bienes recibidos de proveedores): id, nombre, momento, suma y payedSum en kopecks, agente (el proveedor), organización, almacén… |
moysklad_get_supply | Lee un suministro (recibo de bienes): número, momento, suma en kopecks, proveedor, almacén, el número del documento de entrada y costos generales. Agrega… |
moysklad_list_invoices_out | Lista facturas emitidas a clientes: id, nombre, momento, suma, payedSum y shippedSum en kopecks, agente, organización, paymentPlannedMoment y… |
moysklad_get_invoice_out | Lee una factura emitida a un cliente: número, momento, suma y payedSum en kopecks, contraparte, organización con su cuenta bancaria y… |
moysklad_list_stores | Lista almacenes (depósitos): id, nombre, código, dirección, pathName para almacenes anidados, archivado y meta. La meta es lo que piden los pedidos y el informe… |
moysklad_list_organizations | Lista tus organizaciones (entidades legales): id, nombre, legalTitle, inn, kpp, legalAddress, companyType y meta. Un pedido siempre necesita uno.… |
moysklad_get_profit_by_product | Informe de beneficios por producto, servicio y paquete para un período: sellQuantity, sellPrice, sellCost, sellSum, sellCostSum, returnQuantity… |
moysklad_get_profit_by_counterparty | Informe de beneficios por cliente para un período: demandsCount, demandsSum, averageReceipt, returnsCount, returnsSum, discountsSum, balance… |
moysklad_get_turnover | Informe de facturación por artículo para un período: stock al inicio (onPeriodStart), ingresos, gastos y stock al final (onPeriodEnd), cada uno con… |
moysklad_get_dashboard | Cifras clave para hoy, la última semana o el último mes: ventas (cantidad, monto, movimiento), pedidos (cantidad, monto, movimiento) y… |
Ejemplos de solicitudes
- "¿Cuál es el stock actual de todos los productos en el almacén principal?"
- "¿Qué pedidos de clientes de esta semana no se han enviado aún?"
- "Muestra el beneficio por producto para octubre."
- "Crea un pedido de cliente para ООО Ромашка: 10 piezas del producto Чайник 1,7 л."
- "¿Qué contrapartes compraron más el último trimestre?"
Próximos pasos
¿Te ha sido útil esta guía?