LoadSnap

MCP sunucu referansı

Bir yapay zeka asistanını LoadSnap hesabına bağlamak için gereken her şey ve bağlandıktan sonra neleri okuyabileceği.

Uç nokta

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

Streamable HTTP taşımacılığını kullanan uzak bir Model Context Protocol sunucusu: tek bir POST üzerinden JSON-RPC 2.0. Sunucu durumsuzdur, bu nedenle oturum başlığı veya sunucu tarafından başlatılan bir olay akışı yoktur ve GET isteği 405 döndürür.

Bu URL'yi kullanarak Claude, Claude Code, ChatGPT, Cursor veya MCP uyumlu başka herhangi bir istemciye özel veya uzak bağlayıcı olarak ekleyin. Yapıştırılacak bir API anahtarı yoktur.

Kimlik doğrulama

OAuth 2.1: PKCE ile yetkilendirme kodu ve Dinamik İstemci Kaydı; böylece bir istemci manuel kurulum olmadan kendini kaydeder. Keşif normal şekilde çalışır; kimliği doğrulanmamış bir istek, korumalı kaynak meta verilerini gösteren bir WWW-Authenticate başlığıyla 401 döndürür.

Korumalı kaynak meta verileri	/.well-known/oauth-protected-resource
Yetkilendirme sunucusu meta verileri	/.well-known/oauth-authorization-server
Dinamik istemci kaydı	/api/oauth/register
Yetkilendirme	/oauth/authorize
Belirteç	/api/oauth/token

Kişi LoadSnap'e giriş yapar ve istemcinin ve kuruluşunun adını gösteren bir ekranda bağlantıyı onaylar. Erişim belirteçleri bir saat sürer ve yenileme belirteciyle yenilenir; böylece bağlantı yeniden giriş yapılmadan çalışmaya devam eder.

Erişim bir anahtar olarak değil, bir kişi olarak yetkilendirilir. Kuruluş üyeliği ve plan her istekte yeniden kontrol edilir; bu nedenle birini kuruluştan çıkarmak, bağlayıcı erişimini de sona erdirir.

Erişim kapsamı

Her sorgu, sunucu tarafında belirteçten çözümlenen yetkili kullanıcının kuruluşuna göre sıkı şekilde filtrelenir. İstemci asla bir kuruluş sağlamaz, bu nedenle başka bir şirketin verilerini isteyemez. Satır düzeyinde güvenlik, alttaki veritabanında aynı sınırı uygular.

21 araçtan 15'i yalnızca okur. Adları create_ ile başlayan 6 tanesi bir kayıt ekler ve başka hiçbir şey yapmaz: hiçbiri düzenlemez, silmez, DEFRA'ya dosyalamaz, bir transfer notu imzalamaz, bir fatura çıkarmaz veya bir ofis girişi vermez. Her biri ek açıklamalarında yazma olarak işaretlenmiştir; böylece bir istemci çalıştırmadan önce kişiye sorar.

Kuruluş kapsamının tek istisnası, yayınlanmış Avrupa Atık Kataloğu'nda arama yapan find_waste_codes'tur — herkes için aynı ulusal liste ve kimsenin kendi verisi değildir.

Araçlar

Yetkili kuruluşa göre kapsamlanmış 21 araç. Her biri aşağıda, istemciye verilen açıklama ve kabul ettiği bağımsız değişkenlerle listelenmiştir. Yazma olarak işaretlenmiş bir araç bir kayıt ekler; geri kalanı yalnızca okur.

find_movements

Atık hareketlerini bul

Bu kuruluşun atık hareket kayıtlarını (Atık Transfer Notları) ve işlerini üretici, müşteri veya taşıyıcı adına ve/veya bir toplama tarihi aralığına göre listele veya ara. Bunu 'X için hareket yaptık mı', 'Y'den Mayıs'ta ne topladık' veya hiç ad olmadan 'geçen hafta ne taşıdık' için kullanın.

name	isteğe bağlı	Aranacak üretici, müşteri veya taşıyıcı adı. Tarih aralığındaki her şeyi listelemek için atlayın.
date_from	isteğe bağlı	İsteğe bağlı ISO tarihi (YYYY-MM-DD) alt sınır
date_to	isteğe bağlı	İsteğe bağlı ISO tarihi (YYYY-MM-DD) üst sınır

find_receipts

Alım makbuzlarını bul

Bu kuruluşun alım makbuzlarını (kendi sahalarına varan atık) taşıyıcı veya üretici adına ve/veya bir alım tarihi aralığına göre listele veya ara. Aralıktaki tüm alımları listelemek için adı atlayın.

