MCP do 4LogOS: sua operação logística dentro do Claude
Toda operação tem as mesmas perguntas do dia: quais pedidos estão atrasados, quanto tem do SKU tal, por que aquele pedido não saiu, quanto fica o frete para esse CEP. A resposta está no sistema, mas exige abrir tela, montar filtro e exportar planilha. Quem decide, muitas vezes, nem tem acesso ao sistema, e a pergunta vira mensagem para alguém do armazém.
O servidor MCP do 4LogOS leva pedidos, estoque e frete para dentro do Claude. Você conecta a sua conta uma vez e passa a perguntar em português: o Claude escolhe a ferramenta certa, consulta a API do 4LogOS e responde com os dados reais da sua operação. Cada conexão enxerga só a conta da chave que a autorizou e só faz o que os escopos dessa chave permitem. Por ser um padrão aberto, a mesma conexão serve para outros agentes de IA compatíveis com MCP.
O que é MCP (Model Context Protocol)?
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 de forma controlada. Um servidor MCP expõe funções com nome e parâmetros, como "listar pedidos" ou "consultar estoque", e o assistente chama essas funções durante a conversa, com as permissões que o usuário concedeu.
MCP do 4LogOS na prática
Conecte o Claude ao 4LogOS pelo servidor MCP: pergunte em português sobre pedidos, estoque e envios e receba dados reais da sua conta. Ação de escrita só com a sua confirmação.
MCP do 4LogOS: como funciona no 4LogOS
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: por exemplo read:orders e read:wms para consulta, e os de escrita apenas 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ê cola a API Key uma única vez e o Claude guarda um token seguro.
Pergunte em português
Pergunte como perguntaria a um analista: "quais pedidos estão em separação hoje?", "qual o saldo do SKU 1020 nos CDs?", "quanto fica o frete desse pedido?". O Claude mostra qual ferramenta chamou e com quais parâmetros.
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 a ferramenta. Se a chave não tem o escopo de escrita, a API recusa a chamada e o Claude explica o motivo.
Use no Claude Code ou no seu agente
Desenvolvedores conectam pelo Claude Code (claude mcp add --transport http) ou rodam o servidor localmente via stdio, com o modo somente leitura disponível. Qualquer cliente que fale MCP por HTTP usa o mesmo endpoint.
Ferramentas do servidor MCP do 4LogOS
Cada ferramenta corresponde a uma chamada da API pública e respeita os escopos da sua API Key.
Pedidos
Escopos: 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 ou cancela pedido
Estoque e produtos (WMS)
Escopos: 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
Escopos: 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- envios
freight_create_shipment · freight_schedule_pickup · freight_cancel_shipment- contrata, agenda coleta ou cancela envio
Como conectar o Claude ao 4LogOS
Antes, gere uma API Key de serviço no portal (Configurações → API Keys) só com os escopos que o assistente pode usar.
Claude (web e Desktop) — conector
Settings → Connectors → Adicionar conector personalizado. Cole a URL e, na autorização, informe a sua API Key uma única vez.
https://mcp.4wms.com.br/mcpClaude Code
Registre o servidor remoto com a sua API Key no cabeçalho.
claude mcp add --transport http 4logos https://mcp.4wms.com.br/mcp \
--header "Authorization: Bearer 4lg_live_<sua_chave>"Outros clientes MCP
Qualquer cliente compatível com MCP por HTTP (Streamable HTTP) usa o mesmo endpoint, com OAuth 2.1 ou com a API Key no cabeçalho Authorization.
POST https://mcp.4wms.com.br/mcp
Authorization: Bearer 4lg_live_<sua_chave>O que o Claude consegue fazer com o MCP do 4LogOS
O servidor expõe a API pública do 4LogOS como ferramentas de IA. As de leitura respondem perguntas; as de escrita executam ações, sempre dentro dos escopos da chave.
- Pedidos: listar por status, canal e data, detalhar, rastrear e, com escopo de escrita, criar, atualizar status ou cancelar
- Conferência de saída: ver o que já foi conferido em um pedido antes de liberar a expedição
- Estoque e produtos: saldo por SKU, conferência de saída de um pedido, cadastro e ajuste de estoque
- Frete: cotação nas transportadoras configuradas, rastreio por código, contratação de envio e agendamento de coleta
Segurança: escopo por chave, isolamento por conta e aprovação humana
Um assistente de IA com acesso ao sistema só é útil se for seguro. O desenho do MCP do 4LogOS parte do mesmo controle que a API pública 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
- O conector usa OAuth 2.1: a API Key é informada uma vez e o Claude guarda um token, não a chave
- O Claude pede aprovação antes de executar ferramentas, e você vê a chamada e os parâmetros
- No modo local, a variável de somente leitura desliga todas as ferramentas de escrita
MCP x integração por API x relatório: quando usar cada um
O MCP não substitui a integração com o seu ERP nem os painéis do portal. Ele resolve a pergunta pontual e a ação rápida, em linguagem natural.
- Integração por API ou conector: fluxo contínuo e automático entre sistemas, como pedido do marketplace entrando no OMS
- Painel e relatório no portal: acompanhamento recorrente, com os mesmos indicadores todo dia
- MCP no Claude: a pergunta que não tem relatório pronto, a análise que cruza pedidos, estoque e frete, e a ação pontual com aprovação
- Gestores e áreas fora da logística (comercial, atendimento, diretoria) consultam a operação sem treinamento no sistema
Onde MCP do 4LogOS se encaixa na plataforma
Gestão de pedidos
Sistema OMS para gestão de pedidos multicanal: marketplaces, loja virtual e B2B num só painel, com roteamento por estoque entre CDs.
WMSGestão de armazém
Sistema WMS na nuvem com recebimento, endereçamento, picking por ondas, inventário e NF-e integrada.
TMSGestão de transporte
Sistema TMS com cotação de frete em várias transportadoras, roteirização, CT-e, MDF-e e torre de controle das entregas.
Mais usado por: E-commerce · Distribuidores · 3PL / Operador logístico
Perguntas frequentes: MCP do 4LogOS
O que é o MCP do 4LogOS?
É um servidor MCP (Model Context Protocol) que conecta assistentes de IA, como o Claude, à sua conta do 4LogOS. Ele expõe pedidos, estoque, produtos e frete como ferramentas que o assistente chama durante a conversa, com os escopos da sua API Key.
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.
Funciona com o ChatGPT e outros assistentes?
O servidor segue o padrão aberto MCP, com transporte HTTP e autorização OAuth 2.1. Clientes de IA que aceitam servidores MCP remotos usam o mesmo endpoint. A configuração documentada e testada pelo 4LogOS é a do Claude (conectores, Claude Desktop e Claude Code).
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 sua 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 (tenant) do 4LogOS e só enxerga os dados dessa conta. O conector guarda um token OAuth, não a chave.
Que perguntas dá para fazer?
Exemplos: "quais pedidos estão em separação hoje?", "qual o saldo do SKU 1020?", "o pedido 55098 já foi conferido?", "quanto fica o frete para este CEP?" e "qual o rastreio do pedido 55102?". O assistente combina várias ferramentas numa mesma resposta.
Quanto custa o MCP do 4LogOS?
O servidor MCP usa a API pública do 4LogOS, então vale para quem já tem uma conta. Os planos partem de R$ 4.990/mês (Lite), com Growth a R$ 6.990, Pro a R$ 8.990 e Enterprise sob consulta; a implantação parte de R$ 5 mil, conforme o plano, e dá para testar 14 dias grátis. Confirmamos na demonstração qual plano atende sua operação.
Funcionalidades relacionadas
Integração com marketplaces
Pedidos de marketplaces e lojas virtuais entram no WMS, e status e estoque voltam.
Torre de controle
Romaneios em trânsito, previsão de chegada, atrasos e comprovantes numa tela só.
Picking por ondas
Ondas de separação com rota otimizada, waveless para urgentes e divisão entre operadores.
Conferência de expedição
Confira a saída por pedido ou por nota fiscal, bipando produto ou número de série.
MCP do 4LogOS rodando na sua operação
Mostramos o fluxo com o seu tipo de operação e você testa 14 dias grátis. Planos a partir de R$ 4.990/mês, implantação a partir de R$ 5 mil.