Подключение WMS к MCP-клиенту
Через MCP помощник может читать данные WMS с правами вашего ключа API. Например, клиент может проверить свою заявку, а сотрудник фулфилмента — найти документы, которые держат резерв товара.
Настройка подключения
Выберите в MCP-клиенте удалённый сервер с транспортом Streamable HTTP. Подставьте домен своей площадки и выберите адрес для своего типа ключа.
| Ключ | Путь на площадке |
|---|---|
| Ключ клиентского API | /api/mcp/ |
| Ключ внешнего API фулфилмента | /extapi/mcp/ |
Полный адрес выглядит как https://<домен-площадки>/api/mcp/. В настройках секретного заголовка укажите Authorization: Bearer <ключ>. Если программа предлагает поле Bearer token, введите в него только значение ключа. Оба адреса используют этот заголовок, в том числе для ключа, который клиентский REST API обычно принимает в URL.
Подойдёт программа с поддержкой произвольного HTTP-заголовка или статического Bearer-токена. Интерактивный вход через OAuth в этой версии отсутствует.
Какие данные увидит помощник
После подключения клиент запрашивает tools/list. Сервер возвращает доступные этому ключу инструменты и параметры. Первый выпуск предоставляет методы чтения с ответом в JSON. Склад, клиент, видимость документов, лимиты выборки и дополнительные права проверяются тем же обработчиком, что и в REST. Для ряда складских документов видимость зависит от всех клиентов в их составе.
Клиентский ключ может, например, получить список заявок на отгрузку. Для этого ему нужен доступ к dispatchorders/list. На складском входе для запроса резервов нужен доступ к stock-reservations/list. Если разрешено несколько складов, укажите нужный warehouse_id в аргументах инструмента.
Примеры запросов
Обычно обмен ведёт программа. При ручной проверке отправляйте JSON через POST на выбранный адрес с заголовками Content-Type: application/json, Accept: application/json, text/event-stream и Authorization. Начните с инициализации.
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"wms-client","version":"1.0"}}}
Передавайте согласованную версию в заголовке MCP-Protocol-Version следующих запросов. Отправьте уведомление и запросите список инструментов двумя отдельными POST.
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/list"}
На клиентском входе можно запросить первые пять заявок на отгрузку.
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"dispatchorders_list","arguments":{"limit":5}}}
На входе фулфилмента можно запросить резервы. Замените номера товара и склада на нужные.
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"stock_reservations_list","arguments":{"item_id":123,"warehouse_id":1,"limit":10}}}
В успешном ответе result.content[0].text содержит JSON штатного API. Следующая страница запрашивается параметрами соответствующего метода. Полное описание полей приведено в документации REST.
Если запрос отклонён
При HTTP 401 проверьте ключ и адрес подключения. При HTTP 403 проверьте доступность API для площадки и, если запрос идёт из браузера, источник запроса. Если инструмента нет в списке, проверьте разрешения ключа и запросите список заново. Ошибка исполнения доступного инструмента возвращается с result.isError: true. Ошибка параметров или неизвестный инструмент возвращаются в поле JSON-RPC error.