Connector guide10-minute read31 MCP tools7 languages

Connect MoySklad to Microsoft Copilot via MCP

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.

HCBy HelpCode teamUpdated 10 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

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.

tools

31

Region

INTL

Category

ERP

Authentication

Bearer Token

Required env vars

MOYSKLAD_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Summary

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.

Guided setup

Connect MoySklad to Microsoft Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect MoySklad in the guided setup, then add your MCP URL to Microsoft Copilot. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

Try asking

Example prompts for MoySklad

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

MoySklad · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → MoySklad, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

MoySklad + Microsoft Copilot

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.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

MOYSKLAD_TOKEN

Step 1 — Get credentials

Setting up takes about 3 minutes.

  1. In MoySklad open the settings (Настройки) and the section for access tokens (Токены), create a token for the user the AI should act as, and copy it. It is shown only once.
  2. Paste it into MOYSKLAD_TOKEN.

Without that section a token can also be issued with the login and password: a POST to /security/token with HTTP Basic answers access_token (this revokes the earlier tokens of the user). The token acts with the rights of its user, so a user with read-only rights makes a read-only connector.

The connector sends Authorization: Bearer, Accept-Encoding: gzip and Accept: application/json;charset=utf-8 on every call. MoySklad refuses calls without gzip with 415 and no body.

Where to start: moysklad_get_employee_context shows the user and its rights. moysklad_list_assortment searches everything that can be sold, moysklad_get_current_stock gives stock numbers fast, and moysklad_list_customer_orders lists orders.

Catalogue: moysklad_list_assortment, moysklad_list_products, moysklad_get_product, moysklad_create_product, moysklad_update_product, moysklad_list_product_folders.

Stock: moysklad_get_stock_report (all stores, with cost and sale price), moysklad_get_stock_by_store (per store) and moysklad_get_current_stock (ids and one number, no paging, good for frequent checks). The two extended reports count as 5 requests each.

Counterparties: moysklad_list_counterparties, moysklad_get_counterparty, moysklad_create_counterparty, moysklad_update_counterparty.

Documents: moysklad_list_customer_orders, moysklad_get_customer_order, moysklad_get_customer_order_metadata (statuses), moysklad_create_customer_order, moysklad_update_customer_order; moysklad_list_demands and moysklad_get_demand (shipments); moysklad_list_supplies and moysklad_get_supply (goods received); moysklad_list_invoices_out and moysklad_get_invoice_out. References: moysklad_list_stores, moysklad_list_organizations.

Reports: moysklad_get_profit_by_product, moysklad_get_profit_by_counterparty, moysklad_get_turnover, moysklad_get_dashboard.

Paging: lists return at most 1000 rows per call (limit, default here 100) from offset; meta.size is the total and meta.nextHref is present while more rows follow. With expand the limit is 100: a larger limit makes MoySklad ignore the expand. Document lines beyond the first 1000 are read through the positions of the document.

Money and dates: all amounts and prices are in kopecks (minor units): 150000 means 1500.00. Dates are YYYY-MM-DD HH:MM:SS in Moscow time. Ids are UUIDs.

References (meta): another object is referenced as an object with meta holding href, type and mediaType, never by a bare id. Every row carries its own meta: copy it when a tool asks for a reference (store, state, the assortment of an order line). In list filters a reference is its href; in the short stock report it is the bare id.

Filters: filter joins conditions with ;. Operators: =, !=, >, <, >=, <=, ~ contains, ~= starts with, =~ ends with. search is a full-text search. order sorts, e.g. moment,desc.

Limits: a user token gets 45 units per 3 seconds and each request costs several units (4 from 1 December 2026, so about 11 requests per 3 seconds; the two extended stock reports cost 5). At most 5 calls of one user in parallel. A 429 carries X-Lognex-Retry-After in milliseconds. MoySklad switches API access off for users that keep sending failing calls (more than 200 identical failing requests a minute), so do not retry errors in a loop. Deleting objects and payments is not part of this connector.

Step 2 — Install the adapter

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

