LoadSnap

เอกสารอ้างอิงเซิร์ฟเวอร์ MCP

ทุกสิ่งที่จำเป็นสำหรับการเชื่อมต่อผู้ช่วย AI เข้ากับบัญชี LoadSnap และสิ่งที่สามารถอ่านได้เมื่อเชื่อมต่อแล้ว

ปลายทาง (Endpoint)

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

เซิร์ฟเวอร์ Model Context Protocol ระยะไกลที่ใช้การส่งข้อมูลแบบ Streamable HTTP: JSON-RPC 2.0 ผ่าน POST เดียว เซิร์ฟเวอร์ไม่มีสถานะ (stateless) จึงไม่มี session header หรือ event stream ที่เริ่มจากเซิร์ฟเวอร์ และการเรียก GET จะคืนค่า 405

เพิ่มลงใน Claude, Claude Code, ChatGPT, Cursor หรือไคลเอนต์อื่น ๆ ที่รองรับ MCP ในรูปแบบตัวเชื่อมต่อแบบกำหนดเองหรือระยะไกล โดยใช้ URL นั้น ไม่จำเป็นต้องวาง API key

การยืนยันตัวตน

OAuth 2.1: authorization code พร้อม PKCE และ Dynamic Client Registration ทำให้ไคลเอนต์ลงทะเบียนตัวเองได้โดยไม่ต้องตั้งค่าด้วยตนเอง การค้นหาทำงานตามปกติ โดยคำขอที่ไม่ผ่านการยืนยันตัวตนจะคืนค่า 401 พร้อม header WWW-Authenticate ที่ชี้ไปยัง metadata ของทรัพยากรที่ได้รับการป้องกัน

Protected resource metadata	/.well-known/oauth-protected-resource
Authorization server metadata	/.well-known/oauth-authorization-server
Dynamic client registration	/api/oauth/register
Authorization	/oauth/authorize
Token	/api/oauth/token

ผู้ใช้ลงชื่อเข้าใช้ LoadSnap และอนุมัติการเชื่อมต่อบนหน้าจอที่ระบุชื่อไคลเอนต์และองค์กรของตน Access 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 Digital Waste Tracking และบันทึกที่ยังรอการส่ง

date_from	ไม่บังคับ	วันที่ ISO (YYYY-MM-DD) ขอบเขตล่างของวันที่ส่ง
date_to	ไม่บังคับ	วันที่ ISO (YYYY-MM-DD) ขอบเขตบนของวันที่ส่ง
include_outstanding	ไม่บังคับ	ส่งคืนบันทึกที่ยังไม่ได้ส่งด้วย ค่าเริ่มต้นคือ true

find_parties

แปลงชื่อบริษัทหรือไซต์เป็นผู้ขนส่งและไซต์ที่องค์กรรู้จัก

name	บังคับ	ชื่อบริษัทหรือไซต์

ข้อจำกัดและรูปแบบ

น้ำหนักจะถูกส่งคืนเป็นกิโลกรัม เว้นแต่ชื่อฟิลด์จะระบุเป็นตัน วันที่เป็นรูปแบบ ISO (YYYY-MM-DD) เครื่องมือค้นหาสองรายการส่งคืน 25 รายการล่าสุดที่ตรงกัน count_movements อ่านได้สูงสุด 1,000 แถวและรายงาน count_is_capped เมื่อถึงขีดจำกัดนั้น ดังนั้นตัวเลขที่ถูกจำกัดจะไม่ถูกนำเสนอเป็นยอดรวมที่แน่นอน บันทึกที่ถูกสร้างเป็นตัวอย่างจะถูกแยกออกจากทุกผลลัพธ์

ข้อกำหนด

บัญชี LoadSnap ในแผน Pro ขึ้นไป และข้อมูลเข้าสู่ระบบที่อยู่ในองค์กร LoadSnap ทุกคนที่เชื่อมต่อใช้ข้อมูลเข้าสู่ระบบของตนเอง เนื่องจากการเชื่อมต่อได้รับอนุญาตในฐานะบุคคลนั้น

มีคำถามเกี่ยวกับตัวเชื่อมต่อหรือไม่? อีเมล info@loadsnap.co.uk หรืออ่าน ภาพรวมตัวเชื่อมต่อ