LoadSnap

Tham chiếu máy chủ MCP

Mọi thứ cần thiết để kết nối một 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 từ xa sử dụng truyền tải HTTP Streamable: 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, để 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 kéo dài 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 đượ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 đượ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 đó 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.

15 trong số 21 công cụ chỉ đọc. 6 công cụ có tên bắt đầu bằng create_ chỉ thêm một bản ghi và không làm gì khác: không công cụ nào chỉnh sửa, xóa, nộp cho DEFRA, ký biên bản chuyển giao, phát hành hóa đơn hoặc cấp quyền đăng nhập văn phòng. Mỗi công cụ được đánh dấu là ghi trong chú thích của nó, do đó máy khách hỏi người dùng trước khi chạy một công cụ.

Ngoại lệ duy nhất cho phạm vi tổ chức là find_waste_codes, tìm kiếm Danh mục Chất thải Châu Âu đã công bố — cùng một danh sách quốc gia cho mọi người và không phải dữ liệu riêng của ai.

Công cụ

21 công cụ, mỗi công cụ được giới hạn trong tổ chức được ủy quyền. Mỗi công cụ được liệt kê bên dưới với mô tả mà máy khách được cung cấp và các đối số mà nó chấp nhận. Một công cụ được đánh dấu ghi sẽ thêm một bản ghi; phần còn lại chỉ đọc.

find_movements

Tìm các chuyển động chất thải

Liệt kê hoặc tìm kiếm các bản ghi chuyển động chất thải của tổ chức này (Biên bản Chuyển giao Chất thải) và công việc, theo tên nhà sản xuất, khách hàng hoặc đơn vị vận chuyển và/hoặc phạm vi ngày thu gom. Sử dụng cho 'chúng ta đã có chuyển động cho X chưa', 'chúng ta đã thu gom gì từ Y vào tháng 5', hoặc 'chúng ta đã vận chuyển gì tuần trước' mà không có tên nào cả.

name	tùy chọn	Tên nhà sản xuất, khách hàng hoặc đơn vị vận chuyển để tìm kiếm. Bỏ qua để liệt kê mọi thứ trong phạm vi ngày.
date_from	tùy chọn	Giới hạn dưới ngày ISO tùy chọn (YYYY-MM-DD)
date_to	tùy chọn	Giới hạn trên ngày ISO tùy chọn (YYYY-MM-DD)

find_receipts

Tìm biên nhận nhận hàng

Liệt kê hoặc tìm kiếm các biên nhận nhận hàng của tổ chức này (chất thải đến tại địa điểm của chính họ) theo tên đơn vị vận chuyển hoặc nhà sản xuất và/hoặc phạm vi ngày nhận. Bỏ qua tên để liệt kê mọi thứ nhận được trong phạm vi.

name	tùy chọn	Tên đơn vị vận chuyển hoặc nhà sản xuất. Bỏ qua để liệt kê tất cả.
date_from	tùy chọn	Giới hạn dưới ngày ISO tùy chọn (YYYY-MM-DD)
date_to	tùy chọn	Giới hạn trên ngày ISO tùy chọn (YYYY-MM-DD)

count_movements

Đếm các chuyển động chất thải

Đếm các chuyển động chất thải của tổ chức này trong một phạm vi ngày và tổng trọng lượng của chúng, tùy chọn tách theo hướng vào hoặc ra. Sử dụng cho 'chúng ta đã thực hiện bao nhiêu chuyến hàng tháng trước', 'chúng ta đã xử lý bao nhiêu chất thải trong năm nay', 'có bao nhiêu lần thu gom trong tuần này'. Đếm theo ngày thu gom.

date_from	tùy chọn	Giới hạn dưới ngày ISO (YYYY-MM-DD) trên ngày thu gom
date_to	tùy chọn	Giới hạn trên ngày ISO (YYYY-MM-DD) trên ngày thu gom
direction	tùy chọn	inbound = chất thải được nhận tại địa điểm của tổ chức này, outbound = chất thải xe tải của họ chở đi hoặc gửi ra. Bỏ qua cho tất cả.

defra_filings

Hồ sơ DEFRA

Đếm và liệt kê các hồ sơ theo dõi chất thải DEFRA của tổ chức này trong một phạm vi ngày, và liệt kê các bản ghi vẫn đang chờ nộp. Sử dụng cho 'chúng ta đã nộp bao nhiêu hồ sơ DEFRA trong tuần này', 'có gì thất bại với DEFRA không', 'còn gì chưa hoàn thành'.