name	isteğe bağlı	Taşıyıcı veya üretici adı. Tümünü listelemek için atlayın.
date_from	isteğe bağlı	İsteğe bağlı ISO tarihi (YYYY-MM-DD) alt sınır
date_to	isteğe bağlı	İsteğe bağlı ISO tarihi (YYYY-MM-DD) üst sınır

count_movements

Atık hareketlerini say

Bu kuruluşun atık hareketlerini bir tarih aralığında sayın ve ağırlıklarını toplayın; isteğe bağlı olarak gelen veya giden olarak bölün. Bunu 'geçen ay kaç yük yaptık', 'bu yıl ne kadar atık işledik', 'bu hafta kaç toplama' için kullanın. Toplama tarihine göre sayar.

date_from	isteğe bağlı	Toplama tarihinde ISO tarihi (YYYY-MM-DD) alt sınır
date_to	isteğe bağlı	Toplama tarihinde ISO tarihi (YYYY-MM-DD) üst sınır
direction	isteğe bağlı	inbound = bu kuruluşun kendi sahasında alınan atık, outbound = kamyonunun götürdüğü veya gönderdiği atık. Tümü için atlayın.

defra_filings

DEFRA dosyalamaları

Bu kuruluşun DEFRA atık takip gönderimlerini bir tarih aralığında sayın ve listeleyin ve hâlâ dosyalanmayı bekleyen kayıtları listeleyin. Bunu 'bu hafta kaç DEFRA gönderimi dosyaladık', 'DEFRA ile bir şey başarısız oldu mu', 'hâlâ bekleyen ne var' için kullanın.

date_from	isteğe bağlı	Gönderim tarihinde ISO tarihi (YYYY-MM-DD) alt sınır
date_to	isteğe bağlı	Gönderim tarihinde ISO tarihi (YYYY-MM-DD) üst sınır
include_outstanding	isteğe bağlı	Henüz DEFRA'ya dosyalanmamış kayıtları da döndür. Varsayılan true.

find_parties

Taşıyıcıları ve sahaları bul

Bir şirket veya saha adını kuruluşun bilinen taşıyıcılarına ve sahalarına çözümleyin.

name	zorunlu	Şirket veya saha adı

find_jobs

Planlanan işleri bul

Bu kuruluşun işlerini — rezerve edilmiş, devam eden veya tamamlanmış — müşteri adına ve/veya bir planlanan tarih aralığına göre listele veya ara. Bunu 'yarın ne yapıyoruz', 'Carter işi rezerve edildi mi', 'hâlâ atanmamış ne var' için kullanın. Bir iş listesi bir günlük olduğundan en erken tarihten ileriye doğru okur.

name	isteğe bağlı	Aranacak müşteri adı. Aralıktaki her şeyi listelemek için atlayın.
status	isteğe bağlı	Filtrelenecek iş durumu, örneğin draft, scheduled, in_progress, completed, cancelled.
date_from	isteğe bağlı	İsteğe bağlı ISO tarihi (YYYY-MM-DD) alt sınır
date_to	isteğe bağlı	İsteğe bağlı ISO tarihi (YYYY-MM-DD) üst sınır

find_invoices

Faturalar ve ödenmesi gereken para

Bu kuruluşun faturalarını listeleyin ve hâlâ ödenmesi gerekeni toplayın; isteğe bağlı olarak yalnızca ödenmemiş olanlar. Bunu 'bize kim borçlu', 'ne kadar ödenmemiş var', 'Carter faturası ödendi mi', 'vadesi geçen ne var' için kullanın. Toplamlar fatura para birimindedir.

name	isteğe bağlı	Faturanın kesildiği işletmenin adı. Aralıktaki her şeyi listelemek için atlayın.
status	isteğe bağlı	Filtrelenecek fatura durumu, örneğin draft, issued, paid, void.
only_unpaid	isteğe bağlı	Yalnızca ödenecek bakiyesi olan faturalar. Varsayılan false.
date_from	isteğe bağlı	İsteğe bağlı ISO tarihi (YYYY-MM-DD) alt sınır
date_to	isteğe bağlı	İsteğe bağlı ISO tarihi (YYYY-MM-DD) üst sınır

find_vehicles

Araçlar ve evrakları

Bu kuruluşun araçlarını MOT, vergi ve sigorta bitiş tarihleriyle listeleyin ve süresi dolanları işaretleyin. Bunu 'filoda ne var', 'MOT'suz bir şey var mı', 'VX19 ABC'nin vergisi ne zaman' için kullanın. MOT ve vergi DVLA'dan gelir ve yalnızca son kontrol kadar günceldir.

