LoadSnap

MCPサーバーリファレンス

AIアシスタントをLoadSnapアカウントに接続するために必要なすべての情報、および接続後に読み取れる内容について説明します。

エンドポイント

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

Streamable HTTPトランスポートを使用したリモートModel Context Protocolサーバーです。単一のPOSTによるJSON-RPC 2.0を使用します。サーバーはステートレスであるため、セッションヘッダーやサーバー開始のイベントストリームはなく、GETリクエストは405を返します。

このURLをカスタムまたはリモートコネクタとして、Claude、Claude Code、ChatGPT、Cursor、その他のMCP互換クライアントに追加してください。貼り付けるAPIキーはありません。

認証

OAuth 2.1: PKCE付き認可コードに加え、動的クライアント登録を使用するため、クライアントは手動設定なしで自己登録できます。ディスカバリは通常の方法で機能し、認証されていないリクエストは保護リソースのメタデータを指すWWW-Authenticateヘッダー付きの401を返します。

保護リソースのメタデータ	/.well-known/oauth-protected-resource
認可サーバーのメタデータ	/.well-known/oauth-authorization-server
動的クライアント登録	/api/oauth/register
認可	/oauth/authorize
トークン	/api/oauth/token

ユーザーはLoadSnapにサインインし、クライアント名と組織を表示する画面で接続を承認します。アクセストークンは1時間有効で、リフレッシュトークンによって更新されるため、再サインインなしで接続を維持できます。

アクセスはキーではなく個人として認可されます。組織のメンバーシップとプランはリクエストごとに再チェックされるため、組織から誰かを削除すると、その人のコネクタアクセスも終了します。

アクセス範囲

すべてのクエリは、トークンからサーバー側で解決される認可ユーザーの組織にハードフィルタリングされます。クライアントが組織を指定することはないため、他の会社のデータを要求することはできません。行レベルのセキュリティが、基盤となるデータベースでも同じ境界を強制します。

21のツールのうち15は読み取り専用です。名前がcreate_で始まる6つはレコードを追加するだけで、それ以外は何もしません。編集、削除、DEFRAへの提出、譲渡票への署名、請求書の発行、オフィスログインの発行は行いません。各ツールは注釈で書き込みとしてマークされているため、クライアントは実行前にユーザーに確認を求めます。

組織スコープの唯一の例外はfind_waste_codesで、公開されている欧州廃棄物カタログを検索します。これは全員にとって同じ国のリストであり、誰の独自データでもありません。

ツール

21のツールがあり、すべて認可された組織にスコープされています。各ツールについて、クライアントに提供される説明と受け付ける引数を以下に示します。書き込みとマークされたツールはレコードを追加し、残りは読み取りのみです。

find_movements

廃棄物の移動を検索

この組織の廃棄物移動記録（廃棄物譲渡票）とジョブを、生産者、顧客、運搬業者の名前および/または収集日範囲で一覧表示または検索します。「Xの移動を行ったか」「5月にYから何を収集したか」、または名前なしで「先週何を移動したか」に使用します。

name	optional	検索する生産者、顧客、または運搬業者の名前。日付範囲内のすべてを一覧表示するには省略します。
date_from	optional	オプションのISO日付（YYYY-MM-DD）下限
date_to	optional	オプションのISO日付（YYYY-MM-DD）上限

find_receipts

受入伝票を検索

この組織の受入伝票（自社サイトに到着した廃棄物）を、運搬業者または生産者の名前および/または受入日範囲で一覧表示または検索します。範囲内で受け取ったすべてを一覧表示するには名前を省略します。

name	optional	運搬業者または生産者の名前。すべてを一覧表示するには省略します。
date_from	optional	オプションのISO日付（YYYY-MM-DD）下限
date_to	optional	オプションのISO日付（YYYY-MM-DD）上限

count_movements

廃棄物の移動を数える

この組織の廃棄物の移動を日付範囲で数え、その重量を合計し、オプションで受入または搬出に分割します。「先月何回積み込みをしたか」「今年どれだけの廃棄物を扱ったか」「今週何回収集したか」に使用します。収集日でカウントします。

date_from	optional	収集日のISO日付（YYYY-MM-DD）下限
date_to	optional	収集日のISO日付（YYYY-MM-DD）上限
direction	optional	inbound = この組織の自社サイトで受け入れた廃棄物、outbound = 自社のトラックが運び出した、または送り出した廃棄物。すべてを対象にするには省略します。

