LoadSnap

MCP 伺服器參考

連接 AI 助理至 LoadSnap 帳戶所需的一切資訊，以及連接後可讀取的內容。

端點

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

使用 Streamable HTTP 傳輸的遠端 Model Context Protocol 伺服器：透過單一 POST 使用 JSON-RPC 2.0。伺服器是無狀態的，因此沒有 session header，也沒有伺服器發起的事件串流，GET 請求會回傳 405。

將此 URL 新增至 Claude、Claude Code、ChatGPT、Cursor 或任何其他相容 MCP 的用戶端，作為自訂或遠端連接器。無需貼上 API 金鑰。

驗證

OAuth 2.1：授權碼搭配 PKCE，加上動態用戶端註冊，因此用戶端可自行上線，無需手動設定。探索以一般方式運作，未驗證的請求會回傳 401，並附上指向受保護資源中繼資料的 WWW-Authenticate header。

受保護資源中繼資料	/.well-known/oauth-protected-resource
授權伺服器中繼資料	/.well-known/oauth-authorization-server
動態用戶端註冊	/api/oauth/register
授權	/oauth/authorize
Token	/api/oauth/token

使用者登入 LoadSnap，並在顯示用戶端名稱及其組織的畫面上核准連線。存取 token 有效期為一小時，並透過 refresh token 續期，因此連線可持續運作，無需再次登入。

存取權限以個人身分授權，而非以金鑰授權。每次請求都會重新檢查組織成員資格和方案，因此將某人從組織中移除，其連接器存取權也會隨之終止。

存取範圍

每個查詢都會被嚴格過濾至授權使用者的組織，並由伺服器端從 token 解析。用戶端永遠不會提供組織，因此無法請求其他公司的資料。資料庫底層的列級安全性也強制執行相同的邊界。

21 個工具中有 15 個僅供讀取。名稱以 create_ 開頭的 6 個工具僅新增記錄，不做其他事情：不會編輯、刪除、向 DEFRA 申報、簽署轉移單、開立發票或提供辦公室登入。每個工具在其 annotations 中標記為寫入，因此用戶端在執行前會先詢問使用者。

組織範圍的唯一例外是 find_waste_codes，它搜尋已發布的歐洲廢棄物目錄——這是每個人都相同的國家清單，而非任何人的自有資料。

工具

21 個工具，每個都限定於授權組織。以下列出每個工具及其提供給用戶端的描述和接受的參數。標記為 writes 的工具會新增記錄；其餘僅供讀取。

find_movements

尋找廢棄物清運紀錄

依產源、客戶或清運商名稱及/或收集日期範圍，列出或搜尋此組織的廢棄物清運紀錄（廢棄物轉移單）和工單。用於「我們是否為 X 做過清運」、「我們在五月從 Y 收集了什麼」，或完全沒有名稱時查詢「我們上週清運了什麼」。

name	optional	要搜尋的產源、客戶或清運商名稱。省略以列出日期範圍內的所有紀錄。
date_from	optional	可選的 ISO 日期（YYYY-MM-DD）下限
date_to	optional	可選的 ISO 日期（YYYY-MM-DD）上限

find_receipts

尋找接收收據

依清運商或產源名稱及/或接收日期範圍，列出或搜尋此組織的接收收據（抵達其自有場址的廢棄物）。省略名稱以列出範圍內接收的所有紀錄。

name	optional	清運商或產源名稱。省略以列出全部。
date_from	optional	可選的 ISO 日期（YYYY-MM-DD）下限
date_to	optional	可選的 ISO 日期（YYYY-MM-DD）上限

count_movements

計算廢棄物清運次數

計算此組織在日期範圍內的廢棄物清運次數並加總其重量，可選擇拆分為進場或出場。用於「我們上個月做了多少趟」、「我們今年處理了多少廢棄物」、「本週有多少次收集」。依收集日期計算。

date_from	optional	收集日期的 ISO 日期（YYYY-MM-DD）下限
date_to	optional	收集日期的 ISO 日期（YYYY-MM-DD）上限
direction	optional	inbound = 廢棄物運入此組織自有場址，outbound = 其卡車運走或送出的廢棄物。省略以計算全部。

