摘要
MoySklad (МойСклад) JSON API 1.2 用于贸易和仓库管理:商品和产品、库存报告、交易方、客户订单、发货、供应、发票、商店以及利润和营业额报告。访问令牌。
引导式设置
2 分钟将 MoySklad 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 MoySklad,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
MoySklad 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → MoySklad,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
MoySklad
MoySklad (МойСклад) JSON API 1.2 用于贸易和仓库管理:商品和产品、库存报告、交易方、客户订单、发货、供应、发票、商店以及利润和营业额报告。访问令牌。
设置
设置大约需要 3 分钟。
- 在 MoySklad 中打开设置 (Настройки) 和访问令牌 (Токены) 部分,为 AI 应该作为的用户创建一个令牌,并复制它。它只显示一次。
- 将其粘贴到
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 л。"
- "上个季度哪些交易方购买最多?"
下一步
这份指南对你有帮助吗?