LoadSnap

официальный

Запрашивайте свои записи о соответствии требованиям по обращению с отходами в Великобритании из любого ИИ-ассистента. Доступ только для чтения к вашим собственным транспортным накладным на отходы, квитанциям, тоннажу и отправкам в DEFRA Digital Waste Tracking.

Что можно делать с LoadSnap MCP?

  • Поиск перемещений отходов — Запросите транспортные накладные на отходы или задания по перевозчику, производителю или имени клиента и диапазону дат с помощью find_movements.
  • Просмотр квитанций объекта — Получите список входящих квитанций о приеме отходов на вашем объекте, отфильтрованных по перевозчику, производителю или диапазону дат с помощью find_receipts.
  • Сводка итогов перемещений — Получите количество перемещений и общий вес за период, при необходимости с разбивкой по направлению (входящие/исходящие), используя count_movements.
  • Проверка статуса отчетности DEFRA — Подсчитайте и выведите список отправок в системе Digital Waste Tracking, включая невыполненные записи, с помощью defra_filings.
  • Определение названий компаний — Сопоставьте название компании или объекта с вашими известными перевозчиками и объектами с помощью find_parties.

Документация

Справочник по MCP-серверу

Всё необходимое для подключения AI-ассистента к аккаунту LoadSnap и то, что он сможет читать после подключения.

Конечная точка

https://app.loadsnap.co.uk/api/mcp

Удалённый сервер Model Context Protocol, использующий транспорт Streamable HTTP: JSON-RPC 2.0 через один POST-запрос. Сервер не хранит состояние, поэтому нет заголовка сессии и нет инициируемого сервером потока событий, а GET-запрос возвращает 405.

Добавьте его в Claude, Claude Code, ChatGPT, Cursor или любой другой MCP-совместимый клиент как пользовательский или удалённый коннектор, используя этот URL. Вставлять API-ключ не нужно.

Аутентификация

OAuth 2.1: код авторизации с PKCE, плюс динамическая регистрация клиента, поэтому клиент регистрируется сам без ручной настройки. Обнаружение работает стандартным образом: неаутентифицированный запрос возвращает 401 с заголовком WWW-Authenticate, указывающим на метаданные защищённого ресурса.

Метаданные защищённого ресурса/.well-known/oauth-protected-resource
Метаданные сервера авторизации/.well-known/oauth-authorization-server
Динамическая регистрация клиента/api/oauth/register
Авторизация/oauth/authorize
Токен/api/oauth/token

Пользователь входит в LoadSnap и одобряет подключение на экране, где указаны клиент и его организация. Токены доступа действуют один час и обновляются с помощью refresh-токена, поэтому подключение продолжает работать без повторного входа.

Доступ авторизуется для конкретного человека, а не для ключа. Членство в организации и тарифный план проверяются при каждом запросе, поэтому удаление человека из организации прекращает и доступ его коннектора.

Область доступа

Каждый запрос жёстко фильтруется по организации авторизованного пользователя, которая определяется на стороне сервера из токена. Клиент никогда не указывает организацию, поэтому не может запросить данные другой компании. Безопасность на уровне строк обеспечивает ту же границу в нижележащей базе данных.

Сервер доступен только для чтения. Нет ни одного инструмента, который создаёт, изменяет или удаляет что-либо.

Инструменты

find_movements

Выводит список или выполняет поиск записей о перемещении отходов (Waste Transfer Notes) и заданий.

nameoptionalНазвание производителя, заказчика или перевозчика. Опустите, чтобы вывести всё в диапазоне дат.
date_fromoptionalДата в формате ISO (YYYY-MM-DD), нижняя граница по дате сбора.
date_tooptionalДата в формате ISO (YYYY-MM-DD), верхняя граница по дате сбора.

find_receipts

Выводит список или выполняет поиск квитанций о прибытии отходов на собственную площадку организации.

nameoptionalНазвание перевозчика или производителя. Опустите, чтобы вывести всё принятое в диапазоне.
date_fromoptionalДата в формате ISO (YYYY-MM-DD), нижняя граница по дате получения.
date_tooptionalДата в формате ISO (YYYY-MM-DD), верхняя граница по дате получения.

count_movements

Подсчитывает перемещения за период и суммирует их вес, опционально с разбивкой по направлению.

date_fromoptionalДата в формате ISO (YYYY-MM-DD), нижняя граница по дате сбора.
date_tooptionalДата в формате ISO (YYYY-MM-DD), верхняя граница по дате сбора.
directionoptionalinbound, outbound или all. Inbound — отходы, принятые на собственной площадке организации.

defra_filings

Подсчитывает и выводит список отправок в DEFRA Digital Waste Tracking, а также записи, ожидающие отправки.

date_fromoptionalДата в формате ISO (YYYY-MM-DD), нижняя граница по дате отправки.
date_tooptionalДата в формате ISO (YYYY-MM-DD), верхняя граница по дате отправки.
include_outstandingoptionalТакже возвращать записи, ещё не отправленные. По умолчанию true.

find_parties

Сопоставляет название компании или площадки с известными организации перевозчиками и площадками.

namerequiredНазвание компании или площадки.

Ограничения и форматы

Вес возвращается в килограммах, если в названии поля не указано иное. Даты — в формате ISO (YYYY-MM-DD). Два инструмента поиска возвращают 25 последних совпадений; count_movements читает до 1 000 строк и сообщает count_is_capped при достижении этого предела, поэтому ограниченное значение никогда не выдаётся за точную сумму. Записи, добавленные как образцы, исключаются из всех результатов.

Требования

Аккаунт LoadSnap на тарифе Pro или выше и логин, принадлежащий организации LoadSnap. Каждый подключающийся использует собственный логин, поскольку подключение авторизуется от его имени.

Вопросы о коннекторе? Напишите на info@loadsnap.co.uk или прочитайте обзор коннектора.