name	isteğe bağlı	Aranacak plaka veya açıklama. Aralıktaki her şeyi listelemek için atlayın.
include_inactive	isteğe bağlı	Filodan çıkarılan araçları da döndür. Varsayılan false.

find_people

Ekip ve kullanabildikleri

Bu kuruluşun ekibindeki kişileri ve her birinin üç giriş yolundan hangisine sahip olduğunu listeleyin: ofis girişi, sürücü uygulaması, kantar uygulaması. Bunu 'bizim için kim sürüyor', 'Dave'in sürücü uygulaması var mı', 'ekipte kim var' için kullanın.

name	isteğe bağlı	Aranacak kişinin adı veya e-postası. Aralıktaki her şeyi listelemek için atlayın.
drivers_only	isteğe bağlı	Yalnızca sürücü uygulamasına sahip kişiler. Varsayılan false.

compliance_status

Sertifikalar, izinler ve kayıtlar

Bu kuruluşun kaydettiği sertifikaları, izinleri ve kayıtları bitiş tarihleriyle listeleyin ve hangilerinin süresinin dolduğunu söyleyin. Bunu 'atık taşıyıcı kaydımız hâlâ geçerli mi', 'bu yıl neyin süresi doluyor', 'dosyada ISO sertifikamız var mı' için kullanın.

expired_only	isteğe bağlı	Yalnızca süresi dolmuş olanlar. Varsayılan false.

find_documents

Bir belge bul

Bu kuruluşun saklanan belgelerini — atık transfer notları, sevk irsaliyeleri, izinler, yüklenen evraklar — türe ve/veya tarihe göre, her birine bağlantıyla bulun. Bunu 'bana o yükün transfer notunu gönder', 'bu işte hangi evraklarımız var' için kullanın.

document_type	isteğe bağlı	Filtrelenecek belge türü, örneğin wtn, hwcn, annex_vii, permit, upload.
movement_id	isteğe bağlı	Yalnızca bu atık hareketine ekli belgeler.
job_id	isteğe bağlı	Yalnızca bu işe ekli belgeler.
date_from	isteğe bağlı	İsteğe bağlı ISO tarihi (YYYY-MM-DD) alt sınır
date_to	isteğe bağlı	İsteğe bağlı ISO tarihi (YYYY-MM-DD) üst sınır

container_stock

Konteynerler ve çöp konteynerleri

Bu kuruluşun hangi konteynerlere sahip olduğu ve nerede oldukları: varlık numarası ve durumuyla tek tek izlenenler ve hareketli toplam olarak tutulan türler. Bunu 'kaç tane 8 yarda çöp konteynerimiz boş', '214 numaralı konteyner nerede', 'kirada ne var' için kullanın.

container_type	isteğe bağlı	Filtrelenecek konteyner türü, örneğin skip, roro, bin.
container_size	isteğe bağlı	Filtrelenecek konteyner boyutu, örneğin 8yd.
state	isteğe bağlı	Tek tek izlenen bir konteynerin durumu, örneğin in_yard, on_site, in_transit.

find_contracts

Sözleşmeler ve sezon biletleri

Bu kuruluşun sürekli anlaşmalarını listeleyin: sözleşmeler ve sezon biletleri, her birinin kapsadığı atık, geçerli olduğu tarihler ve her iki tarafın da imzalayıp imzalamadığı. Bunu 'sözleşmede ne var', 'o sezon bileti imzalandı mı', 'bu ay neyin süresi doluyor' için kullanın.

site_id	isteğe bağlı	Yalnızca bu saha için anlaşmalar.
active_only	isteğe bağlı	Yalnızca hâlâ yürürlükte olan anlaşmalar. Varsayılan false.

consignee_returns

Üç aylık alıcı beyanları

Bu kuruluşun alınan tehlikeli atık için üç aylık alıcı beyanları: çeyrek, ne zaman neyin ödeneceği, kaç sevkiyat ve hangi ağırlık ve gönderilip gönderilmediği. Bunu 'alıcı beyanımız tamam mı', 'bu çeyrekte ne ödenecek' için kullanın. Yalnızca alıcılar; bir taşıyıcının yoktur.

quarter	isteğe bağlı	Bir çeyrek etiketi, örneğin "Q1 2026".
status	isteğe bağlı	Filtrelenecek durum: not_started, generated, reviewed veya submitted.

find_waste_codes

Bir atık kodu ara

Avrupa Atık Kataloğu'nda (EWC) koda veya atığın ne olduğuna göre arama yapın ve her kodun tehlikeli mi yoksa bir ayna kayıt mı olduğunu söyleyin. Bunu 'alçıpanın kodu ne', '17 05 03 tehlikeli mi' için kullanın. Bu yayınlanmış ulusal listedir, bu kuruluşun kendi verisi değildir.