defra_filings

DEFRA提出

この組織のDEFRA廃棄物追跡提出を日付範囲で数えて一覧表示し、まだ提出待ちのレコードを一覧表示します。「今週DEFRAに何件提出したか」「DEFRAで何か失敗したか」「まだ未処理のものは何か」に使用します。

date_from	optional	提出日のISO日付（YYYY-MM-DD）下限
date_to	optional	提出日のISO日付（YYYY-MM-DD）上限
include_outstanding	optional	DEFRAにまだ提出されていないレコードも返します。デフォルトはtrueです。

find_parties

運搬業者とサイトを検索

会社名またはサイト名を、組織が把握している運搬業者とサイトに解決します。

name	required	会社名またはサイト名

find_jobs

予定ジョブを検索

この組織のジョブ（予約済み、進行中、完了済みの作業）を、顧客名および/または予定日範囲で一覧表示または検索します。「明日は何をするか」「カーターのジョブは予約されているか」「まだ未割り当てのものは何か」に使用します。ジョブリストは日記であるため、最も早い日付から前方に読み取ります。

name	optional	検索する顧客名。範囲内のすべてを一覧表示するには省略します。
status	optional	フィルタリングするジョブステータス。例: draft、scheduled、in_progress、completed、cancelled。
date_from	optional	オプションのISO日付（YYYY-MM-DD）下限
date_to	optional	オプションのISO日付（YYYY-MM-DD）上限

find_invoices

請求書と未払い金

この組織の請求書を一覧表示し、まだ支払われていない金額を合計します。オプションで未払いのものだけを対象にできます。「誰が私たちにお金を借りているか」「未払い額はいくらか」「カーターの請求書は支払われたか」「延滞しているものは何か」に使用します。合計は請求書の通貨で表示されます。

name	optional	請求書が送られた事業者の名前。範囲内のすべてを一覧表示するには省略します。
status	optional	フィルタリングする請求書ステータス。例: draft、issued、paid、void。
only_unpaid	optional	まだ支払い残高がある請求書のみ。デフォルトはfalseです。
date_from	optional	オプションのISO日付（YYYY-MM-DD）下限
date_to	optional	オプションのISO日付（YYYY-MM-DD）上限

find_vehicles

車両とその書類

この組織の車両を、MOT、税金、保険の有効期限とともに一覧表示し、期限切れのものをフラグ付けします。「車両台数は何台か」「MOT切れはあるか」「VX19 ABCの税金はいつか」に使用します。MOTと税金はDVLAから取得され、最後のチェック時点の情報です。

name	optional	検索する登録番号または説明。範囲内のすべてを一覧表示するには省略します。
include_inactive	optional	車両台数から外された車両も返します。デフォルトはfalseです。

find_people

チームとその利用可能なもの

この組織のチームメンバーと、各メンバーが3つのアクセス方法（オフィスログイン、ドライバーアプリ、ウェイブリッジアプリ）のうちどれを持っているかを一覧表示します。「誰が私たちのために運転するか」「デイブはドライバーアプリを持っているか」「チームには誰がいるか」に使用します。

name	optional	検索する人の名前またはメールアドレス。範囲内のすべてを一覧表示するには省略します。
drivers_only	optional	ドライバーアプリを持っている人のみ。デフォルトはfalseです。

compliance_status

証明書、許可証、登録

この組織が記録している証明書、許可証、登録を有効期限とともに一覧表示し、すでに期限切れのものを示します。「廃棄物運搬業者登録はまだ有効か」「今年期限切れになるものは何か」「ISO証明書をファイルに持っているか」に使用します。

expired_only	optional	すでに期限切れのもののみ。デフォルトはfalseです。

find_documents

文書を検索

この組織の保存済み文書（廃棄物譲渡票、委託状、許可証、アップロードされた書類）を、種類および/または日付で検索し、各文書へのリンクを提供します。「その積み込みの譲渡票を送って」「このジョブに関してどんな書類があるか」に使用します。

document_type	optional	フィルタリングする文書の種類。例: wtn、hwcn、annex_vii、permit、upload。
movement_id	optional	この廃棄物移動に添付された文書のみ。
job_id	optional	このジョブに添付された文書のみ。
date_from	optional	オプションのISO日付（YYYY-MM-DD）下限
date_to	optional	オプションのISO日付（YYYY-MM-DD）上限

container_stock

スキップとコンテナ

