Guía de conector9 minutos de lectura31 herramientas MCP7 idiomas

Conectar MoySklad MCP con Cursor

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 rotación. Token de acceso.

HCPor el equipo de HelpCodeActualizado 9 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

MoySklad

MoySklad

MoySklad (МойСклад) JSON API 1.2 for trade and warehouse management: assortment and products, stock reports, counterparties, customer orders, shipments, supplies, invoices, stores and profit and turnover reports. Access token.

herramientas

31

Región

INTL

Categoría

ERP

Autenticación

Bearer Token

Env vars requeridas

MOYSKLAD_TOKEN
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

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 rotación. Token de acceso.

Configuración guiada

Conecta MoySklad a Cursor en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta MoySklad con la configuración guiada y añade tu URL MCP a Cursor. 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.

MoySklad · live vía MCP
Compartir
Opus 4.7

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 + Cursor

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 rotación. Token de acceso.

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:

MOYSKLAD_TOKEN

Paso 1 — Obtener credenciales

La configuración tarda aproximadamente 3 minutos.

  1. En MoySklad, abre la configuración (Настройки) y la sección para tokens de acceso (Токены), crea un token para el usuario que la IA debe representar y cópialo. Se muestra solo una vez.
  2. 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.

Dónde empezar: moysklad_get_employee_context muestra el 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 comprobaciones 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, por defecto aquí 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 de documentos 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 fallidas idénticas por minuto), así que no reintentes errores en un bucle. Eliminar objetos y pagos no es parte de este conector.

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 — Añadir el conector en Cursor

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 muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
  2. Guarda el archivo y reinicia Cursor.
  3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
  4. Empieza a chatear: el agente ya puede usar las herramientas de MoySklad.

Herramientas disponibles

HerramientaQué hace
moysklad_get_employee_contextLee 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_assortmentLista todo lo que se puede vender en una lista: productos, variantes (modificaciones), servicios, paquetes y consignaciones, cada uno con id, meta…
moysklad_list_productsLista productos: id, nombre, código, artículo, descripción, productFolder, uom, salePrices, buyPrice y minPrice en kopecks, códigos de barras, vat…
moysklad_get_productLee 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_productCrea 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_productActualiza 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_foldersLista 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_reportInforme 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_storeInforme 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_stockInforme de stock corto para comprobaciones frecuentes: solo assortmentId (y storeId con alcance por almacén) con un número, en una sola respuesta sin…
moysklad_list_counterpartiesLista contrapartes (clientes y proveedores): id, nombre, código, companyType, inn, kpp, legalTitle, teléfono, correo electrónico, dirección real, etiquetas…
moysklad_get_counterpartyLee una contraparte con detalles legales (inn, kpp, legalAddress), contactos, cuentas bancarias, etiquetas, descuentos, tipo de precio y campos personalizados.…
moysklad_create_counterpartyCrea 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_counterpartyActualiza una contraparte: solo cambian los campos dados; una lista de etiquetas dada reemplaza la antigua. Devuelve la contraparte actualizada
moysklad_list_customer_ordersLista pedidos de clientes: id, nombre (el número de pedido), momento, suma, payedSum, shippedSum, invoicedSum y reservedSum en kopecks, aplicable…
moysklad_get_customer_orderLee 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_metadataLee 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_orderCrea 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_orderActualiza 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_demandsLista 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_demandLee 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_suppliesLista suministros (bienes recibidos de proveedores): id, nombre, momento, suma y payedSum en kopecks, agente (el proveedor), organización, almacén…
moysklad_get_supplyLee un suministro (recibo de bienes): número, momento, suma en kopecks, proveedor, almacén, el número del documento entrante y costos generales. Añadir…
moysklad_list_invoices_outLista facturas emitidas a clientes: id, nombre, momento, suma, payedSum y shippedSum en kopecks, agente, organización, paymentPlannedMoment y…
moysklad_get_invoice_outLee una factura emitida a un cliente: número, momento, suma y payedSum en kopecks, contraparte, organización con su cuenta bancaria y…
moysklad_list_storesLista 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_organizationsLista tus organizaciones (entidades legales): id, nombre, legalTitle, inn, kpp, legalAddress, companyType y meta. Un pedido siempre necesita uno.…
moysklad_get_profit_by_productInforme de beneficios por producto, servicio y paquete para un período: sellQuantity, sellPrice, sellCost, sellSum, sellCostSum, returnQuantity…
moysklad_get_profit_by_counterpartyInforme de beneficios por cliente para un período: demandsCount, demandsSum, averageReceipt, returnsCount, returnsSum, discountsSum, balance…
moysklad_get_turnoverInforme de rotación por artículo para un período: stock al inicio (onPeriodStart), ingresos, egresos y stock al final (onPeriodEnd), cada uno con…
moysklad_get_dashboardCifras clave para hoy, la última semana o el último mes: ventas (conteo, monto, movimientoMonto), pedidos (conteo, monto, movimientoMonto) y…

Ejemplos de indicaciones

  • "¿Cuál es el stock actual de todos los productos en el almacén principal?"
  • "¿Qué pedidos de clientes de esta semana aún no se han enviado?"
  • "Muestra el beneficio por producto para octubre."
  • "Crea un pedido de cliente para ООО Ромашка: 10 piezas del producto Чайник 1,7 л."
  • "¿Qué contrapartes compraron más en el último trimestre?"

Preguntas frecuentes

¿De dónde proviene el token? En MoySklad, configuraciones (Настройки), tokens de acceso (Токены): crea un token para el usuario que la IA debe representar y cópialo, se muestra una vez. El token tiene los derechos de ese usuario, por lo que un usuario con derechos de solo lectura crea un conector de solo lectura.

¿Qué cubre? El surtido y productos con carpetas, informes de stock en general, por almacén y el stock actual rápido, contrapartes, pedidos de clientes con sus estados, envíos (demandas), suministros, facturas salientes, almacenes, organizaciones, y los informes de beneficios, rotación y panel de control. Los montos están en kopecks y las fechas en hora de Moscú. Eliminar objetos y pagos no es parte del conector.

¿Qué herramientas escriben y qué instalaciones están desactivadas? Se pueden crear y actualizar productos, contrapartes y pedidos de clientes. No hay instalaciones desactivadas; la IA muestra cada escritura y espera tu confirmación.

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Próximos pasos

¿Te ha sido útil esta guía?

Conecta MoySklad a Cursor en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta MoySklad con la configuración guiada y añade tu URL MCP a Cursor. Sin código y sin servidores que mantener.

Guías relacionadas

Conectores

Conectar MoySklad MCP con ChatGPT

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 rotación. Token de acceso.

Conectores

Conectar MoySklad MCP con Claude

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 rotación. Token de acceso.

Conectores

MoySklad MCP con Microsoft Copilot

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 rotación. Token de acceso.

Conectores

MoySklad MCP con Gemini CLI

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 rotación. Token de acceso.

Conectores

MoySklad MCP con Meta Muse

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 rotación. Token de acceso.

Conectores

MoySklad MCP: stock, pedidos e informes

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.