query	zorunlu	Bir kod veya kodun bir kısmı ("17 05") veya atığı tanımlayan kelimeler ("alçıpan").
hazardous_only	isteğe bağlı	Yalnızca tehlikeli kodlar. Varsayılan false.

create_customer

Müşteri ekleyazyazar

Bir müşteri ekleyin (kuruluşun atık topladığı bir toplama sahası). Gerekli herhangi bir şey eksikse hâlâ ne gerektiğiyle yanıt verir ve hiçbir şey yazmaz. Bu ad ve posta kodunda bir müşteri zaten varsa, ikinci bir tane oluşturmak yerine onu döndürür.

name	zorunlu	Atığın ait olduğu şirket veya kişi
address	zorunlu	Atığın toplandığı yer
postcode	zorunlu	Toplama adresinin posta kodu
producer_type	isteğe bağlı	Atığın bir işletmeden mi yoksa bir haneden mi geldiği. Varsayılan business.
contact_name	zorunlu	Sahada kime sorulacağı
contact_email	isteğe bağlı	E-posta adresleri
contact_phone	isteğe bağlı	Telefon numaraları
sic_code	isteğe bağlı	Üreticinin SIC kodu, biliniyorsa

create_receiving_site

Alım sahası ekleyazyazar

Bir alım sahası ekleyin (atığın götürüldüğü bir döküm sahası, aktarma istasyonu veya geri dönüşüm tesisi). Gerekli herhangi bir şey eksikse hâlâ ne gerektiğiyle yanıt verir ve hiçbir şey yazmaz.

name	required	Sitenin adı
address	required	Sitenin adresi
postcode	required	Sitenin posta kodu
permit_number	optional	Çevre izni veya muafiyet numarası
contact_name	optional	Kapıda kime sorulacağı
contact_email	optional	Onların e-posta adresi
contact_phone	optional	Onların telefon numarası
is_own_site	optional	Yalnızca bu, kuruluşun kendi sitesiyse ve başkasınınki değilse doğrudur. Varsayılan olarak false'dur.

create_carrier

Bir taşıyıcı veya komisyoncu eklewrites

Kuruluşun çalıştığı bir taşıyıcı, komisyoncu veya satıcı ekler. Gerekli bir şey eksikse hâlâ neyin gerektiğiyle yanıt verir ve hiçbir şey yazmaz.

company_name	required	Taşıyıcı veya komisyoncunun şirket adı
registration_number	optional	Biliniyorsa atık taşıyıcı kayıt numaraları
contact_name	optional	Kiminle konuşulacağı
contact_email	optional	Onların e-posta adresi
contact_phone	optional	Onların telefon numarası
address	optional	Onların adresi
postcode	optional	Onların posta kodu
notes	optional	Onlar hakkında kaydedilmeye değer herhangi bir şey

create_vehicle

Bir araç eklewrites

Filosuna bir araç ekler. Gerekli bir şey eksikse hâlâ neyin gerektiğiyle yanıt verir ve hiçbir şey yazmaz. Filoda zaten kayıtlı bir plaka, ikinci bir tane oluşturmak yerine o aracı döndürür.

registration	required	Plaka numarası
make	optional	Kimin ürettiği
description	optional	Model veya açıklama
vehicle_type	optional	Ne tür bir araç olduğu, örneğin konteyner kamyonu veya damperli kamyon
mot_expiry	optional	MOT'un ne zaman bittiği (YYYY-AA-GG)
tax_expiry	optional	Verginin ne zaman bittiği (YYYY-AA-GG)
max_weight_tonnes	optional	Ton cinsinden brüt ağırlık

create_driver

Bir sürücü eklewrites

Bir sürücü ekler, böylece onlara iş verilebilir ve sürücü uygulamasında transfer notlarını imzalayabilirler. Planın sürücü kontenjanlarından birini kullanır ve hepsi kullanılıyorsa reddeder. Kimseye ofis girişi vermez: bu, bir sahip veya yönetici tarafından Ekip sayfasında dağıtılır. Zaten ekipte olan birine, sahip oldukları kayda sürücü uygulaması eklenir.

name	required	Tam adları
email	required	Sürücü uygulamasına davetin gittiği e-posta adresleri
phone_number	optional	Telefon numaraları
role	optional	Ne yaptıkları, örneğin HGV sürücüsü
address	optional	Ev adresleri
postcode	optional	Ev posta kodları
licence_expiry	optional	Ehliyetlerinin ne zaman bittiği (YYYY-AA-GG)
emergency_contact_name	optional	Acil bir durumda kimi arayacağı
emergency_contact_phone	optional	O kişinin telefon numarası

