LoadSnap

MCP 服务器参考

连接 AI 助手到 LoadSnap 账户所需的一切，以及连接后可以读取的内容。

端点

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

一个使用 Streamable HTTP 传输的远程 Model Context Protocol 服务器：通过单个 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 并在显示客户端名称及其组织的屏幕上批准连接。访问令牌有效期为一小时，并通过刷新令牌续期，因此连接无需重新登录即可持续工作。

访问是以个人身份授权的，而不是以密钥形式。每次请求都会重新检查组织成员资格和套餐，因此将某人从组织中移除也会同时终止其连接器访问权限。

访问范围

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

21 个工具中有 15 个只读。名称以 create_ 开头的 6 个工具仅添加记录，不做其他操作：不编辑、不删除、不向 DEFRA 提交、不签署转移单、不开具发票、不发放办公登录权限。每个工具都在其注释中标记为写入操作，因此客户端在运行前会先询问用户。

组织范围限制的唯一例外是 find_waste_codes，它搜索已发布的欧洲废物目录——这是每个人相同的国家列表，不涉及任何人的自有数据。

工具

21 个工具，每个都限定在已授权组织范围内。下面列出了每个工具及其提供给客户端的描述和接受的参数。标记为写入的工具会添加记录；其余只读。

find_movements

查找废物转移记录

按生产者、客户或承运人名称和/或收集日期范围，列出或搜索此组织的废物转移记录（废物转移单）和作业。用于“我们是否为 X 做过转移”、“我们在 5 月从 Y 收集了什么”，或完全不提供名称时用于“我们上周转移了什么”。

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 = 其卡车运走或送出的废物。省略则统计全部。

defra_filings

DEFRA 提交记录

统计并列出此组织在日期范围内的 DEFRA 废物追踪提交记录，并列出仍待提交的记录。用于“我们本周提交了多少次 DEFRA 申报”、“是否有任何提交在 DEFRA 失败”、“还有哪些未完成”。

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

find_parties

查找承运人和场地

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

name	必填	公司或场地名称

find_jobs

查找计划作业

按客户名称和/或计划日期范围，列出或搜索此组织的作业——已预订、进行中或已完成。用于“我们明天做什么”、“Carter 的作业是否已预订”、“还有哪些未分配”。从最早的日期向前读取，因为作业列表就是一本日记。

name	可选	要搜索的客户名称。省略则列出范围内的所有记录。
status	可选	要筛选的作业状态，例如 draft、scheduled、in_progress、completed、cancelled。
date_from	可选	可选的 ISO 日期（YYYY-MM-DD）下限
date_to	可选	可选的 ISO 日期（YYYY-MM-DD）上限

find_invoices

发票和应收款项

列出此组织的发票并汇总仍欠款的总额，可选择仅列出未付款的发票。用于“谁欠我们钱”、“有多少未结款项”、“Carter 的发票是否已付款”、“哪些已逾期”。总额以发票货币计算。

name	可选	发票开具对象的企业名称。省略则列出范围内的所有记录。
status	可选	要筛选的发票状态，例如 draft、issued、paid、void。
only_unpaid	可选	仅列出仍有余额待付的发票。默认为 false。
date_from	可选	可选的 ISO 日期（YYYY-MM-DD）下限
date_to	可选	可选的 ISO 日期（YYYY-MM-DD）上限

find_vehicles

车辆及其证件

列出此组织的车辆及其 MOT、税费和保险到期日期，并标记任何已过期的车辆。用于“车队里有什么车”、“是否有 MOT 过期的车辆”、“VX19 ABC 的税费何时到期”。MOT 和税费信息来自 DVLA，其新鲜度取决于上次检查的时间。

name	可选	要搜索的注册号或描述。省略则列出范围内的所有记录。
include_inactive	可选	同时返回已从车队中移除的车辆。默认为 false。

find_people

团队成员及其可用权限

列出此组织团队中的人员，以及每人持有的三种登录方式中的哪些：办公登录、司机应用、地磅应用。用于“谁为我们开车”、“Dave 是否有司机应用”、“团队中有谁”。

name	可选	要搜索的人员姓名或电子邮件。省略则列出范围内的所有记录。
drivers_only	可选	仅列出持有司机应用的人员。默认为 false。

compliance_status

证书、许可证和注册

