LoadSnap

官方

从任何AI助手查询您的英国废物合规记录。对您自己的废物转移单、收据、吨位及DEFRA数字废物追踪提交内容提供只读访问。

你可以用 LoadSnap MCP 做什么?

  • 搜索废物转运记录 — 通过 find_movements 按承运商、生产商或客户名称及日期范围查询废物转运单或作业。
  • 查看站点接收记录 — 使用 find_receipts 列出您自己站点的入库废物接收记录,并按承运商、生产商或日期范围筛选。
  • 汇总转运总量 — 使用 count_movements 获取一段时间内的转运次数和总重量,可选择按入库/出库方向拆分。
  • 检查 DEFRA 申报状态 — 使用 defra_filings 统计并列出数字废物追踪提交记录,包括未完成的记录。
  • 解析公司名称 — 使用 find_parties 将公司或站点名称与您已知的承运商和站点进行匹配。

文档

MCP 服务器参考

这里包含了将 AI 助手连接到 LoadSnap 账户所需的一切信息,以及连接后可以读取哪些内容。

端点

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

一个使用 Streamable HTTP 传输的远程模型上下文协议服务器:通过单个 POST 请求进行 JSON-RPC 2.0 通信。该服务器是无状态的,因此没有会话头,也没有服务器发起的事件流,GET 请求将返回 405。

将该 URL 作为自定义或远程连接器添加到 Claude、Claude Code、ChatGPT、Cursor 或任何其他兼容 MCP 的客户端中。无需粘贴 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 并在显示客户端及其组织名称的屏幕上批准连接。访问令牌有效期为 1 小时,并通过刷新令牌续期,因此连接无需重新登录即可持续工作。

访问权限以个人身份授权,而非密钥。每次请求都会重新检查组织成员资格和套餐,因此将某人从组织中移除后,其连接器访问权限也会随之终止。

访问范围

每个查询都会根据授权用户的组织进行硬过滤,该组织由服务器端从令牌中解析。客户端从不提供组织信息,因此无法请求其他公司的数据。行级安全在底层数据库中也强制执行相同的边界。

该服务器是只读的。没有任何工具可以创建、编辑或删除任何内容。

工具

find_movements

列出或搜索废物转移记录(废物转移单)和作业。

name可选生产商、客户或承运商名称。省略则列出日期范围内的所有记录。
date_from可选收集日期的 ISO 日期(YYYY-MM-DD)下限。
date_to可选收集日期的 ISO 日期(YYYY-MM-DD)上限。

find_receipts

列出或搜索到达组织自有场地的废物接收记录。

name可选承运商或生产商名称。省略则列出范围内收到的所有记录。
date_from可选接收日期的 ISO 日期(YYYY-MM-DD)下限。
date_to可选接收日期的 ISO 日期(YYYY-MM-DD)上限。

count_movements

统计一段时间内的废物转移数量并汇总其重量,可选按方向拆分。

date_from可选收集日期的 ISO 日期(YYYY-MM-DD)下限。
date_to可选收集日期的 ISO 日期(YYYY-MM-DD)上限。
direction可选inbound、outbound 或 all。inbound 指在组织自有场地接收的废物。

defra_filings

统计并列出 DEFRA 数字废物跟踪提交记录,以及仍待提交的记录。

date_from可选提交日期的 ISO 日期(YYYY-MM-DD)下限。
date_to可选提交日期的 ISO 日期(YYYY-MM-DD)上限。
include_outstanding可选同时返回尚未提交的记录。默认为 true。

find_parties

将公司或场地名称解析为组织已知的承运商和场地。

name必填公司或场地名称。

限制与格式

除非字段名称标明为吨,否则重量以千克为单位返回。日期为 ISO 格式(YYYY-MM-DD)。两个搜索工具返回最近 25 条匹配记录;count_movements 最多读取 1,000 行,并在达到该上限时报告 count_is_capped,因此封顶数字绝不会被呈现为精确总数。作为样本植入的记录会从所有结果中排除。

要求

需要 Pro 或以上套餐的 LoadSnap 账户,以及属于 LoadSnap 组织的登录账号。每个连接者都使用自己的登录账号,因为连接是以其个人身份授权的。

对连接器有疑问?发送邮件至 info@loadsnap.co.uk,或阅读连接器概述