Вопросы
Коротко о главном
12 вопросов о подключении, правах, лимитах и работе инструментов. Если ответа нет — начните со страницы «Подключение»: там пошаговая инструкция и разбор типовых проблем.
Список вопросов
Как получить токен доступа?
Командой php artisan mcp:token --name=dsh-prod. Создаётся служебный пользователь mcp@dealshub.local и Personal Access Token с abilities mcp:read и mcp:write. Значение токена показывается один раз. Флаги: --abilities=mcp:read для токена только на чтение, --revoke-all для отзыва прежних токенов.
Чем HTTP отличается от STDIO?
HTTP (POST /mcp/dealshub) подходит удалённым агентам: запросы авторизуются токеном Sanctum, работают abilities и лимит запросов. STDIO (php artisan mcp:start dealshub) запускает сервер локально рядом с проектом; аутентификации нет, доступ ограничен самим фактом запуска процесса.
Клиент не умеет передавать заголовки. Что делать?
Токен можно передать query-параметром: POST /mcp/dealshub?token=<token>. Middleware mcp.token переносит его в заголовок Authorization и удаляет из запроса, чтобы значение не попало в логи.
Что вернётся, если товара или заказа нет?
Инструменты чтения не поднимают ошибку: get_product_details вернёт { found: false, product_id }, get_order_summary — { found: false, order_id }. Так агенту не нужно разбирать исключение, чтобы отличить «нет данных» от сбоя.
Как проверить ответ перед записью?
save_seo_meta поддерживает dry_run: вызов с dry_run=true возвращает подготовленные значения без записи в базу. Для заказов безопасная последовательность — search_products → calculate_price → create_order.
Логируются ли персональные данные клиентов?
Журнал MCP-вызовов пишет метод, имя инструмента, ключи аргументов, пользователя, статус и длительность. Значения аргументов и токены в журнал не попадают.
Какие MCP-клиенты поддерживаются?
Любой клиент, работающий по Model Context Protocol: Claude Desktop, Cursor, DeepSeek Harness и собственные агенты на JSON-RPC 2.0. Для удалённых клиентов используйте HTTP-транспорт, для локальных — STDIO.
Есть ли ограничение на объём выдачи?
Да. Поиск товаров отдаёт не больше 100 записей за вызов (по умолчанию 20), справочники — от 50 до 500 в зависимости от инструмента. Для полного обхода используйте limit и offset; каталог целиком одним ответом не выгружается.
Кешируются ли ответы?
Ответы поиска товаров кешируются на 300 секунд (ai.mcp.products.cache_ttl). Запись через create_order, create_order_claim и save_seo_meta кеш не использует — данные читаются и пишутся напрямую.
Что происходит при ошибке валидации?
Ответ приходит с транспортным кодом 200, но внутри JSON-RPC result.isError = true и текстом ошибки. Так клиент не путает ошибку входных данных с сетевой ошибкой или сбоем сервера.
Можно ли ограничиться чтением?
Да. Команда php artisan mcp:token --name=readonly --abilities=mcp:read выдаёт токен без права записи: создать заказ, рекламацию или записать SEO-мета таким токеном нельзя.
Как узнать актуальные схемы параметров?
Вызовите tools/list — сервер вернёт список инструментов с описаниями и JSON-схемами аргументов для текущей версии. Справочник на сайте описывает те же инструменты в человекочитаемом виде.