列出此组织已记录的证书、许可证和注册及其到期日期，并说明哪些已经过期。用于“我们的废物承运人注册是否仍然有效”、“今年有哪些到期”、“我们是否有 ISO 证书存档”。

expired_only	可选	仅列出已过期的项目。默认为 false。

find_documents

查找文档

按类型和/或日期查找此组织存储的文档——废物转移单、托运单、许可证、上传的纸质文件——并提供每个文档的链接。用于“把那一车货的转移单发给我”、“这个作业我们有哪些文件”。

document_type	可选	要筛选的文档类型，例如 wtn、hwcn、annex_vii、permit、upload。
movement_id	可选	仅列出附加到此废物转移记录的文档。
job_id	可选	仅列出附加到此作业的文档。
date_from	可选	可选的 ISO 日期（YYYY-MM-DD）下限
date_to	可选	可选的 ISO 日期（YYYY-MM-DD）上限

container_stock

料斗和容器

此组织持有的容器及其位置：按资产编号和状态逐一跟踪的容器，以及按运行总量持有的类型。用于“我们有多少 8 码料斗可用”、“料斗 214 在哪里”、“哪些已出租”。

container_type	可选	要筛选的容器类型，例如 skip、roro、bin。
container_size	可选	要筛选的容器尺寸，例如 8yd。
state	可选	单独跟踪容器的状态，例如 in_yard、on_site、in_transit。

find_contracts

合同和季票

列出此组织的长期协议：合同和季票、每项涵盖的废物类型、有效日期以及双方是否已签署。用于“我们有哪些合同”、“那个季票是否已签署”、“这个月有哪些到期”。

site_id	可选	仅列出此场地的协议。
active_only	可选	仅列出仍然有效的协议。默认为 false。

consignee_returns

季度收货人申报

此组织接收危险废物的季度收货人申报：季度、何时应提交、多少批货物及重量，以及是否已发送。用于“我们的收货人申报是否已完成”、“本季度应提交什么”。仅限接收方；承运人没有此项。

quarter	可选	季度标签，例如“Q1 2026”。
status	可选	要筛选的状态：not_started、generated、reviewed 或 submitted。

find_waste_codes

查找废物代码

按代码或废物类型搜索欧洲废物目录（EWC），并说明每个代码是否为危险废物或镜像条目。用于“石膏板用什么代码”、“17 05 03 是否危险”。这是已发布的国家列表，不是此组织自己的数据。

query	必填	代码或代码的一部分（“17 05”），或描述废物的词语（“石膏板”）。
hazardous_only	可选	仅列出危险代码。默认为 false。

create_customer

添加客户写入

添加客户（组织收集废物的收集场地）。如果缺少任何必填项，则回复仍需要什么，并且不写入任何内容。如果同名称和邮政编码的客户已存在，则返回该客户而不是创建第二个。

name	必填	废物所属的公司或个人
address	必填	废物收集地点
postcode	必填	收集地址的邮政编码
producer_type	可选	废物来自企业还是家庭。默认为 business。
contact_name	必填	现场联系人
contact_email	可选	其电子邮件地址
contact_phone	可选	其电话号码
sic_code	可选	生产者的 SIC 代码（如已知）

create_receiving_site

添加接收场地写入

添加接收场地（废物运往的倾倒场、转运站或回收设施）。如果缺少任何必填项，则回复仍需要什么，并且不写入任何内容。

name	required	站点名称
address	required	站点地址
postcode	required	站点邮政编码
permit_number	optional	环境许可证或豁免编号
contact_name	optional	门口接待的联系人
contact_email	optional	该联系人的电子邮件地址
contact_phone	optional	该联系人的电话号码
is_own_site	optional	仅当这是组织自己的站点而非他人站点时为 true。默认为 false。

create_carrier

添加承运商或经纪人writes

添加组织合作的承运商、经纪人或经销商。如果缺少任何必需信息，则回答还缺少什么，并且不写入任何内容。

company_name	required	承运商或经纪人的公司名称
registration_number	optional	其废物承运商注册号（如已知）
contact_name	optional	联系人
contact_email	optional	其电子邮件地址
contact_phone	optional	其电话号码
address	optional	其地址
postcode	optional	其邮政编码
notes	optional	值得记录的关于他们的任何信息

create_vehicle

添加车辆writes

