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 傳輸的遠端 Model Context Protocol 伺服器:透過單一 POST 請求進行 JSON-RPC 2.0 通訊。伺服器為無狀態,因此沒有 session header,也沒有伺服器主動發起的事件串流,GET 請求會回傳 405。

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

驗證

OAuth 2.1:授權碼搭配 PKCE,加上動態用戶端註冊(Dynamic Client Registration),讓用戶端無需手動設定即可自行註冊。探索機制以常見方式運作,未驗證的請求會回傳 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 解析。用戶端永遠不會提供組織資訊,因此無法請求其他公司的資料。資料庫底層的列級安全性(row-level security)也強制執行相同的邊界。

伺服器為唯讀。沒有任何工具可以建立、編輯或刪除任何內容。

工具

find_movements

列出或搜尋廢棄物運送記錄(Waste Transfer Notes)與工作。

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必填公司或場址名稱。

限制與格式

重量以公斤為單位回傳,除非欄位名稱標示為 tonnes。日期為 ISO 格式(YYYY-MM-DD)。兩個搜尋工具回傳最近 25 筆相符記錄;count_movements 最多讀取 1,000 列,達到上限時會回報 count_is_capped,因此設上限的數字絕不會被呈現為精確總數。以樣本資料建立的記錄會從所有結果中排除。

需求

需具備 Pro 方案或以上的 LoadSnap 帳戶,以及屬於 LoadSnap 組織的登入帳號。每位連接者皆使用自己的登入帳號,因為連線是以個人身分授權。

對連接器有疑問?請寄送電子郵件至 info@loadsnap.co.uk,或閱讀 連接器總覽