date_from	tùy chọn	Giới hạn dưới ngày ISO (YYYY-MM-DD) trên ngày nộp
date_to	tùy chọn	Giới hạn trên ngày ISO (YYYY-MM-DD) trên ngày nộp
include_outstanding	tùy chọn	Cũng trả về các bản ghi chưa được nộp cho DEFRA. Mặc định là true.

find_parties

Tìm đơn vị vận chuyển và địa điểm

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.

name	bắt buộc	Tên công ty hoặc địa điểm

find_jobs

Tìm công việc đã lên lịch

Liệt kê hoặc tìm kiếm các công việc của tổ chức này — công việc đã đặt, đang tiến hành hoặc đã hoàn thành — theo tên khách hàng và/hoặc phạm vi ngày đã lên lịch. Sử dụng cho 'chúng ta làm gì vào ngày mai', 'công việc của Carter đã được đặt chưa', 'còn gì chưa được phân bổ'. Đọc về phía trước từ ngày sớm nhất, vì danh sách công việc là một cuốn nhật ký.

name	tùy chọn	Tên khách hàng để tìm kiếm. Bỏ qua để liệt kê mọi thứ trong phạm vi.
status	tùy chọn	Trạng thái công việc để lọc, ví dụ draft, scheduled, in_progress, completed, cancelled.
date_from	tùy chọn	Giới hạn dưới ngày ISO tùy chọn (YYYY-MM-DD)
date_to	tùy chọn	Giới hạn trên ngày ISO tùy chọn (YYYY-MM-DD)

find_invoices

Hóa đơn và tiền nợ

Liệt kê các hóa đơn của tổ chức này và tổng số tiền còn nợ, tùy chọn chỉ các hóa đơn chưa thanh toán. Sử dụng cho 'ai nợ chúng ta tiền', 'còn bao nhiêu chưa thanh toán', 'hóa đơn của Carter đã thanh toán chưa', 'cái gì quá hạn'. Tổng số theo loại tiền tệ của hóa đơn.

name	tùy chọn	Tên doanh nghiệp mà hóa đơn được lập cho. Bỏ qua để liệt kê mọi thứ trong phạm vi.
status	tùy chọn	Trạng thái hóa đơn để lọc, ví dụ draft, issued, paid, void.
only_unpaid	tùy chọn	Chỉ các hóa đơn còn số dư phải thanh toán. Mặc định là false.
date_from	tùy chọn	Giới hạn dưới ngày ISO tùy chọn (YYYY-MM-DD)
date_to	tùy chọn	Giới hạn trên ngày ISO tùy chọn (YYYY-MM-DD)

find_vehicles

Phương tiện và giấy tờ của chúng

Liệt kê các phương tiện của tổ chức này với hạn kiểm định MOT, thuế và bảo hiểm, và đánh dấu bất kỳ phương tiện nào đã hết hạn. Sử dụng cho 'đội xe có gì', 'có gì hết hạn MOT không', 'khi nào thuế đến hạn cho VX19 ABC'. MOT và thuế đến từ DVLA và chỉ mới nhất theo lần kiểm tra cuối.

name	tùy chọn	Biển số hoặc mô tả để tìm kiếm. Bỏ qua để liệt kê mọi thứ trong phạm vi.
include_inactive	tùy chọn	Cũng trả về các phương tiện đã rút khỏi đội. Mặc định là false.

find_people

Nhóm và những gì họ có thể sử dụng

Liệt kê những người trong nhóm của tổ chức này và mỗi người giữ cách truy cập nào trong ba cách: đăng nhập văn phòng, ứng dụng tài xế, ứng dụng cân trạm. Sử dụng cho 'ai lái xe cho chúng ta', 'Dave có ứng dụng tài xế không', 'ai trong nhóm'.

name	tùy chọn	Tên hoặc email của người để tìm kiếm. Bỏ qua để liệt kê mọi thứ trong phạm vi.
drivers_only	tùy chọn	Chỉ những người giữ ứng dụng tài xế. Mặc định là false.

compliance_status

Chứng chỉ, giấy phép và đăng ký