Step 3 — Add the connector in Microsoft Copilot

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Microsoft Copilot uses MCP servers through agents built in Copilot Studio: you add AnythingMCP to an agent as a tool, then publish the agent to Microsoft 365 Copilot and Teams. Copilot Studio connects from Microsoft's cloud over Streamable HTTP, which AnythingMCP supports.

  1. In Copilot Studio, open your agent (or create one), go to Tools and choose Add a tool → New tool → Model Context Protocol.
  2. Enter a Server name (for example AnythingMCP), a Server description that says what the connector does, and the Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio uses the description to decide when to call the server.
  3. Under authentication, choose API key, set Type to Header and the header name to X-API-Key, then select Create.
  4. In Add tool, choose Create a new connection, paste an MCP API key from AnythingMCP (MCP Servers → your server → API keys) and select Add to agent.
  5. Try it in the agent's Test pane: ask for something that needs the MoySklad tools.
  6. Select Publish, then Channels → Microsoft 365 and Microsoft Teams, keep Make agent available in Microsoft Copilot selected and choose Add channel. See agent in Teams installs it for you; in Microsoft 365 Copilot, type @ and pick the agent.

Prefer per-user sign-in? Choose OAuth 2.0 → Dynamic discovery instead of an API key: each user then signs in to AnythingMCP the first time the agent calls it.

Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Copilot Studio connects from Microsoft's cloud, so localhost does not work.

Available tools

