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

将 MoySklad MCP 连接到 Cursor

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 连接到 Cursor

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

无需信用卡 · 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 + Cursor

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

前提条件

请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

MOYSKLAD_TOKEN

第一步 — 获取凭据

设置大约需要 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 次相同的失败请求),因此不要在循环中重试错误。删除对象和支付不属于此连接器的范围。

第二步 — 安装适配器

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

第三步 — 在 Cursor 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换 YOUR_MCP_API_KEY。
  2. 保存文件并重启 Cursor。
  3. 打开 Cursor → Settings → MCP,确认 anythingmcp 已列出并处于已连接状态。
  4. 开始对话 — 智能体现在可以调用 MoySklad 的工具。

可用工具

工具功能
moysklad_get_employee_context读取令牌所属的员工:姓名、电子邮件、账户以及每个实体的权限。用于检查令牌及其可能…
moysklad_list_assortment列出所有可以销售的商品:产品、变体(修改)、服务、捆绑和寄售,每个都有 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 л。"
  • "上个季度哪些交易对手购买最多?"

常见问题

令牌来自哪里? 在 MoySklad 中,设置 (Настройки)、访问令牌 (Токены):为 AI 应该作为的用户创建一个令牌并复制,它只显示一次。该令牌具有该用户的权限,因此具有只读权限的用户会生成只读连接器。

它覆盖哪些内容? 商品和产品及其文件夹、总体库存报告、按商店的库存报告和快速当前库存、交易对手、客户订单及其状态、发货(需求)、供应、发票、商店、组织,以及利润、周转和仪表板报告。金额以戈比为单位,日期使用莫斯科时间。删除对象和支付不属于连接器的范围。

哪些工具可以写入,哪些安装被关闭? 产品、交易对手和客户订单可以创建和更新。没有安装被关闭;AI 显示每个写入并等待你的确认。

Cursor 免费套餐支持自定义 MCP 服务器吗? 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

这份指南对你有帮助吗?

2 分钟将 MoySklad 连接到 Cursor

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

相关指南

连接器

将 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 连接到 Gemini CLI

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

连接器

将 MoySklad MCP 连接到 Meta Muse

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

连接器

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

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