Liệt kê các chứng chỉ, giấy phép và đăng ký mà tổ chức này đã ghi lại, với ngày hết hạn của chúng, và cho biết cái nào đã hết hạn. Sử dụng cho 'đăng ký vận chuyển chất thải của chúng ta còn hiệu lực không', 'cái gì hết hạn trong năm nay', 'chúng ta có chứng chỉ ISO trong hồ sơ không'.

expired_only	tùy chọn	Chỉ những cái đã hết hạn. Mặc định là false.

find_documents

Tìm một tài liệu

Tìm các tài liệu được lưu trữ của tổ chức này — biên bản chuyển giao chất thải, biên bản gửi hàng, giấy phép, giấy tờ tải lên — theo loại và/hoặc ngày, với liên kết đến từng tài liệu. Sử dụng cho 'gửi cho tôi biên bản chuyển giao cho chuyến hàng đó', 'chúng ta có giấy tờ gì cho công việc này'.

document_type	tùy chọn	Loại tài liệu để lọc, ví dụ wtn, hwcn, annex_vii, permit, upload.
movement_id	tùy chọn	Chỉ các tài liệu đính kèm với chuyển động chất thải này.
job_id	tùy chọn	Chỉ các tài liệu đính kèm với công việc này.
date_from	tùy chọn	Giới hạn dưới ngày ISO tùy chọn (YYYY-MM-DD)
date_to	tùy chọn	Giới hạn trên ngày ISO tùy chọn (YYYY-MM-DD)

container_stock

Thùng và container

Những container mà tổ chức này nắm giữ và chúng ở đâu: những cái được theo dõi từng cái một với số tài sản và trạng thái, và các loại được giữ dưới dạng tổng chạy. Sử dụng cho 'chúng ta có bao nhiêu thùng 8 yard trống', 'thùng 214 ở đâu', 'cái gì đang cho thuê'.

container_type	tùy chọn	Loại container để lọc, ví dụ skip, roro, bin.
container_size	tùy chọn	Kích thước container để lọc, ví dụ 8yd.
state	tùy chọn	Trạng thái của một container được theo dõi riêng lẻ, ví dụ in_yard, on_site, in_transit.

find_contracts

Hợp đồng và vé mùa

Liệt kê các thỏa thuận dài hạn của tổ chức này: hợp đồng và vé mùa, mỗi cái bao phủ chất thải gì, ngày chạy và cả hai bên đã ký chưa. Sử dụng cho 'chúng ta có gì theo hợp đồng', 'vé mùa đó đã được ký chưa', 'cái gì hết hạn trong tháng này'.

site_id	tùy chọn	Chỉ các thỏa thuận cho địa điểm này.
active_only	tùy chọn	Chỉ các thỏa thuận còn hiệu lực. Mặc định là false.

consignee_returns

Báo cáo người nhận hàng quý

Các báo cáo người nhận hàng quý của tổ chức này cho chất thải nguy hại đã nhận: quý, cái gì đến hạn khi nào, bao nhiêu lô hàng và trọng lượng bao nhiêu, và đã được gửi chưa. Sử dụng cho 'báo cáo người nhận hàng của chúng ta đã xong chưa', 'cái gì đến hạn trong quý này'. Chỉ dành cho người nhận; một đơn vị vận chuyển không có.

quarter	tùy chọn	Nhãn quý, ví dụ "Q1 2026".
status	tùy chọn	Trạng thái để lọc: not_started, generated, reviewed hoặc submitted.

find_waste_codes

Tra cứu mã chất thải

Tìm kiếm Danh mục Chất thải Châu Âu (EWC) theo mã hoặc theo chất thải là gì, và cho biết mỗi mã có nguy hại hay là mục phản chiếu. Sử dụng cho 'mã nào cho tấm thạch cao', '17 05 03 có nguy hại không'. Đây là danh sách quốc gia đã công bố, không phải dữ liệu riêng của tổ chức này.

query	bắt buộc	Một mã hoặc một phần của mã ("17 05"), hoặc các từ mô tả chất thải ("tấm thạch cao").
hazardous_only	tùy chọn	Chỉ các mã nguy hại. Mặc định là false.

create_customer

Thêm khách hàngwrites

Thêm một khách hàng (một địa điểm thu gom mà tổ chức thu gom chất thải từ đó). Trả lời với những gì vẫn cần nếu bất kỳ mục bắt buộc nào bị thiếu, và không ghi gì. Nếu một khách hàng có tên và mã bưu chính đó đã tồn tại, nó trả về khách hàng đó thay vì tạo một cái thứ hai.

