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,或閱讀 連接器總覽。