连接器指南阅读约 3 分钟31 个 MCP 工具7 种语言

MoySklad MCP 服务器:库存、订单与报表

MoySklad (МойСклад) JSON API 1.2 用于贸易和仓库管理:商品和产品、库存报告、交易方、客户订单、发货、供应、发票、商店以及利润和营业额报告。访问令牌。

HC作者:HelpCode 团队更新于 3 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

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.

个工具

31

区域

INTL

类别

ERP

身份验证

Bearer Token

所需环境变量

MOYSKLAD_TOKEN
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

MoySklad (МойСклад) JSON API 1.2 用于贸易和仓库管理:商品和产品、库存报告、交易方、客户订单、发货、供应、发票、商店以及利润和营业额报告。访问令牌。

引导式设置

2 分钟将 MoySklad 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 MoySklad,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

MoySklad 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

MoySklad · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → MoySklad,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

MoySklad

MoySklad (МойСклад) JSON API 1.2 用于贸易和仓库管理:商品和产品、库存报告、交易方、客户订单、发货、供应、发票、商店以及利润和营业额报告。访问令牌。

设置

设置大约需要 3 分钟。

  1. 在 MoySklad 中打开设置 (Настройки) 和访问令牌 (Токены) 部分,为 AI 应该作为的用户创建一个令牌,并复制它。它只显示一次。
  2. 将其粘贴到 MOYSKLAD_TOKEN 中。

在没有该部分的情况下,也可以通过登录和密码发放令牌:对 /security/token 进行 POST 请求,使用 HTTP Basic 返回 access_token(这会撤销该用户之前的令牌)。令牌以其用户的权限进行操作,因此具有只读权限的用户会生成一个只读连接器。

连接器在每次调用时发送 Authorization: Bearer、Accept-Encoding: gzip 和 Accept: application/json;charset=utf-8。MoySklad 拒绝没有 gzip 的调用,返回 415 并且没有主体。

从哪里开始:moysklad_get_employee_context 显示用户及其权限。moysklad_list_assortment 搜索所有可以销售的商品,moysklad_get_current_stock 快速提供库存数字,moysklad_list_customer_orders 列出订单。

目录:moysklad_list_assortment、moysklad_list_products、moysklad_get_product、moysklad_create_product、moysklad_update_product、moysklad_list_product_folders。

库存:moysklad_get_stock_report(所有商店,包含成本和售价)、moysklad_get_stock_by_store(按商店)和 moysklad_get_current_stock(ID 和一个数字,无分页,适合频繁检查)。两个扩展报告各算作 5 次请求。

交易方:moysklad_list_counterparties、moysklad_get_counterparty、moysklad_create_counterparty、moysklad_update_counterparty。

文档:moysklad_list_customer_orders、moysklad_get_customer_order、moysklad_get_customer_order_metadata(状态)、moysklad_create_customer_order、moysklad_update_customer_order;moysklad_list_demands 和 moysklad_get_demand(发货);moysklad_list_supplies 和 moysklad_get_supply(收货);moysklad_list_invoices_out 和 moysklad_get_invoice_out。参考:moysklad_list_stores、moysklad_list_organizations。

报告:moysklad_get_profit_by_product、moysklad_get_profit_by_counterparty、moysklad_get_turnover、moysklad_get_dashboard。

分页:列表每次调用最多返回 1000 行(limit,此处默认 100)从 offset;meta.size 是总数,meta.nextHref 在更多行存在时出现。使用 expand 时限制为 100:更大的限制会使 MoySklad 忽略扩展。文档行超过前 1000 行的通过文档的位置读取。

金额和日期:所有金额和价格以戈比(小单位)表示:150000 表示 1500.00。日期格式为 YYYY-MM-DD HH:MM:SS,使用莫斯科时间。ID 为 UUID。

参考(meta):另一个对象被引用为一个包含 meta 的对象,meta 包含 href、type 和 mediaType,绝不通过裸 ID 引用。每一行都携带自己的 meta:当工具请求引用(商店、状态、订单行的商品)时复制它。在列表过滤器中,引用是其 href;在短库存报告中,它是裸 ID。