defra_filings

DEFRA 申報

計算並列出此組織在日期範圍內的 DEFRA 廢棄物追蹤申報，並列出仍待申報的紀錄。用於「我們本週已申報多少筆 DEFRA 申報」、「是否有任何項目向 DEFRA 申報失敗」、「還有什麼尚未完成」。

date_from	optional	申報日期的 ISO 日期（YYYY-MM-DD）下限
date_to	optional	申報日期的 ISO 日期（YYYY-MM-DD）上限
include_outstanding	optional	同時回傳尚未向 DEFRA 申報的紀錄。預設為 true。

find_parties

尋找清運商和場址

將公司或場址名稱解析為組織已知的清運商和場址。

name	required	公司或場址名稱

find_jobs

尋找排程工單

依客戶名稱及/或排程日期範圍，列出或搜尋此組織的工單——已預約、進行中或已完成的工作。用於「我們明天要做什麼」、「Carter 的工單是否已預約」、「還有什麼尚未分配」。從最早的日期向前讀取，因為工單清單就像一本日記。

name	optional	要搜尋的客戶名稱。省略以列出範圍內的所有工單。
status	optional	要篩選的工單狀態，例如 draft、scheduled、in_progress、completed、cancelled。
date_from	optional	可選的 ISO 日期（YYYY-MM-DD）下限
date_to	optional	可選的 ISO 日期（YYYY-MM-DD）上限

find_invoices

發票與應收帳款

列出此組織的發票並加總仍欠款項，可選擇僅列出未付款的發票。用於「誰欠我們錢」、「有多少未付款項」、「Carter 的發票是否已付款」、「有哪些已逾期」。總額以發票貨幣計算。

name	optional	發票開立對象的企業名稱。省略以列出範圍內的所有發票。
status	optional	要篩選的發票狀態，例如 draft、issued、paid、void。
only_unpaid	optional	僅列出仍有餘額待付的發票。預設為 false。
date_from	optional	可選的 ISO 日期（YYYY-MM-DD）下限
date_to	optional	可選的 ISO 日期（YYYY-MM-DD）上限

find_vehicles

車輛及其文件

列出此組織的車輛及其 MOT、稅金和保險到期日，並標記任何已到期的項目。用於「車隊有哪些車輛」、「是否有任何車輛 MOT 過期」、「VX19 ABC 的稅金何時到期」。MOT 和稅金資料來自 DVLA，僅與上次檢查時一樣新。

name	optional	要搜尋的車牌或描述。省略以列出範圍內的所有車輛。
include_inactive	optional	同時回傳已從車隊移除的車輛。預設為 false。

find_people

團隊成員及其可用權限

列出此組織團隊的成員，以及每個人持有的三種存取方式：辦公室登入、司機應用程式、地磅應用程式。用於「誰為我們開車」、「Dave 是否有司機應用程式」、「團隊成員有哪些」。

name	optional	要搜尋的人員姓名或電子郵件。省略以列出範圍內的所有人員。
drivers_only	optional	僅列出持有司機應用程式的人員。預設為 false。

compliance_status

證書、許可證和註冊

列出此組織已記錄的證書、許可證和註冊，及其到期日，並指出哪些已過期。用於「我們的廢棄物清運商註冊是否仍有效」、「今年有哪些會到期」、「我們是否有 ISO 證書存檔」。

expired_only	optional	僅列出已過期的項目。預設為 false。

find_documents

尋找文件

依類型和/或日期，尋找此組織儲存的文件——廢棄物轉移單、託運單、許可證、上傳的文件——並附上每個文件的連結。用於「把那趟清運的轉移單寄給我」、「這個工單我們有哪些文件」。

document_type	optional	要篩選的文件類型，例如 wtn、hwcn、annex_vii、permit、upload。
movement_id	optional	僅列出附加到此廢棄物清運紀錄的文件。
job_id	optional	僅列出附加到此工單的文件。
date_from	optional	可選的 ISO 日期（YYYY-MM-DD）下限
date_to	optional	可選的 ISO 日期（YYYY-MM-DD）上限