この組織が保有するコンテナとその場所: 資産番号と状態で個別に追跡されるもの、および実行合計として保持される種類。「8ヤードのスキップが何台空いているか」「スキップ214はどこにあるか」「レンタルに出しているものは何か」に使用します。

container_type	optional	フィルタリングするコンテナの種類。例: skip、roro、bin。
container_size	optional	フィルタリングするコンテナのサイズ。例: 8yd。
state	optional	個別に追跡されるコンテナの状態。例: in_yard、on_site、in_transit。

find_contracts

契約とシーズンチケット

この組織の継続的な契約を一覧表示します: 契約とシーズンチケット、それぞれがカバーする廃棄物、契約期間、両者が署名済みかどうか。「契約しているものは何か」「そのシーズンチケットは署名されたか」「今月期限切れになるものは何か」に使用します。

site_id	optional	このサイトの契約のみ。
active_only	optional	まだ有効な契約のみ。デフォルトはfalseです。

consignee_returns

四半期の荷受人報告

この組織の有害廃棄物受入に関する四半期の荷受人報告: 四半期、いつ何が期限か、何件の委託とその重量、送信済みかどうか。「荷受人報告は完了したか」「今四半期の期限は何か」に使用します。受入者のみ対象で、運搬業者にはありません。

quarter	optional	四半期ラベル。例: "Q1 2026"。
status	optional	フィルタリングするステータス: not_started、generated、reviewed、submitted。

find_waste_codes

廃棄物コードを調べる

欧州廃棄物カタログ（EWC）をコードまたは廃棄物の内容で検索し、各コードが有害かミラーエントリかを示します。「石膏ボードのコードは何か」「17 05 03は有害か」に使用します。これは公開されている国のリストであり、この組織の独自データではありません。

query	required	コードまたはその一部（"17 05"）、または廃棄物を説明する言葉（"plasterboard"）。
hazardous_only	optional	有害コードのみ。デフォルトはfalseです。

create_customer

顧客を追加するwrites

顧客（組織が廃棄物を収集する収集サイト）を追加します。必須項目が不足している場合は、まだ必要なものを回答し、何も書き込みません。同じ名前と郵便番号の顧客がすでに存在する場合は、2つ目を作成せずにその顧客を返します。

name	required	廃棄物が属する会社または個人
address	required	廃棄物が収集される場所
postcode	required	収集場所の郵便番号
producer_type	optional	廃棄物が事業所からか家庭からか。デフォルトはbusinessです。
contact_name	required	サイトで連絡する担当者
contact_email	optional	その人のメールアドレス
contact_phone	optional	その人の電話番号
sic_code	optional	生産者のSICコード（既知の場合）

create_receiving_site

受入サイトを追加するwrites

受入サイト（廃棄物が運ばれる処分場、転送ステーション、リサイクル施設）を追加します。必須項目が不足している場合は、まだ必要なものを回答し、何も書き込みません。

name	required	サイト名
address	required	サイトの住所
postcode	required	サイトの郵便番号
permit_number	optional	環境許可証または免除番号
contact_name	optional	ゲートで問い合わせる担当者
contact_email	optional	その担当者のメールアドレス
contact_phone	optional	その担当者の電話番号
is_own_site	optional	他者のサイトではなく、この組織自身のサイトの場合のみ true。デフォルトは false。

create_carrier

運搬業者または仲介業者を追加する（書き込み）

組織が取引する運搬業者、仲介業者、または販売業者を追加します。必須項目が不足している場合は、不足しているものを回答し、何も書き込みません。

company_name	required	運搬業者または仲介業者の会社名
registration_number	optional	廃棄物運搬業者の登録番号（既知の場合）
contact_name	optional	連絡先担当者
contact_email	optional	その担当者のメールアドレス
contact_phone	optional	その担当者の電話番号
address	optional	その会社の住所
postcode	optional	その会社の郵便番号
notes	optional	記録に値する特記事項

create_vehicle

車両を追加する（書き込み）

車両を車両群に追加します。必須項目が不足している場合は、不足しているものを回答し、何も書き込みません。すでに車両群にある登録番号は、2台目を作成せずにその車両を返します。

registration	required	ナンバープレート
make	optional	製造メーカー
description	optional	モデルまたは説明
vehicle_type	optional	車両の種類（例：スキップローリー、チッパー）
mot_expiry	optional	MOTの有効期限（YYYY-MM-DD）
tax_expiry	optional	自動車税の有効期限（YYYY-MM-DD）
max_weight_tonnes	optional	総重量（トン）

