moysklad-mcp — MCP-сервер для Claude Code: что делает и как установить
Связывает ИИ-ассистента с сервисом МойСклад через JSON API 1.2. Помогает проверять остатки, выставлять счета и оформлять складские документы без перехода в веб-интерфейс.
claude mcp add moysklad-mcp -- npx -y @theyahia/moysklad-mcpЧто делает moysklad-mcp
Сервер предоставляет 60 инструментов для управления складом через JSON API 1.2. Он умеет находить товары, проверять остатки и оформлять заказы покупателей. Поддерживаются документы отгрузки, перемещения и списания. Лимиты запросов к API соблюдаются автоматически.
Цены не нужно пересчитывать в копейки: сервер переводит рубли сам в обе стороны. Исключением остаётся отчёт get_dashboard, который отдаёт сырые копейки из API. При создании товаров тип цены берётся из аккаунта по умолчанию.
Для подключения нужен токен MOYSKLAD_TOKEN или связка логина и пароля. Генерация нового токена сразу делает недействительным предыдущий. Для вызова вебхуков и части отчётов понадобится платный тариф МоегоСклада.
Какие задачи решает
- узнать остатки и резервы товаров по складам
- создать заказ покупателя или поставщика
- оформить отгрузку, перемещение или списание
- найти контрагента по ИНН или номеру телефона
Примеры запросов агенту
- Сколько штук товара с артикулом 1042 сейчас свободно на складе?
- Создай заказ покупателя на ООО «Вектор» с двумя позициями из каталога.
- Покажи остатки и резервы по всем складам для категории футболок.
Как установить moysklad-mcp
Командой платформы
claude mcp add moysklad-mcp -- npx -y @theyahia/moysklad-mcpКомандой платформы
codex mcp add moysklad-mcp -- npx -y @theyahia/moysklad-mcpФайл настроек
{
"mcpServers": {
"moysklad-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/moysklad-mcp"
]
}
}
}Файл настроек
{
"servers": {
"moysklad-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/moysklad-mcp"
]
}
}
}Командой платформы
gemini mcp add moysklad-mcp npx -y @theyahia/moysklad-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о moysklad-mcp
Как установить moysklad-mcp в Claude Code?
Выполните команду claude mcp add moysklad-mcp -- npx -y @theyahia/moysklad-mcp. Перед запуском передайте Bearer-токен через переменную окружения MOYSKLAD_TOKEN.
Что делает moysklad-mcp?
Предоставляет агенту 60 инструментов для работы со складом, каталогом, заказами и контрагентами сервиса МойСклад. Он умеет создавать документы отгрузки, проверять наличие и обновлять цены.
В каком формате сервер принимает и возвращает цены?
Сервер работает с рублями и сам переводит их в копейки для API. Только в отчёте get_dashboard показатели остаются в копейках без пересчёта.
