Безопасность

Доступ ограничен токеном и правами

Проверка ability выполняется до валидации полей и работает fail closed: без подтверждённого пользователя инструмент отказывает, а не пропускает вызов. Значения аргументов и токены в журнал не попадают.

read-инструментов: 12
write-инструментов: 3
Запросов/мин: 60
Транспорта: 2

Гранулярные abilities

Токен выдаётся с abilities mcp:read и mcp:write. Команда выдачи позволяет ограничиться чтением.

mcp:read 12 инструментов

search_products Фильтры: фабрика, стиль, материал, цвет, размер, система открывания. Кеш 300 с.
get_product_details Опции со значениями, изображения, атрибуты, акции, описание.
calculate_price Каждое правило возвращается отдельной строкой в markups[].
get_order_summary Полная карточка заказа с вложенными сущностями.
get_order_claims Фильтры по заказу, статусу и признаку закрытия.
get_leads Корзина, источник, страница заявки, статус и менеджер.
get_categories Дерево категорий и коллекций с количеством товаров.
get_factories Фабрики со страной, сайтом и числом товаров.
get_opening_systems Системы открывания с ограничениями по весу и габаритам.
get_door_sizes Размеры полотен и группы размеров с коэффициентами.
get_store_seo_profile Описание магазина, шаблоны и текущие мета-поля.
list_seo_gaps Что не заполнено, постранично через limit и offset.

Каталог, цены, сводки заказов, рекламации, лиды, справочники и SEO-профиль.

mcp:write 3 инструмента

create_order Пишет 8 таблиц: orders → orders_items → … → order_logs.
create_order_claim Позиции, тип и серьёзность дефекта, ожидания клиента.
save_seo_meta Запись meta_title, meta_description и description; dry_run для проверки.

Создание заказа, создание рекламации и запись SEO-мета — только эти три операции меняют данные.

Отказ по умолчанию

Ability проверяется внутри инструмента первой — до $request->validate(). Правила вида exists:oc_product,product_id ходят в базу, и неавторизованный вызов не должен их выполнять. Отказ возвращается как isError: true с текстом «Токену не разрешено действие «mcp:…»».

Лимиты и аудит

Лимит считается на конкретный токен: ключ берётся по идентификатору Personal Access Token, затем по пользователю, затем по IP. Вызовы, отклонённые лимитом, попадают в журнал.

Лимит 60 запросов в минуту на токен, окно — 1 мин.
Превышение — статус 429, вызов не доходит до инструмента.
Журнал пишется отдельным каналом mcp в storage/logs/mcp-<date>.log.
Одна строка — один вызов; запись делается до проверки токена, поэтому отказы тоже видны.

Поля журнала

method Метод JSON-RPC: tools/call, tools/list.
tool Имя вызванного инструмента.
argument_keys Только ключи аргументов, без значений.
user_id Пользователь, которому принадлежит токен.
status Код ответа, включая 401 и 429.
duration_ms Длительность обработки вызова.

Значения аргументов, токены и пароли в журнал не записываются.

Обращение с токеном

Токен — единственный секрет на стороне клиента. Его значение показывается один раз, при выдаче.

Выдача токенов

# полный доступ: mcp:read + mcp:write
php artisan mcp:token --name=dsh-prod

# только чтение
php artisan mcp:token --name=readonly --abilities=mcp:read

# ротация: отозвать прежние и выдать новый
php artisan mcp:token --name=rotate --revoke-all

Query-параметр не попадает в логи

Middleware McpTokenFromQuery переносит ?token= в заголовок Authorization и удаляет параметр из запроса до логирования. Предпочитайте заголовок, если клиент его умеет.

Коды ответов, связанные с доступом

200

Ответ JSON-RPC, в том числе result.isError при ошибке валидации

401

Токен отсутствует или недействителен

405

GET или DELETE на эндпоинт (разрешён только POST)

429

Превышен лимит запросов на токен

Как выдать токен и настроить клиент — на странице «Подключение».

Открыть инструкцию