LoadSnap
oficialConsulte seus registros de conformidade de resíduos do Reino Unido a partir de qualquer assistente de IA. Acesso somente leitura às suas próprias notas de transferência de resíduos, recibos, tonelagem e envios ao DEFRA Digital Waste Tracking.
O que você pode fazer com LoadSnap MCP?
- Pesquisar movimentações de resíduos — Solicite notas de transferência de resíduos ou trabalhos por transportadora, gerador ou nome do cliente e intervalo de datas via
find_movements. - Revisar recibos do site — Liste os recibos de entrada de resíduos no seu próprio site, filtrados por transportadora, gerador ou intervalo de datas com
find_receipts. - Resumir totais de movimentações — Obtenha contagens de movimentações e peso total em um período, opcionalmente dividido por direção de entrada/saída, usando
count_movements. - Verificar status de envio à DEFRA — Conte e liste os envios de Digital Waste Tracking, incluindo registros pendentes, com
defra_filings. - Resolver nomes de empresas — Corresponda um nome de empresa ou site aos seus transportadores e sites conhecidos usando
find_parties.
Documentação
Referência do servidor MCP
Tudo o que é necessário para conectar um assistente de IA a uma conta LoadSnap, e o que ele pode ler uma vez conectado.
Endpoint
https://app.loadsnap.co.uk/api/mcp
Um servidor remoto do Model Context Protocol usando o transporte HTTP Streamable: JSON-RPC 2.0 sobre um único POST. O servidor não tem estado, portanto não há cabeçalho de sessão nem fluxo de eventos iniciado pelo servidor, e um GET retorna 405.
Adicione-o ao Claude, Claude Code, ChatGPT, Cursor ou qualquer outro cliente compatível com MCP como um conector personalizado ou remoto, usando essa URL. Não há chave de API para colar.
Autenticação
OAuth 2.1: código de autorização com PKCE, além de Registro Dinâmico de Cliente, para que um cliente se registre sozinho sem configuração manual. A descoberta funciona da maneira usual: uma solicitação não autenticada retorna 401 com um cabeçalho WWW-Authenticate apontando para os metadados do recurso protegido.
| Metadados do recurso protegido | /.well-known/oauth-protected-resource |
|---|---|
| Metadados do servidor de autorização | /.well-known/oauth-authorization-server |
| Registro dinâmico de cliente | /api/oauth/register |
| Autorização | /oauth/authorize |
| Token | /api/oauth/token |
A pessoa faz login na LoadSnap e aprova a conexão em uma tela que nomeia o cliente e a organização. Os tokens de acesso duram uma hora e são renovados com um token de atualização, então a conexão continua funcionando sem novo login.
O acesso é autorizado como pessoa, não como chave. A associação à organização e o plano são verificados novamente a cada solicitação, então remover alguém de uma organização encerra o acesso do conector dessa pessoa junto.
Escopo do acesso
Cada consulta é estritamente filtrada para a organização do usuário autorizado, resolvida no lado do servidor a partir do token. O cliente nunca fornece uma organização, portanto não pode solicitar dados de outra empresa. A segurança em nível de linha aplica a mesma fronteira no banco de dados subjacente.
O servidor é somente leitura. Não há ferramenta que crie, edite ou exclua nada.
Ferramentas
find_movements
Lista ou pesquisa registros de movimentação de resíduos (Notas de Transferência de Resíduos) e trabalhos.
| name | opcional | Nome do produtor, cliente ou transportador. Omita para listar tudo no intervalo de datas. |
|---|---|---|
| date_from | opcional | Data ISO (AAAA-MM-DD) como limite inferior na data de coleta. |
| date_to | opcional | Data ISO (AAAA-MM-DD) como limite superior na data de coleta. |
find_receipts
Lista ou pesquisa recibos de resíduos que chegam ao próprio site da organização.
| name | opcional | Nome do transportador ou produtor. Omita para listar tudo recebido no intervalo. |
|---|---|---|
| date_from | opcional | Data ISO (AAAA-MM-DD) como limite inferior na data de recebimento. |
| date_to | opcional | Data ISO (AAAA-MM-DD) como limite superior na data de recebimento. |
count_movements
Conta movimentações em um período e totaliza o peso delas, opcionalmente dividido por direção.
| date_from | opcional | Data ISO (AAAA-MM-DD) como limite inferior na data de coleta. |
|---|---|---|
| date_to | opcional | Data ISO (AAAA-MM-DD) como limite superior na data de coleta. |
| direction | opcional | inbound, outbound ou all. Inbound é o resíduo recebido no próprio site da organização. |
defra_filings
Conta e lista os envios do DEFRA Digital Waste Tracking, e os registros ainda aguardando envio.
| date_from | opcional | Data ISO (AAAA-MM-DD) como limite inferior na data de envio. |
|---|---|---|
| date_to | opcional | Data ISO (AAAA-MM-DD) como limite superior na data de envio. |
| include_outstanding | opcional | Também retorna registros ainda não enviados. O padrão é true. |
find_parties
Resolve um nome de empresa ou site para os transportadores e sites conhecidos da organização.
| name | obrigatório | Nome da empresa ou site. |
|---|
Limites e formatos
Os pesos são retornados em quilogramas, a menos que o nome do campo indique toneladas. As datas são ISO (AAAA-MM-DD). As duas ferramentas de busca retornam as 25 correspondências mais recentes; count_movements lê até 1.000 linhas e informa count_is_capped quando atinge esse teto, então um valor limitado nunca é apresentado como total exato. Registros semeados como amostras são excluídos de todos os resultados.
Requisitos
Uma conta LoadSnap no plano Pro ou superior, e um login que pertença a uma organização LoadSnap. Todos que se conectam usam o próprio login, porque a conexão é autorizada como eles.
Dúvidas sobre o conector? Envie um e-mail para info@loadsnap.co.uk, ou leia a visão geral do conector.