LoadSnap

MCP 서버 참조

AI 어시스턴트를 LoadSnap 계정에 연결하는 데 필요한 모든 것과, 연결 후 읽을 수 있는 내용입니다.

엔드포인트

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

Streamable HTTP 전송을 사용하는 원격 Model Context Protocol 서버: 단일 POST를 통한 JSON-RPC 2.0. 서버는 상태 비저장(stateless)이므로 세션 헤더나 서버 시작 이벤트 스트림이 없으며, GET 요청은 405를 반환합니다.

이 URL을 사용하여 Claude, Claude Code, ChatGPT, Cursor 또는 기타 MCP 호환 클라이언트에 사용자 지정 또는 원격 커넥터로 추가하세요. 붙여넣을 API 키는 없습니다.

인증

OAuth 2.1: PKCE가 포함된 인증 코드 방식과 동적 클라이언트 등록(Dynamic Client Registration)을 사용하므로 클라이언트는 수동 설정 없이 스스로 온보딩됩니다. 검색은 일반적인 방식으로 작동하며, 인증되지 않은 요청은 보호된 리소스 메타데이터를 가리키는 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로, 공개된 유럽 폐기물 목록(European Waste Catalogue)을 검색합니다 — 모든 사람에게 동일한 국가 목록이며, 누구의 자체 데이터도 아닙니다.

도구

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

예약된 작업 찾기

고객 이름 및/또는 예약 날짜 범위로 이 조직의 작업 — 예약된, 진행 중인 또는 완료된 작업 — 을 나열하거나 검색합니다. '내일 무엇을 하나요', 'Carter 작업이 예약되었나요', '아직 배정되지 않은 것이 무엇인가요'와 같은 질문에 사용하세요. 작업 목록은 일정이므로 가장 이른 날짜부터 앞으로 읽습니다.

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

송장 및 미지급 금액

이 조직의 송장을 나열하고 아직 미지급된 금액을 합산하며, 선택적으로 미지급된 것만 표시합니다. '누가 우리에게 돈을 빚고 있나요', '미지급액이 얼마인가요', 'Carter 송장이 지불되었나요', '연체된 것이 무엇인가요'와 같은 질문에 사용하세요. 합계는 송장 통화로 표시됩니다.

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

팀 및 사용 가능한 기능

이 조직의 팀 구성원과 각 구성원이 보유한 세 가지 접근 방식(사무실 로그인, 드라이버 앱, 계근대 앱)을 나열합니다. '우리를 위해 운전하는 사람은 누구인가요', 'Dave가 드라이버 앱을 가지고 있나요', '팀에 누가 있나요'와 같은 질문에 사용하세요.

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"), 또는 폐기물을 설명하는 단어("석고보드").
hazardous_only	optional	유해 코드만. 기본값은 false입니다.

create_customer

고객 추가쓰기

고객(조직이 폐기물을 수거하는 수거 사이트)을 추가합니다. 필수 항목이 누락된 경우 필요한 것이 무엇인지 답변하고 아무것도 쓰지 않습니다. 같은 이름과 우편번호의 고객이 이미 있으면 두 번째를 만들지 않고 해당 고객을 반환합니다.

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

수령 사이트 추가쓰기

수령 사이트(폐기물이 반입되는 하치장, 전송 스테이션 또는 재활용 시설)를 추가합니다. 필수 항목이 누락된 경우 필요한 것이 무엇인지 답변하고 아무것도 쓰지 않습니다.

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

운송업체 또는 중개인 추가writes

조직이 협력하는 운송업체, 중개인 또는 딜러를 추가합니다. 필수 항목이 누락된 경우 필요한 것이 무엇인지 답변하고 아무것도 기록하지 않습니다.

company_name	required	운송업체 또는 중개인의 회사 이름
registration_number	optional	폐기물 운송 등록 번호(알고 있는 경우)
contact_name	optional	연락할 담당자
contact_email	optional	해당 담당자의 이메일 주소
contact_phone	optional	해당 담당자의 전화번호
address	optional	해당 업체의 주소
postcode	optional	해당 업체의 우편번호
notes	optional	해당 업체에 대해 기록할 만한 사항