ToolWhat it does
moysklad_get_employee_contextRead the employee the token belongs to: name, email, the account, and the permissions per entity. Use it to check the token and what it may…
moysklad_list_assortmentList everything that can be sold in one list: products, variants (modifications), services, bundles and consignments, each with id, meta…
moysklad_list_productsList products: id, name, code, article, description, productFolder, uom, salePrices, buyPrice and minPrice in kopecks, barcodes, vat…
moysklad_get_productRead one product with its prices in kopecks, barcodes, units, folder, supplier, custom fields (attributes) and tracking settings. Read-only
moysklad_create_productCreate a product with a name and optionally code, article, description, VAT, weight and purchase price. Returns the product with its id and…
moysklad_update_productUpdate a product: only the fields given change. Returns the updated product. MoySklad blocks a user that sends more than 100 updates of the…
moysklad_list_product_foldersList product groups (folders): id, name, pathName (the path of parent groups), code, description and archived. Returns meta (size, limit…
moysklad_get_stock_reportExtended stock report per item over all stores: name, code, article, stock, reserve, inTransit and quantity (available), price (cost) and…
moysklad_get_stock_by_storeStock report per item and store: each row has the item meta and stockByStore with name, stock, reserve and inTransit per store. Each call…
moysklad_get_current_stockShort stock report for frequent checks: only assortmentId (and storeId with scope bystore) with one number, in a single answer without…
moysklad_list_counterpartiesList counterparties (customers and suppliers): id, name, code, companyType, inn, kpp, legalTitle, phone, email, actualAddress, tags…
moysklad_get_counterpartyRead one counterparty with legal details (inn, kpp, legalAddress), contacts, bank accounts, tags, discounts, price type and custom fields.…
moysklad_create_counterpartyCreate a counterparty (customer or supplier) with a name and optionally type, tax numbers, addresses, phone, email and tags. Returns the…
moysklad_update_counterpartyUpdate a counterparty: only the fields given change; a given tags list replaces the old one. Returns the updated counterparty
moysklad_list_customer_ordersList customer orders: id, name (the order number), moment, sum, payedSum, shippedSum, invoicedSum and reservedSum in kopecks, applicable…
moysklad_get_customer_orderRead one customer order: number, moment, sums in kopecks, counterparty (agent), organization, store, state, shipment address, comment and…
moysklad_get_customer_order_metadataRead the metadata of customer orders: the states (statuses) with id, name, stateType and meta, and the custom fields (attributes). The…
moysklad_create_customer_orderCreate a customer order for an organization (your legal entity) and a counterparty, with order lines. Returns the order with its id, number…
moysklad_update_customer_orderUpdate a customer order: comment, planned shipment date, status, store or the draft flag. Only the fields given change. To change order…
moysklad_list_demandsList demands (shipments to customers): id, name, moment, sum and payedSum in kopecks, agent, organization, store, state, the customer order…
moysklad_get_demandRead one demand (shipment): number, moment, sum in kopecks, counterparty, store, consignee and carrier details and the linked customer…
moysklad_list_suppliesList supplies (goods received from suppliers): id, name, moment, sum and payedSum in kopecks, agent (the supplier), organization, store…
moysklad_get_supplyRead one supply (goods receipt): number, moment, sum in kopecks, supplier, store, the incoming document number and overhead costs. Add…
moysklad_list_invoices_outList invoices issued to customers: id, name, moment, sum, payedSum and shippedSum in kopecks, agent, organization, paymentPlannedMoment and…
moysklad_get_invoice_outRead one invoice issued to a customer: number, moment, sum and payedSum in kopecks, counterparty, organization with its bank account and…
moysklad_list_storesList stores (warehouses): id, name, code, address, pathName for nested stores, archived and meta. The meta is what orders and report…
moysklad_list_organizationsList your organizations (legal entities): id, name, legalTitle, inn, kpp, legalAddress, companyType and meta. An order always needs one.…
moysklad_get_profit_by_productProfit report per product, service and bundle for a period: sellQuantity, sellPrice, sellCost, sellSum, sellCostSum, returnQuantity…
moysklad_get_profit_by_counterpartyProfit report per customer for a period: demandsCount, demandsSum, averageReceipt, returnsCount, returnsSum, discountsSum, balance…
moysklad_get_turnoverTurnover report per item for a period: stock at the start (onPeriodStart), income, outcome and stock at the end (onPeriodEnd), each with…
moysklad_get_dashboardKey figures for today, the last week or the last month: sales (count, amount, movementAmount), orders (count, amount, movementAmount) and…

Example prompts

  • "What is the current stock of all products in the main warehouse?"
  • "Which customer orders from this week are not shipped yet?"
  • "Show the profit by product for October."
  • "Create a customer order for ООО Ромашка: 10 pieces of the product Чайник 1,7 л."
  • "Which counterparties bought the most last quarter?"

FAQ

Where does the token come from? In MoySklad, settings (Настройки), access tokens (Токены): create a token for the user the AI should act as and copy it, it is shown once. The token has the rights of that user, so a user with read-only rights makes a read-only connector.

What does it cover? The assortment and products with folders, stock reports overall, per store and the fast current stock, counterparties, customer orders with their statuses, shipments (demands), supplies, outgoing invoices, stores, organizations, and the profit, turnover and dashboard reports. Amounts are in kopecks and dates in Moscow time. Deleting objects and payments are not part of the connector.

Which tools write, and what installs switched off? Products, counterparties and customer orders can be created and updated. Nothing installs switched off; the AI shows each write and waits for your confirmation.

Which Copilot is this for? Microsoft 365 Copilot at work, through agents built in Copilot Studio. The Microsoft Copilot app for personal accounts has no option to add your own MCP server.

What do I need? A work account with access to Copilot Studio (a license or a trial) to build the agent. People who use it in Microsoft 365 Copilot or Teams need access to the agent: share it with them, or ask an admin to publish it to the organization. If your organization applies data policies to Power Platform connectors, they cover MCP servers too.

The agent doesn't call the tools. Check that the header name is exactly X-API-Key and that the key belongs to the same MCP server as the URL, and make the server description specific: Copilot Studio uses it to decide when to call the server. Publish the agent again after each change; in an open chat, type "start over" to get the new version.

Next steps

Was this guide helpful?

Connect MoySklad to Microsoft Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect MoySklad in the guided setup, then add your MCP URL to Microsoft Copilot. No code and no server to run.

Related guides

Connectors

Connect MoySklad to ChatGPT via MCP

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.

Connectors

Connect MoySklad to Claude via MCP

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.

Connectors

Connect MoySklad to Cursor via MCP

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.

Connectors

Connect MoySklad to Gemini CLI via MCP

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.

Connectors

Connect MoySklad to Meta Muse via MCP

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.

Connectors

MoySklad MCP Server: Stock, Orders and Reports

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.