create_enquiry

Bir toplama talebini kaydetwrites

Bir müşteriden bir toplama talebini (bir sorgulama) kaydeder, böylece ofis teklif verebilir. Gerekli bir şey eksikse hâlâ neyin gerektiğiyle yanıt verir ve hiçbir şey yazmaz.

company_name	required	Soran şirket
contact_name	required	Kimin iletişime geçtiği
contact_email	required	Onların e-posta adresi
contact_phone	required	Onların telefon numarası
site_address	required	Atığın olduğu yer
postcode	optional	Bu adresin posta kodu
waste_description	required	Atığın ne olduğu, kendi sözleriyle
service_type	optional	Ne istedikleri, örneğin bir konteyner veya bir kepçe yükü
estimated_weight	optional	Ton cinsinden kabaca ne kadar
preferred_date	optional	Ne zaman istedikleri (YYYY-AA-GG)
access_notes	optional	Sahaya girişle ilgili herhangi bir şey

Yazma

6 create_ aracı bir müşteri, bir alım sitesi, bir taşıyıcı veya komisyoncu, bir araç, bir sürücü ve bir toplama talebi ekler. Birinin LoadSnap'a veri girmesinin yolu, bir form doldurmak veya bir elektronik tablo hazırlamak yerine bir konuşmada bunu tarif etmektir.

Hiçbir şey yarı yazılmaz. Gerekli bir şey eksik olan bir çağrı hiçbir şey yazmaz ve hâlâ neyin gerektiğinin listesiyle, soru olarak ifade edilmiş şekilde yanıt verir, böylece asistan bunu sorar ve tekrar çağırır. Zaten var olan bir kayıt için yapılan bir çağrı, ikinci bir tane oluşturmak yerine oradaki kaydı geri verir, böylece aynı isteği iki kez çalıştırmak bir kopya bırakamaz.

Bu şekilde eklenen bir sürücü, planın sürücü kontenjanlarından birini kullanır ve hepsi kullanılıyorsa, tam olarak Ekip sayfasındaki gibi reddedilir ve zaten ekipte olan kişilerle eşleştirilir, böylece zaten orada çalışan birine sahip oldukları kayda sürücü uygulaması eklenir. Kimseye ofis girişi verilmez: bu ücretli bir koltuk ve işe bir yoldur ve Ekip'te bir sahip veya yönetici tarafından dağıtılır.

DEFRA'ya dosyalama, bir transfer notu imzalama, bir fatura çıkarma ve herhangi bir şeyi silme kasıtlı olarak burada değildir. Bunlar, bir kişinin LoadSnap'ta adıyla yaptığı şeylerdir.

Etkileşimli panel

Sunucu, ui://loadsnap/panel adresinde bir MCP kaynağı olarak etkileşimli bir panel yayınlar ve her araç ona işaret eder. Uygulamalar uzantısını destekleyen bir istemci, yanıtı konuşmada bir panel olarak çizer: bir kayıt tablosu, yeni eklenen kayıt için bir kart veya bir şey kaydedilmeden önce hâlâ gerekenlerin bir kontrol listesi.

Kendi verisi olmayan, belirteci olmayan ve ağdan hiçbir şey getirmeyen, kendi içinde eksiksiz bir belgedir. İstemci, aracın yanıtını ona iletir. Her araç ayrıca bu yanıtı metin olarak döndürür, böylece panel çizmeyen bir istemci her zaman gösterdiğini tam olarak gösterir.

Sınırlar ve biçimler

Ağırlıklar, bir alan adı ton demedikçe kilogram olarak döndürülür. Tarihler ISO'dur (YYYY-AA-GG). Bir arama en alakalı 25 eşleşmeyi döndürür; count_movements 1.000 satıra kadar okur ve bu tavana ulaştığında count_is_capped'i bildirir, böylece sınırlanmış bir rakam asla kesin bir toplam olarak sunulmaz. Aynısı, totals_are_capped'i bildiren find_invoices üzerindeki ödenmesi gereken para için de geçerlidir. Örnek olarak eklenen kayıtlar her sonuçtan hariç tutulur.

Gereksinimler

Pro planında veya üzerinde bir LoadSnap hesabı ve bir LoadSnap kuruluşuna ait bir giriş. Bağlanan herkes kendi girişini kullanır, çünkü bağlantı onlar olarak yetkilendirilir.

Bağlayıcı hakkında sorularınız mı var? info@loadsnap.co.uk adresine e-posta gönderin veya bağlayıcı genel bakışını okuyun.