create_driver

ドライバーを追加する（書き込み）

ドライバーを追加して、ジョブを割り当てたり、ドライバーアプリで譲渡書に署名できるようにします。プランのドライバー枠の1つを使用し、すべて使用中の場合は拒否します。誰にもオフィスログインを付与しません。それはオーナーまたは管理者がチームページで付与します。すでにチームにいる人は、既存のレコードにドライバーアプリが追加されます。

name	required	氏名（フルネーム）
email	required	メールアドレス（ドライバーアプリへの招待が送信される場所）
phone_number	optional	電話番号
role	optional	役割（例：HGVドライバー）
address	optional	自宅住所
postcode	optional	自宅の郵便番号
licence_expiry	optional	免許の有効期限（YYYY-MM-DD）
emergency_contact_name	optional	緊急時の連絡先
emergency_contact_phone	optional	その連絡先の電話番号

create_enquiry

回収依頼を記録する（書き込み）

顧客からの回収依頼（問い合わせ）を記録して、オフィスが見積もりを出せるようにします。必須項目が不足している場合は、不足しているものを回答し、何も書き込みません。

company_name	required	依頼している会社
contact_name	required	連絡を取った担当者
contact_email	required	その担当者のメールアドレス
contact_phone	required	その担当者の電話番号
site_address	required	廃棄物がある場所
postcode	optional	その住所の郵便番号
waste_description	required	廃棄物の内容（依頼者の言葉で）
service_type	optional	依頼内容（例：スキップ、グラブロード）
estimated_weight	optional	おおよその量（トン）
preferred_date	optional	希望日（YYYY-MM-DD）
access_notes	optional	サイトへのアクセスに関する特記事項

書き込みについて

6つのcreate_ツールは、顧客、受入サイト、運搬業者または仲介業者、車両、ドライバー、回収依頼を追加します。これらは、フォームに記入したりスプレッドシートを準備したりする代わりに、会話で説明することでデータをLoadSnapに入力する方法です。

中途半端な書き込みは一切行われません。必須項目が不足している呼び出しは、何も書き込まず、不足している項目を質問形式で回答するため、アシスタントがそれを尋ねて再度呼び出します。すでに存在するレコードの呼び出しは、2つ目を作成せずに既存のレコードを返すため、同じリクエストを2回実行しても重複が残ることはありません。

この方法で追加されたドライバーは、チームページと同様にプランのドライバー枠の1つを使用し、すべて使用中の場合は拒否されます。また、すでにチームにいる人と照合されるため、すでにそこで働いている人には、既存のレコードにドライバーアプリが追加されます。誰にもオフィスログインは付与されません。それは有料の席であり、ビジネスへの入り口であるため、オーナーまたは管理者がチームページで付与します。

DEFRAへの提出、譲渡書への署名、請求書の発行、および削除は意図的にここには含まれていません。これらはLoadSnap内で人が自分の名前を付けて行うものです。

インタラクティブパネル

サーバーは、MCPリソースとしてui://loadsnap/panelにインタラクティブパネルを公開し、すべてのツールがそれを指しています。アプリ拡張機能をサポートするクライアントは、回答を会話内のパネルとして描画します：レコードの表、追加されたばかりのレコードのカード、または保存前に不足しているもののチェックリストです。

これは自己完結型の単一ドキュメントであり、独自のデータ、トークン、ネットワークからの取得はありません。クライアントはツールの回答をそれに渡します。すべてのツールは回答をテキストとしても返すため、パネルを描画しないクライアントは常に表示していたものとまったく同じものを表示します。

制限と形式

重量は、フィールド名がトンと指定しない限り、キログラムで返されます。日付はISO形式（YYYY-MM-DD）です。検索は最も関連性の高い25件の一致を返します。count_movementsは最大1,000行を読み取り、その上限に達するとcount_is_cappedを報告するため、上限に達した数値が正確な合計として提示されることはありません。これはfind_invoicesの未払い金額にも適用され、totals_are_cappedを報告します。サンプルとしてシードされたレコードは、すべての結果から除外されます。

要件

Proプラン以上のLoadSnapアカウントと、LoadSnap組織に属するログインが必要です。接続はその人として認証されるため、接続する全員が自分のログインを使用します。

コネクタについての質問は、info@loadsnap.co.ukまでメールするか、コネクタ概要をお読みください。