create_vehicle

차량 추가writes

차량을 차량대에 추가합니다. 필수 항목이 누락된 경우 필요한 것이 무엇인지 답변하고 아무것도 기록하지 않습니다. 이미 차량대에 있는 등록 번호는 두 번째로 만들지 않고 해당 차량을 반환합니다.

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

운전자 추가writes

운전자를 추가하여 작업을 배정하고 운전자 앱에서 운송 전표에 서명할 수 있게 합니다. 플랜의 운전자 할당량 중 하나를 사용하며 모두 사용 중이면 거부합니다. 누구에게도 사무실 로그인을 부여하지 않습니다. 사무실 로그인은 소유자 또는 관리자가 팀 페이지에서 부여합니다. 이미 팀에 있는 사람은 기존 기록에 운전자 앱이 추가됩니다.

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

수거 요청 기록writes

고객의 수거 요청(문의)을 기록하여 사무실에서 견적을 낼 수 있게 합니다. 필수 항목이 누락된 경우 필요한 것이 무엇인지 답변하고 아무것도 기록하지 않습니다.

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에 데이터를 입력하는 방법입니다.

절반만 기록되는 경우는 없습니다. 필수 항목이 누락된 호출은 아무것도 기록하지 않으며 필요한 항목 목록을 질문 형태로 답변하여 어시스턴트가 이를 요청하고 다시 호출하게 합니다. 이미 존재하는 기록에 대한 호출은 두 번째로 만들지 않고 기존 기록을 반환하므로 동일한 요청을 두 번 실행해도 중복이 발생하지 않습니다.

이렇게 추가된 운전자는 팀 페이지와 동일하게 플랜의 운전자 할당량 중 하나를 사용하며 모두 사용 중이면 거부되고, 이미 팀에 있는 사람과 대조되어 기존 직원의 기록에 운전자 앱이 추가됩니다. 누구에게도 사무실 로그인은 부여되지 않습니다. 사무실 로그인은 유료 좌석이자 업무 접근 권한이며 소유자 또는 관리자가 팀에서 부여합니다.

DEFRA에 신고, 운송 전표 서명, 인보이스 발행 및 삭제는 의도적으로 여기에 포함되지 않습니다. 이는 LoadSnap에서 담당자 이름이 기록되는 작업입니다.

대화형 패널

서버는 ui://loadsnap/panel의 MCP 리소스로 대화형 패널을 게시하며 모든 도구가 이를 가리킵니다. 앱 확장을 지원하는 클라이언트는 대화에서 답변을 패널로 표시합니다: 기록 표, 방금 추가된 기록의 카드, 또는 저장 전에 필요한 항목의 체크리스트입니다.

이는 자체 데이터, 토큰 또는 네트워크에서 가져온 항목이 없는 단일 독립 문서입니다. 클라이언트는 도구의 답변을 여기에 전달합니다. 모든 도구는 또한 해당 답변을 텍스트로 반환하므로 패널을 표시하지 않는 클라이언트도 항상 표시하던 내용을 그대로 표시합니다.

제한 및 형식

무게는 필드 이름에 톤이라고 명시되지 않는 한 킬로그램으로 반환됩니다. 날짜는 ISO 형식(YYYY-MM-DD)입니다. 검색은 가장 관련성 높은 25개의 결과를 반환합니다. count_movements는 최대 1,000행을 읽고 해당 상한에 도달하면 count_is_capped를 보고하므로 상한이 적용된 수치가 정확한 총계로 제시되지 않습니다. find_invoices의 미지급 금액에도 동일하게 적용되며 totals_are_capped를 보고합니다. 샘플로 시드된 기록은 모든 결과에서 제외됩니다.

요구 사항

Pro 플랜 이상의 LoadSnap 계정과 LoadSnap 조직에 속한 로그인이 필요합니다. 연결이 해당 사용자로 인증되므로 모든 사용자는 자신의 로그인을 사용합니다.

커넥터에 대한 질문이 있으신가요? info@loadsnap.co.uk로 이메일을 보내거나 커넥터 개요를 읽어보세요.