name	bắt buộc	Công ty hoặc người mà chất thải thuộc về
address	bắt buộc	Nơi chất thải được thu gom từ đó
postcode	bắt buộc	Mã bưu chính của địa chỉ thu gom
producer_type	tùy chọn	Liệu chất thải đến từ doanh nghiệp hay hộ gia đình. Mặc định là business.
contact_name	bắt buộc	Người cần hỏi tại địa điểm
contact_email	tùy chọn	Địa chỉ email của họ
contact_phone	tùy chọn	Số điện thoại của họ
sic_code	tùy chọn	Mã SIC của nhà sản xuất, nếu biết

create_receiving_site

Thêm địa điểm nhận hàngwrites

Thêm một địa điểm nhận hàng (một bãi chứa, trạm trung chuyển hoặc cơ sở tái chế mà chất thải được đưa đến). Trả lời với những gì vẫn cần nếu bất kỳ mục bắt buộc nào bị thiếu, và không ghi gì.

name	required	Tên của địa điểm
address	required	Địa chỉ của địa điểm
postcode	required	Mã bưu chính của địa điểm
permit_number	optional	Số giấy phép môi trường hoặc số miễn trừ
contact_name	optional	Người cần liên hệ tại cổng
contact_email	optional	Địa chỉ email của họ
contact_phone	optional	Số điện thoại của họ
is_own_site	optional	Chỉ đúng nếu đây là địa điểm của chính tổ chức chứ không phải của người khác. Mặc định là false.

create_carrier

Thêm một đơn vị vận chuyển hoặc môi giớiwrites

Thêm một đơn vị vận chuyển, môi giới hoặc đại lý mà tổ chức làm việc cùng. Trả lời những gì vẫn còn cần thiết nếu thiếu bất kỳ thông tin bắt buộc nào và không ghi gì cả.

company_name	required	Tên công ty của đơn vị vận chuyển hoặc môi giới
registration_number	optional	Số đăng ký vận chuyển chất thải của họ, nếu biết
contact_name	optional	Người cần trao đổi
contact_email	optional	Địa chỉ email của họ
contact_phone	optional	Số điện thoại của họ
address	optional	Địa chỉ của họ
postcode	optional	Mã bưu chính của họ
notes	optional	Bất kỳ điều gì đáng ghi lại về họ

create_vehicle

Thêm một phương tiệnwrites

Thêm một phương tiện vào đội xe. Trả lời những gì vẫn còn cần thiết nếu thiếu bất kỳ thông tin bắt buộc nào và không ghi gì cả. Một biển số đã có trong đội xe sẽ trả về phương tiện đó thay vì tạo thêm một bản ghi thứ hai.

registration	required	Biển số xe
make	optional	Hãng sản xuất
description	optional	Mẫu xe hoặc mô tả
vehicle_type	optional	Loại phương tiện, ví dụ xe tải chở thùng hoặc xe ben
mot_expiry	optional	Thời điểm hết hạn MOT (YYYY-MM-DD)
tax_expiry	optional	Thời điểm hết hạn thuế (YYYY-MM-DD)
max_weight_tonnes	optional	Tổng trọng lượng tính bằng tấn

create_driver

Thêm một tài xếwrites

Thêm một tài xế để họ có thể được giao việc và ký phiếu chuyển giao trong ứng dụng tài xế. Sử dụng một trong các hạn mức tài xế của gói và từ chối nếu tất cả đã được sử dụng. Không cấp quyền đăng nhập văn phòng cho bất kỳ ai: quyền đó được chủ sở hữu hoặc quản trị viên cấp trên trang Team. Người đã có trong đội sẽ được thêm ứng dụng tài xế vào bản ghi hiện có của họ.

name	required	Họ và tên đầy đủ của họ
email	required	Địa chỉ email của họ, nơi gửi lời mời vào ứng dụng tài xế
phone_number	optional	Số điện thoại của họ
role	optional	Công việc của họ, ví dụ tài xế xe tải hạng nặng
address	optional	Địa chỉ nhà của họ
postcode	optional	Mã bưu chính nhà của họ
licence_expiry	optional	Thời điểm hết hạn giấy phép lái xe (YYYY-MM-DD)
emergency_contact_name	optional	Người cần gọi trong trường hợp khẩn cấp
emergency_contact_phone	optional	Số điện thoại của người đó

create_enquiry

Ghi nhận yêu cầu thu gomwrites