向车队添加一辆车辆。如果缺少任何必需信息，则回答还缺少什么，并且不写入任何内容。车队中已有的注册号将返回该车辆，而不会重复创建。

registration	required	车牌号
make	optional	制造商
description	optional	型号或描述
vehicle_type	optional	车辆类型，例如翻斗卡车或自卸车
mot_expiry	optional	MOT 到期时间（YYYY-MM-DD）
tax_expiry	optional	税费到期时间（YYYY-MM-DD）
max_weight_tonnes	optional	总重量（吨）

create_driver

添加司机writes

添加一名司机，以便为其分配工作并在司机应用中签署转移单。使用套餐中的一个司机名额，如果名额已全部用完则拒绝。不会为任何人提供办公室登录权限：该权限由所有者或管理员在团队页面发放。已在团队中的人员会在其现有记录中添加司机应用。

name	required	其全名
email	required	其电子邮件地址，司机应用的邀请将发送至此
phone_number	optional	其电话号码
role	optional	其职位，例如 HGV 司机
address	optional	其家庭住址
postcode	optional	其家庭邮政编码
licence_expiry	optional	其驾照到期时间（YYYY-MM-DD）
emergency_contact_name	optional	紧急情况下联系的人
emergency_contact_phone	optional	该人的电话号码

create_enquiry

记录收集请求writes

记录客户的收集请求（询价），以便办公室进行报价。如果缺少任何必需信息，则回答还缺少什么，并且不写入任何内容。

company_name	required	提出请求的公司
contact_name	required	联系的人
contact_email	required	其电子邮件地址
contact_phone	required	其电话号码
site_address	required	废物所在位置
postcode	optional	该地址的邮政编码
waste_description	required	废物的描述（用客户的话说）
service_type	optional	其请求的服务，例如翻斗或抓斗装载
estimated_weight	optional	大致重量（吨）
preferred_date	optional	其希望的时间（YYYY-MM-DD）
access_notes	optional	关于进入现场的任何信息

写入

6 个 create_ 工具用于添加客户、接收站点、承运商或经纪人、车辆、司机和收集请求。这是人们通过对话描述数据而非填写表单或准备电子表格来将数据输入 LoadSnap 的方式。

任何内容都不会被部分写入。缺少必需信息的调用不会写入任何内容，并回答还缺少什么的列表（以问题的形式提出），以便助手询问并再次调用。对已存在记录的调用会返回现有记录，而不会重复创建，因此重复执行同一请求不会留下重复数据。

通过这种方式添加的司机使用套餐中的一个司机名额，如果名额已全部用完则被拒绝，与团队页面上的行为完全一致，并且会与团队中已有的人员进行匹配，因此已在职的人员会在其现有记录中添加司机应用。不会为任何人提供办公室登录权限：这是一个付费席位，也是进入业务的途径，由所有者或管理员在团队页面发放。

向 DEFRA 提交申报、签署转移单、开具发票和删除任何内容均有意不包含在此处。这些是人员在 LoadSnap 中执行的操作，并带有其姓名。

交互面板

服务器以 MCP 资源的形式在 ui://loadsnap/panel 发布一个交互面板，所有工具都指向该面板。支持应用扩展的客户端会将答案绘制为对话中的面板：记录表格、刚添加记录的名片，或保存前还缺少什么的清单。

它是一个自包含的文档，没有自己的数据、没有令牌，也不会从网络获取任何内容。客户端将工具的答案传入其中。每个工具也会以文本形式返回该答案，因此不绘制面板的客户端会显示与以往完全相同的内容。

限制和格式

除非字段名称注明吨，否则重量以千克返回。日期采用 ISO 格式（YYYY-MM-DD）。搜索返回最相关的 25 条匹配结果；count_movements 最多读取 1,000 行，并在达到该上限时报告 count_is_capped，因此封顶数字绝不会被呈现为精确总数。find_invoices 中欠款金额同样适用，其报告 totals_are_capped。作为样本播种的记录会从所有结果中排除。

要求

需要 Pro 或以上版本的 LoadSnap 账户，以及属于 LoadSnap 组织的登录凭据。每个连接者都使用自己的登录凭据，因为连接是以其身份授权的。

对连接器有疑问？发送电子邮件至 info@loadsnap.co.uk，或阅读连接器概述。