LoadSnap

chính thức

Truy vấn hồ sơ tuân thủ chất thải của Vương quốc Anh từ bất kỳ trợ lý AI nào. Quyền truy cập chỉ đọc vào các ghi chú chuyển giao chất thải, biên nhận, trọng tải và các bản gửi DEFRA Digital Waste Tracking của riêng bạn.

Bạn có thể làm gì với LoadSnap MCP?

  • Tìm kiếm chuyển động chất thải — Yêu cầu biên nhận chuyển giao chất thải hoặc công việc theo tên nhà vận chuyển, nhà sản xuất hoặc khách hàng và phạm vi ngày qua find_movements.
  • Xem lại biên nhận tại cơ sở — Liệt kê các biên nhận chất thải đến tại cơ sở của bạn, được lọc theo nhà vận chuyển, nhà sản xuất hoặc phạm vi ngày bằng find_receipts.
  • Tóm tắt tổng số chuyển động — Lấy số lượng chuyển động và tổng trọng lượng trong một khoảng thời gian, tùy chọn chia theo hướng vào/ra, sử dụng count_movements.
  • Kiểm tra trạng thái nộp hồ sơ DEFRA — Đếm và liệt kê các bản ghi nộp Digital Waste Tracking, bao gồm các bản ghi còn tồn đọng, bằng defra_filings.
  • Giải quyết tên công ty — Khớp tên công ty hoặc cơ sở với các nhà vận chuyển và cơ sở đã biết của bạn bằng find_parties.

Tài liệu

Tham chiếu máy chủ MCP

Mọi thứ cần thiết để kết nối trợ lý AI với tài khoản LoadSnap và những gì nó có thể đọc sau khi kết nối.

Điểm cuối

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

Một máy chủ Giao thức Ngữ cảnh Mô hình (Model Context Protocol) từ xa sử dụng giao thức truyền tải Streamable HTTP: JSON-RPC 2.0 qua một POST duy nhất. Máy chủ không trạng thái, do đó không có tiêu đề phiên và không có luồng sự kiện do máy chủ khởi tạo, và GET trả về 405.

Thêm nó vào Claude, Claude Code, ChatGPT, Cursor hoặc bất kỳ máy khách tương thích MCP nào khác như một trình kết nối tùy chỉnh hoặc từ xa, sử dụng URL đó. Không có khóa API nào để dán vào.

Xác thực

OAuth 2.1: mã ủy quyền với PKCE, cùng với Đăng ký Máy khách Động (Dynamic Client Registration), để máy khách tự đăng ký mà không cần thiết lập thủ công. Khám phá hoạt động theo cách thông thường, một yêu cầu chưa xác thực trả về 401 với tiêu đề WWW-Authenticate trỏ đến siêu dữ liệu tài nguyên được bảo vệ.

Siêu dữ liệu tài nguyên được bảo vệ/.well-known/oauth-protected-resource
Siêu dữ liệu máy chủ ủy quyền/.well-known/oauth-authorization-server
Đăng ký máy khách động/api/oauth/register
Ủy quyền/oauth/authorize
Mã thông báo/api/oauth/token

Người dùng đăng nhập vào LoadSnap và phê duyệt kết nối trên màn hình nêu tên máy khách và tổ chức của họ. Mã thông báo truy cập có thời hạn một giờ và được gia hạn bằng mã thông báo làm mới, do đó kết nối tiếp tục hoạt động mà không cần đăng nhập lại.

Quyền truy cập được ủy quyền cho một người, không phải cho một khóa. Tư cách thành viên tổ chức và gói dịch vụ được kiểm tra lại trên mỗi yêu cầu, do đó việc xóa ai đó khỏi tổ chức sẽ chấm dứt quyền truy cập trình kết nối của họ cùng lúc.

Phạm vi truy cập

Mọi truy vấn đều được lọc cứng theo tổ chức của người dùng được ủy quyền, được giải quyết phía máy chủ từ mã thông báo. Máy khách không bao giờ cung cấp tổ chức, do đó nó không thể yêu cầu dữ liệu của công ty khác. Bảo mật cấp hàng thực thi cùng ranh giới trong cơ sở dữ liệu bên dưới.

Máy chủ chỉ đọc. Không có công cụ nào tạo, chỉnh sửa hoặc xóa bất kỳ thứ gì.

Công cụ

find_movements

Liệt kê hoặc tìm kiếm hồ sơ di chuyển chất thải (Biên nhận Chuyển giao Chất thải) và công việc.

nametùy chọnTên nhà sản xuất, khách hàng hoặc đơn vị vận chuyển. Bỏ qua để liệt kê mọi thứ trong phạm vi ngày.
date_fromtùy chọnNgày ISO (YYYY-MM-DD) giới hạn dưới của ngày thu gom.
date_totùy chọnNgày ISO (YYYY-MM-DD) giới hạn trên của ngày thu gom.

find_receipts

Liệt kê hoặc tìm kiếm biên nhận cho chất thải đến tại địa điểm của chính tổ chức.

nametùy chọnTên đơn vị vận chuyển hoặc nhà sản xuất. Bỏ qua để liệt kê mọi thứ đã nhận trong phạm vi.
date_fromtùy chọnNgày ISO (YYYY-MM-DD) giới hạn dưới của ngày nhận.
date_totùy chọnNgày ISO (YYYY-MM-DD) giới hạn trên của ngày nhận.

count_movements

Đếm số lần di chuyển trong một khoảng thời gian và tổng trọng lượng của chúng, tùy chọn chia theo hướng.

date_fromtùy chọnNgày ISO (YYYY-MM-DD) giới hạn dưới của ngày thu gom.
date_totùy chọnNgày ISO (YYYY-MM-DD) giới hạn trên của ngày thu gom.
directiontùy chọninbound, outbound hoặc all. Inbound là chất thải được tiếp nhận tại địa điểm của chính tổ chức.

defra_filings

Đếm và liệt kê các bản khai DEFRA Digital Waste Tracking, cùng các hồ sơ vẫn đang chờ khai báo.

date_fromtùy chọnNgày ISO (YYYY-MM-DD) giới hạn dưới của ngày khai báo.
date_totùy chọnNgày ISO (YYYY-MM-DD) giới hạn trên của ngày khai báo.
include_outstandingtùy chọnCũng trả về các hồ sơ chưa khai báo. Mặc định là true.

find_parties

Phân giải tên công ty hoặc địa điểm thành các đơn vị vận chuyển và địa điểm đã biết của tổ chức.

namebắt buộcTên công ty hoặc địa điểm.

Giới hạn và định dạng

Trọng lượng được trả về bằng kilôgam trừ khi tên trường ghi rõ tấn. Ngày tháng theo định dạng ISO (YYYY-MM-DD). Hai công cụ tìm kiếm trả về 25 kết quả khớp gần nhất; count_movements đọc tối đa 1.000 hàng và báo cáo count_is_capped khi đạt đến giới hạn đó, do đó một con số bị giới hạn không bao giờ được trình bày như một tổng chính xác. Các hồ sơ được tạo mẫu bị loại khỏi mọi kết quả.

Yêu cầu

Tài khoản LoadSnap ở gói Pro trở lên và thông tin đăng nhập thuộc về một tổ chức LoadSnap. Mọi người kết nối đều sử dụng thông tin đăng nhập của riêng họ, vì kết nối được ủy quyền với tư cách là họ.

Câu hỏi về trình kết nối? Gửi email đến info@loadsnap.co.uk, hoặc đọc tổng quan trình kết nối.