MCP (Model Context Protocol) é um padrão aberto que permite a um assistente de IA, como o Claude, usar ferramentas e dados de outros sistemas com as permissões que você concedeu. Na logística, isso significa perguntar em português "quais pedidos estão em separação hoje?" e receber a resposta com os dados reais do WMS e do OMS, sem abrir relatório. O servidor MCP do 4LogOS conecta o Claude a pedidos, estoque e frete da sua conta.
O problema: a resposta está no sistema, mas ninguém tem tempo de buscar
Toda operação tem as mesmas perguntas do dia:
- Quais pedidos estão atrasados?
- Quanto tem do SKU tal nos CDs?
- O pedido 55098 já foi conferido?
- Quanto fica o frete para esse CEP?
- Qual o rastreio do pedido do cliente que ligou agora?
A resposta está no sistema, mas exige abrir tela, montar filtro e exportar planilha. Quem decide, muitas vezes, nem tem acesso ao WMS. A pergunta vira mensagem para o supervisor, que para a onda para responder. O comercial espera, o atendimento espera, e o armazém perde o ritmo.
Como funciona o MCP na logística
O servidor MCP expõe funções com nome e parâmetros, como "listar pedidos" ou "consultar estoque". Durante a conversa, o Claude escolhe a ferramenta certa, chama a API do sistema e responde com o resultado. Você vê qual ferramenta foi chamada e com quais parâmetros.
No MCP do 4LogOS, a conexão leva quatro passos:
- Gere uma API Key de serviço. No portal do 4LogOS, em Configurações → API Keys, crie uma chave (formato 4lg_live_…) e marque só os escopos que o assistente pode usar. Para consulta, por exemplo, read:orders e read:wms. Os de escrita, só se fizer sentido.
- Adicione o conector no Claude. Em Claude → Settings → Connectors, adicione um conector personalizado com a URL https://mcp.4wms.com.br/mcp. O servidor é também um Authorization Server OAuth 2.1: você informa a API Key uma única vez e o Claude guarda um token, não a chave.
- Pergunte em português. Como perguntaria a um analista.
- Ação só com a sua aprovação. Para criar pedido, atualizar status, contratar envio ou ajustar estoque, o Claude pede sua aprovação antes de executar.
Desenvolvedores conectam pelo Claude Code, com claude mcp add --transport http e a mesma URL, ou rodam o servidor localmente via stdio, com modo somente leitura disponível.
As 21 ferramentas do MCP do 4LogOS
São as ferramentas publicadas hoje no servidor (versão 0.1.0), agrupadas por área. Cada grupo depende do escopo correspondente na chave.
| Grupo e escopos | Ferramenta | O que faz |
|---|---|---|
| Pedidos (read:orders · write:orders) | orders_list |
lista pedidos por status, canal e data |
orders_get |
detalha um pedido | |
orders_tracking |
rastreio e entrega do pedido | |
orders_create, orders_update_status, orders_cancel |
cria, atualiza status ou cancela pedido | |
| Estoque e produtos (read:wms · write:wms) | wms_stock, wms_stock_batch |
saldo por SKU, um ou vários |
wms_outbound_check |
conferência de saída de um pedido | |
products_list, products_get |
cadastro de produtos | |
products_create, products_update |
cria e atualiza produtos | |
products_adjust_stock |
ajuste de estoque | |
| Frete e envios (freight.quote · freight.track · freight.ship) | freight_quote |
cota o frete nas transportadoras configuradas |
freight_track |
status e histórico por código de rastreio | |
shipments_list, shipments_get |
lista e detalha envios | |
freight_create_shipment, freight_schedule_pickup, freight_cancel_shipment |
contrata, agenda coleta ou cancela envio |
As ferramentas de consulta usam os escopos de leitura de cada grupo; as que criam, alteram ou cancelam dependem dos escopos de escrita. Cancelar pedido e cancelar envio são ações sem volta, então pense duas vezes antes de dar esses escopos a uma chave usada por várias pessoas.
Perguntas reais e a ferramenta que responde
O Claude combina várias ferramentas numa mesma resposta. Alguns exemplos do dia a dia:
- "Quais pedidos estão em separação hoje?" Usa
orders_listfiltrando por status e data. - "Qual o saldo do SKU 1020 nos CDs?" Usa
wms_stock. Para uma lista de SKUs,wms_stock_batch. - "O pedido 55098 já foi conferido?" Usa
wms_outbound_checkpara ver o que já foi conferido antes de liberar a expedição. - "Quanto fica o frete deste pedido para o CEP do cliente?" Usa
orders_getpara pegar os itens efreight_quotepara cotar. - "Qual o rastreio do pedido 55102?" Usa
orders_trackingoufreight_trackcom o código. - "Agende a coleta dos envios de hoje." Usa
shipments_listefreight_schedule_pickup, e pede sua aprovação antes de agendar.
Quem na empresa ganha com o MCP
O maior uso não é do operador, que já está no coletor. É de quem precisa de um dado da operação e hoje depende de alguém do armazém para consegui-lo:
- Atendimento: consulta o status e o rastreio do pedido enquanto o cliente está na linha.
- Comercial: confere o saldo de um SKU antes de prometer prazo a um cliente B2B.
- Gestor de operação: cruza pedidos, estoque e frete numa pergunta só, sem montar relatório.
- Diretoria: pergunta o que quiser sem treinamento no sistema.
Se cada área conectar com uma API Key própria, dá para dar só leitura para a maioria e escopo de escrita só para quem responde pela ação.
Segurança: escopo por chave, isolamento e aprovação humana
Um assistente com acesso ao sistema só é útil se for seguro. O desenho parte do mesmo controle que a API pública do 4LogOS já tem:
- Cada conexão acessa só a conta (tenant) da API Key que a autorizou.
- Os escopos da chave limitam o que cada ferramenta pode fazer. Sem o escopo, a API devolve erro e nada é alterado, e o Claude explica o motivo.
- O conector usa OAuth 2.1: a chave é informada uma vez e o Claude guarda um token.
- O Claude pede aprovação antes de executar ferramentas, mostrando a chamada e os parâmetros.
- No modo local, a variável de somente leitura desliga todas as ferramentas de escrita.
Para quem só precisa consultar, a regra é simples: crie a chave apenas com escopos de leitura.
A conta do ganho: o tempo das perguntas do dia
Na animação do MCP do 4LogOS, os indicadores de referência são menos de 10 segundos da pergunta ao dado, 100% isolado por conta e zero ação sem confirmação. São valores ilustrativos. O ganho real depende de quantas perguntas a sua operação faz e de quem para para responder.
Horas por mês hoje = perguntas por dia × minutos por resposta × dias úteis ÷ 60
Custo mensal = horas por mês × custo da hora de quem responde
| Variável | Sua operação |
|---|---|
| Perguntas por dia que chegam ao armazém (comercial, atendimento, diretoria) | |
| Minutos para responder cada uma (abrir tela, filtrar, exportar, responder) | |
| Dias úteis no mês | |
| Custo da hora de quem responde, com encargos (R$) | |
| Custo mensal das perguntas | fórmula acima |
Há um ganho que não entra na fórmula: o supervisor que não sai da onda para responder mensagem. Se a pergunta vai direto ao Claude, a separação não para.
Quando o MCP não é a ferramenta certa
O MCP não substitui a integração com o ERP nem os painéis do portal. Ele resolve a pergunta pontual e a ação rápida.
- Fluxo contínuo entre sistemas (pedido do marketplace entrando no OMS, nota do ERP) é trabalho de integração por API ou conector, não de conversa.
- Indicador que você acompanha todo dia fica melhor num painel no portal, sempre igual.
- Pergunta sobre algo que a ferramenta não cobre não tem resposta. Hoje o servidor cobre pedidos, estoque, produtos, frete e envios; produtividade de operador, por exemplo, não está entre as ferramentas publicadas.
- Sem conta no 4LogOS, não há o que conectar: o servidor usa a API pública da sua conta.
Próximo passo
Veja os detalhes do MCP do 4LogOS, assista à animação logo abaixo e, se ainda não tem conta, peça uma demonstração. Os planos partem de R$ 4.990/mês, com implantação a partir de R$ 5 mil conforme o plano e 14 dias de teste grátis. Confirmamos na conversa qual plano atende a sua operação.
Perguntas frequentes
O que é MCP na logística?
MCP (Model Context Protocol) é um padrão aberto que deixa um assistente de IA, como o Claude, usar ferramentas de outros sistemas. Na logística, ele permite perguntar em português sobre pedidos, estoque e frete e receber os dados reais do WMS e do OMS, com as permissões que você concedeu.
Como conectar o Claude ao 4LogOS?
Gere uma API Key de serviço no portal do 4LogOS (Configurações → API Keys), adicione um conector personalizado no Claude com a URL https://mcp.4wms.com.br/mcp e informe a chave uma vez na autorização OAuth. No Claude Code, use claude mcp add --transport http com a mesma URL.
Quais dados o Claude consegue consultar pelo MCP do 4LogOS?
Pedidos (lista, detalhe e rastreio), saldo de estoque por SKU, conferência de saída de um pedido, cadastro de produtos, cotação e rastreio de frete e envios. São 21 ferramentas publicadas, e as de escrita dependem do escopo da chave.
A IA pode alterar dados sem eu saber?
Não. As ferramentas de escrita só funcionam se a API Key tiver o escopo correspondente, e o Claude pede aprovação antes de executar uma ferramenta. Para uso só de consulta, crie a chave apenas com escopos de leitura.
Meus dados ficam isolados de outras empresas?
Sim. Cada conexão é autorizada por uma API Key ligada a uma única conta do 4LogOS e só enxerga os dados dessa conta. O conector guarda um token OAuth, não a chave.