过滤器:filter 用 ; 连接条件。操作符:=、!=、>、<、>=、<=、~ 包含、~= 以...开头、=~ 以...结尾。search 是全文搜索。order 排序,例如 moment,desc。

限制:用户令牌每 3 秒获得 45 个单位,每个请求消耗几个单位(从 2026 年 12 月 1 日起为 4,因此每 3 秒大约 11 个请求;两个扩展库存报告消耗 5)。最多允许 5 个用户并行调用。429 返回 X-Lognex-Retry-After(以毫秒为单位)。MoySklad 会关闭 API 访问权限给那些持续发送失败调用的用户(每分钟超过 200 个相同的失败请求),因此不要在循环中重试错误。删除对象和支付不属于此连接器的范围。

先决条件:MOYSKLAD_TOKEN

本地安装连接器

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

打开 http://localhost:3000/connectors/store,选择 MoySklad 并粘贴在先决条件下列出的环境变量。

可用工具

工具功能
moysklad_get_employee_context读取令牌所属的员工:姓名、电子邮件、账户和每个实体的权限。用它来检查令牌及其可能…
moysklad_list_assortment列出所有可以销售的商品:产品、变体(修改)、服务、捆绑和 consignments,每个都有 ID、meta…
moysklad_list_products列出产品:ID、名称、代码、文章、描述、productFolder、uom、salePrices、buyPrice 和 minPrice(以戈比为单位)、条形码、增值税…
moysklad_get_product读取一个产品及其价格(以戈比为单位)、条形码、单位、文件夹、供应商、自定义字段(属性)和跟踪设置。只读
moysklad_create_product创建一个产品,包含名称和可选的代码、文章、描述、增值税、重量和采购价格。返回产品及其 ID 和…
moysklad_update_product更新一个产品:仅更改给定的字段。返回更新后的产品。MoySklad 阻止发送超过 100 次更新的用户…
moysklad_list_product_folders列出产品组(文件夹):ID、名称、pathName(父组的路径)、代码、描述和归档。返回 meta(大小、限制…
moysklad_get_stock_report按项目的扩展库存报告:名称、代码、文章、库存、预留、运输中和数量(可用)、价格(成本)和…
moysklad_get_stock_by_store按项目和商店的库存报告:每行都有项目 meta 和 stockByStore,包含名称、库存、预留和运输中。每次调用…
moysklad_get_current_stock短库存报告,适合频繁检查:仅 assortmentId(和 storeId,按商店范围)及一个数字,单次回答,无…
moysklad_list_counterparties列出交易方(客户和供应商):ID、名称、代码、公司类型、inn、kpp、法律名称、电话、电子邮件、实际地址、标签…
moysklad_get_counterparty读取一个交易方的法律详情(inn、kpp、法律地址)、联系人、银行账户、标签、折扣、价格类型和自定义字段…
moysklad_create_counterparty创建一个交易方(客户或供应商),包含名称和可选的类型、税号、地址、电话、电子邮件和标签。返回…
moysklad_update_counterparty更新一个交易方:仅更改给定的字段;给定的标签列表替换旧列表。返回更新后的交易方
moysklad_list_customer_orders列出客户订单:ID、名称(订单号)、时刻、总额、已支付总额、已发货总额、已开票总额和预留总额(以戈比为单位)、适用…
moysklad_get_customer_order读取一个客户订单:编号、时刻、总额(以戈比为单位)、交易方(代理)、组织、商店、状态、发货地址、评论和…
moysklad_get_customer_order_metadata读取客户订单的元数据:状态(statuses)及其 ID、名称、状态类型和 meta,以及自定义字段(属性)。该…
moysklad_create_customer_order为一个组织(你的法律实体)和一个交易方创建一个客户订单,包含订单行。返回订单及其 ID、编号…
moysklad_update_customer_order更新一个客户订单:评论、计划发货日期、状态、商店或草稿标志。仅更改给定的字段。要更改订单…
moysklad_list_demands列出需求(发货给客户):ID、名称、时刻、总额和已支付总额(以戈比为单位)、代理、组织、商店、状态、客户订单…
moysklad_get_demand读取一个需求(发货):编号、时刻、总额(以戈比为单位)、交易方、商店、收货人和承运人详情及关联客户…
moysklad_list_supplies列出供应(从供应商收到的货物):ID、名称、时刻、总额和已支付总额(以戈比为单位)、代理(供应商)、组织、商店…
moysklad_get_supply读取一个供应(收货):编号、时刻、总额(以戈比为单位)、供应商、商店、入库单号和附加费用。添加…
moysklad_list_invoices_out列出发给客户的发票:ID、名称、时刻、总额、已支付总额和已发货总额(以戈比为单位)、代理、组织、计划支付时刻和…
moysklad_get_invoice_out读取一张发给客户的发票:编号、时刻、总额和已支付总额(以戈比为单位)、交易方、组织及其银行账户和…
moysklad_list_stores列出商店(仓库):ID、名称、代码、地址、nested stores 的 pathName、归档和 meta。meta 是订单和报告…
moysklad_list_organizations列出你的组织(法律实体):ID、名称、法律名称、inn、kpp、法律地址、公司类型和 meta。订单始终需要一个…
moysklad_get_profit_by_product按产品、服务和捆绑的利润报告:sellQuantity、sellPrice、sellCost、sellSum、sellCostSum、returnQuantity…
moysklad_get_profit_by_counterparty按客户的利润报告:demandsCount、demandsSum、averageReceipt、returnsCount、returnsSum、discountsSum、balance…
moysklad_get_turnover按项目的营业额报告:开始时的库存(onPeriodStart)、收入、支出和结束时的库存(onPeriodEnd),每个都有…
moysklad_get_dashboard今天、上周或上个月的关键数据:销售(数量、金额、流动金额)、订单(数量、金额、流动金额)和…

示例提示

  • "主仓库中所有产品的当前库存是多少?"
  • "本周哪些客户订单尚未发货?"
  • "显示十月份按产品的利润。"
  • "为 ООО Ромашка 创建一个客户订单:10 件产品 Чайник 1,7 л。"
  • "上个季度哪些交易方购买最多?"

下一步

这份指南对你有帮助吗?

2 分钟将 MoySklad 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 MoySklad,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

相关指南

连接器

将 MoySklad MCP 连接到 ChatGPT

MoySklad (МойСклад) JSON API 1.2 用于贸易和仓库管理:商品和产品、库存报告、交易对手、客户订单、发货、供应、发票、商店以及利润和周转报告。访问令牌。

连接器

将 MoySklad MCP 连接到 Claude

MoySklad (МойСклад) JSON API 1.2 用于贸易和仓库管理:商品和产品、库存报告、交易对手、客户订单、发货、供应、发票、商店以及利润和周转报告。访问令牌。

连接器

将 MoySklad MCP 连接到 Microsoft Copilot

MoySklad (МойСклад) JSON API 1.2 用于贸易和仓库管理:商品和产品、库存报告、交易对手、客户订单、发货、供应、发票、商店以及利润和周转报告。访问令牌。

连接器

将 MoySklad MCP 连接到 Cursor

MoySklad (МойСклад) JSON API 1.2 用于贸易和仓库管理:商品和产品、库存报告、交易对手、客户订单、发货、供应、发票、商店以及利润和周转报告。访问令牌。

连接器

将 MoySklad MCP 连接到 Gemini CLI

MoySklad (МойСклад) JSON API 1.2 用于贸易和仓库管理:商品和产品、库存报告、交易对手、客户订单、发货、供应、发票、商店以及利润和周转报告。访问令牌。

连接器

将 MoySklad MCP 连接到 Meta Muse

MoySklad (МойСклад) JSON API 1.2 用于贸易和仓库管理:商品和产品、库存报告、交易对手、客户订单、发货、供应、发票、商店以及利润和周转报告。访问令牌。