container_stock

大型垃圾桶和容器

此組織持有的容器及其位置：以資產編號和狀態逐一追蹤的容器，以及以累計總數持有的類型。用於「我們有多少個 8 碼大型垃圾桶可用」、「大型垃圾桶 214 在哪裡」、「有哪些已出租」。

container_type	optional	要篩選的容器類型，例如 skip、roro、bin。
container_size	optional	要篩選的容器尺寸，例如 8yd。
state	optional	個別追蹤容器的狀態，例如 in_yard、on_site、in_transit。

find_contracts

合約和季票

列出此組織的長期協議：合約和季票、每份涵蓋的廢棄物類型、有效日期以及雙方是否已簽署。用於「我們有哪些合約」、「那份季票是否已簽署」、「這個月有哪些到期」。

site_id	optional	僅列出此場址的協議。
active_only	optional	僅列出仍有效的協議。預設為 false。

consignee_returns

季度收貨人申報

此組織針對接收的危險廢棄物的季度收貨人申報：季度、何時應提交、多少批貨物及重量，以及是否已寄出。用於「我們的收貨人申報是否已完成」、「本季度應提交什麼」。僅限接收者；清運商沒有此項目。

quarter	optional	季度標籤，例如「Q1 2026」。
status	optional	要篩選的狀態：not_started、generated、reviewed 或 submitted。

find_waste_codes

查詢廢棄物代碼

依代碼或廢棄物類型搜尋歐洲廢棄物目錄（EWC），並指出每個代碼是否為有害廢棄物或鏡像條目。用於「石膏板是什麼代碼」、「17 05 03 是否有害」。這是已發布的國家清單，而非此組織的自有資料。

query	required	代碼或部分代碼（「17 05」），或描述廢棄物的詞語（「石膏板」）。
hazardous_only	optional	僅列出有害代碼。預設為 false。

create_customer

新增客戶writes

新增客戶（組織收集廢棄物的收集場址）。若缺少任何必要項目，會回傳仍需要的內容，且不會寫入任何資料。若相同名稱和郵遞區號的客戶已存在，則回傳該客戶，而非建立第二個。

name	required	廢棄物所屬的公司或個人
address	required	廢棄物收集的地點
postcode	required	收集地址的郵遞區號
producer_type	optional	廢棄物來自企業或家庭。預設為 business。
contact_name	required	現場聯絡人
contact_email	optional	其電子郵件地址
contact_phone	optional	其電話號碼
sic_code	optional	產源的 SIC 代碼（若已知）

create_receiving_site

新增接收場址writes

新增接收場址（廢棄物運往的傾卸場、轉運站或回收設施）。若缺少任何必要項目，會回傳仍需要的內容，且不會寫入任何資料。

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 發布互動面板，所有工具皆指向該面板。支援 apps 擴充功能的用戶端會將答案繪製為對話中的面板：記錄表格、剛新增記錄的卡片，或儲存前尚缺事項的核對清單。

這是一份自包含文件，沒有自身資料、沒有權杖，也不會從網路擷取任何內容。用戶端會將工具的回覆傳入其中。每個工具也會以文字形式回傳該回覆，因此不繪製面板的用戶端會顯示與以往完全相同的內容。

限制與格式

除非欄位名稱標示公噸，否則重量以公斤回傳。日期為 ISO 格式（YYYY-MM-DD）。搜尋回傳最相關的 25 筆結果；count_movements 最多讀取 1,000 列，達到上限時會回報 count_is_capped，因此封頂數字絕不會被呈現為精確總數。find_invoices 中的應付金額亦同，會回報 totals_are_capped。作為樣本植入的記錄會從所有結果中排除。

需求

需有 Pro 方案或以上的 LoadSnap 帳戶，以及屬於 LoadSnap 組織的登入帳號。每位連線者皆使用自己的登入帳號，因為連線是以他們的身分授權。

對連接器有疑問？寄電子郵件至 info@loadsnap.co.uk，或閱讀連接器總覽。