Ghi nhận yêu cầu thu gom (một yêu cầu hỏi) từ khách hàng để văn phòng có thể báo giá. Trả lời những gì vẫn còn cần thiết nếu thiếu bất kỳ thông tin bắt buộc nào và không ghi gì cả.

company_name	required	Công ty đang yêu cầu
contact_name	required	Người đã liên hệ
contact_email	required	Địa chỉ email của họ
contact_phone	required	Số điện thoại của họ
site_address	required	Nơi có chất thải
postcode	optional	Mã bưu chính của địa chỉ đó
waste_description	required	Chất thải là gì, theo lời của họ
service_type	optional	Họ đang yêu cầu gì, ví dụ một thùng chứa hoặc một chuyến xe gắp
estimated_weight	optional	Ước tính khối lượng, tính bằng tấn
preferred_date	optional	Thời điểm họ muốn (YYYY-MM-DD)
access_notes	optional	Bất kỳ điều gì về việc tiếp cận địa điểm

Ghi dữ liệu

6 công cụ create_ thêm một khách hàng, một địa điểm tiếp nhận, một đơn vị vận chuyển hoặc môi giới, một phương tiện, một tài xế và một yêu cầu thu gom. Đây là cách ai đó đưa dữ liệu vào LoadSnap bằng cách mô tả trong cuộc trò chuyện thay vì điền vào biểu mẫu hoặc chuẩn bị bảng tính.

Không bao giờ có dữ liệu được ghi nửa chừng. Một lệnh gọi thiếu thông tin bắt buộc sẽ không ghi gì cả và trả lời bằng danh sách những gì vẫn còn cần thiết, được diễn đạt dưới dạng câu hỏi, để trợ lý hỏi lại và gọi lại. Một lệnh gọi cho bản ghi đã tồn tại sẽ trả về bản ghi hiện có thay vì tạo bản ghi thứ hai, vì vậy chạy cùng một yêu cầu hai lần không thể để lại bản trùng lặp.

Một tài xế được thêm theo cách này sử dụng một trong các hạn mức tài xế của gói và bị từ chối khi tất cả đã được sử dụng, giống hệt như trên trang Team, và được đối chiếu với những người đã có trong đội để người đã làm việc ở đó được thêm ứng dụng tài xế vào bản ghi hiện có. Không ai được cấp quyền đăng nhập văn phòng: đó là một chỗ ngồi trả phí và một cách vào hệ thống kinh doanh, và nó được cấp trên Team bởi chủ sở hữu hoặc quản trị viên.

Nộp hồ sơ cho DEFRA, ký phiếu chuyển giao, lập hóa đơn và xóa bất kỳ thứ gì cố tình không có ở đây. Đây là những việc một người thực hiện trong LoadSnap, với tên của họ trên đó.

Bảng tương tác

Máy chủ xuất bản một bảng tương tác dưới dạng tài nguyên MCP tại ui://loadsnap/panel và mọi công cụ đều trỏ tới đó. Một máy khách hỗ trợ tiện ích mở rộng ứng dụng sẽ vẽ câu trả lời dưới dạng bảng trong cuộc trò chuyện: một bảng các bản ghi, một thẻ cho bản ghi vừa thêm hoặc một danh sách kiểm tra những gì vẫn còn cần thiết trước khi có thể lưu.

Đây là một tài liệu độc lập duy nhất không có dữ liệu riêng, không có mã thông báo và không tải gì từ mạng. Máy khách truyền câu trả lời của công cụ vào đó. Mọi công cụ cũng trả về câu trả lời đó dưới dạng văn bản, vì vậy máy khách không vẽ bảng sẽ hiển thị chính xác những gì nó luôn hiển thị.

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 nói tấn. Ngày tháng theo chuẩn ISO (YYYY-MM-DD). Tìm kiếm trả về 25 kết quả phù hợp 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 đó, vì vậy 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. Điều tương tự áp dụng cho số tiền nợ trên find_invoices, báo cáo totals_are_capped. Các bản ghi được tạo mẫu bị loại khỏi mọi kết quả.

Yêu cầu

Một tài khoản LoadSnap ở gói Pro trở lên và một quyền đăng nhập thuộc về một tổ chức LoadSnap. Mọi người kết nối đều sử dụng quyền đă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ề bộ kết nối? Gửi email tới info@loadsnap.co.uk hoặc đọc tổng quan về bộ kết nối.