Send247 Human Logistics

Logística Humana na Camada de IA

GitHub

Documentação

Servidor MCP de Entregas Send247

O MCP de Entregas Send247 é um servidor de Protocolo de Contexto de Modelo (MCP) que permite que assistentes de IA cotem e reservem entregas no Reino Unido por meio de uma interface estruturada, segura e auditável.

Ele foi projetado para ChatGPT, Claude, GitHub Copilot e outros clientes compatíveis com MCP.

O Que Este Aplicativo Faz

O servidor MCP expõe funcionalidades de entrega como ferramentas que um assistente de IA pode invocar com segurança:

  • Obter cotações de entrega em tempo real entre endereços no Reino Unido
  • Criar (reservar) uma entrega usando uma cotação gerada anteriormente
  • Exigir confirmação antes de qualquer ação irreversível
  • Manter estado no lado do servidor para que a continuidade da sessão do LLM não seja necessária

Este aplicativo é destinado a usuários finais localizados no Reino Unido.

Ferramentas Disponíveis

get_delivery_quote

Retorna opções de entrega e preços para um envio.

Uso típico

  • O usuário quer saber o custo da entrega
  • O usuário compara serviços antes de reservar

Propriedades principais

  • Não é somente leitura (cache de cotações com estado)
  • Mundo aberto (usa provedores de entrega externos)
  • Não destrutivo

create_delivery

Cria uma reserva de entrega usando uma cotação emitida anteriormente.

Uso típico

  • O usuário confirma explicitamente que deseja reservar uma entrega

Propriedades principais

  • Grava dados
  • Mundo aberto
  • Destrutivo (cria reservas de entrega irreversíveis)

Esta ferramenta só deve ser invocada após confirmação explícita do usuário.

Configuração do Cliente MCP

Este servidor MCP é publicamente acessível e pode ser conectado por qualquer cliente compatível com MCP.

A autenticação e a validação de solicitações são tratadas no nível do gateway. Nenhuma chave de API do lado do cliente é necessária.

Configuração MCP para ChatGPT / OpenAI

{
  "mcpServers": {
    "send247-delivery": {
      "url": "https://mcp.send247.uk/api/v1/mcp"
    }
  }
}

Após conectar, habilite o aplicativo em uma conversa e faça solicitações normalmente (por exemplo: "Obtenha uma cotação de entrega de Londres para Manchester").

Configuração MCP para Claude (Anthropic)

Claude Desktop e Claude Code

O Claude executa servidores MCP localmente e ainda não suporta URLs MCP remotas diretamente. Para conectar o Claude ao send247, usamos a ponte remota oficial do MCP (@modelcontextprotocol/remote), que faz proxy do servidor MCP remoto via stdio.

  1. Instale o MCP Remote: npm install -g @modelcontextprotocol/remote

  2. Adicione o seguinte à sua configuração MCP:

{
  "mcpServers": {
    "send247-delivery": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/remote",
        "https://mcp.send247.uk/api/v1/mcp"
      ]
    }
  }
}

O Claude descobrirá automaticamente as ferramentas disponíveis via tools/list.

Configuração MCP para GitHub Copilot (VS Code)

{
  "mcpServers": {
    "send247-delivery": {
      "url": "https://mcp.send247.uk/api/v1/mcp"
    }
  }
}

Ao usar o Copilot Chat, as ferramentas aparecerão quando prompts relacionados a entregas forem detectados.

Opcional: Manifesto MCP (Descoberta)

Para plataformas ou registros que suportam manifestos MCP, você pode incluir o seguinte arquivo:

mcp.json

{
  "name": "Send247 Delivery",
  "description": "UK delivery quotes and booking via the Model Context Protocol",
  "version": "1.0.0",
  "endpoint": "https://mcp.send247.uk/api/v1/mcp",
  "capabilities": {
    "tools": true
  }
}

Isso é opcional, mas melhora a descoberta.

Garantias de Segurança e Design

  • Nenhuma entrega é criada sem confirmação explícita
  • Cotações expiram automaticamente
  • Esquemas de ferramentas são estritamente validados
  • Estado no lado do servidor garante confiabilidade entre sessões de LLM
  • Todas as ações de gravação são auditáveis

Uso Pretendido

Este servidor MCP é destinado a:

  • Assistentes de IA que oferecem serviços de entrega
  • Fluxos de trabalho agênticos que exigem ações logísticas
  • Usuários finais no Reino Unido

Ele não é um SDK logístico geral e não expõe APIs brutas de provedores.

Status

  • Servidor MCP implantado e publicamente acessível
  • Testado com o MCP Inspector e o modo de desenvolvedor do ChatGPT
  • Enviado para revisão no Diretório de Aplicativos da OpenAI

Suporte

Para dúvidas de integração ou problemas, entre em contato com o mantenedor pelo repositório ou pelos canais oficiais do projeto. Envie um e-mail para tech@clickdrop.co.uk