IA

Pergunte ao Claude quanta farinha ainda tem: estoque medido pelo MCP

Publicado em · 6 min de leitura

Quando um assistente de IA lê o seu estoque pelo servidor MCP integrado, ele recebe uma lista de itens com nomes, custos e contagens. Até agora, uma contagem era um número inteiro sem unidade, o que era ótimo para cadeiras e estranho para farinha. Pergunte “quanta farinha ainda tem” e a resposta honesta era “12”, seguida de um palpite sobre se isso significava sacos, quilos ou libras.

Com as unidades de medida, toda quantidade que o servidor retorna é um decimal, e todo item carrega a sua unidade. O assistente não precisa mais adivinhar. Veja como isso fica numa conversa, e o que mudou nas ferramentas para quem gosta de saber.

Package Pal conversando com um assistente de IA num notebook sobre níveis de estoque.
O assistente lê a unidade junto com o número, então a resposta volta em quilos.

Uma manhã na padaria

Claude · conectado ao Simple Inventory Management empresa: Padaria Northside
Quanta farinha de pão nós temos, e dá para hoje?
get_inventory
Você tem 12,75 kg de farinha de pão em estoque, com mais 50 kg em pedido. Seu nível de alerta é 20 kg e o nível crítico é 10 kg, então a linha já está amarela. Com os 0,5 kg por pão da sua montagem Pão de fermentação natural, isso dá para cerca de 25 pães antes de entrar na zona crítica.
Acabamos de usar 4,5 kg na primeira fornada. Registre isso.
edit_inventory_item
Pronto. A farinha de pão agora está em 8,25 kg, abaixo do seu nível crítico de 10 kg. Um alerta de estoque baixo foi enviado ao seu canal do Teams. Quer que eu verifique se os 50 kg em pedido têm data de entrega?
Sim, e adicione 2 L de azeite ao mesmo pedido se ele ainda não foi enviado.
create_order
O pedido “Entrega do moinho, semana 44” ainda está pendente. Adicionei uma linha com 2 L de azeite, então o pedido agora tem 50 kg de farinha de pão e 2 L de azeite.

Nada nessa troca precisou de conversão ou de uma pergunta para esclarecer. O assistente leu 12.75 e kg do mesmo item, leu o componente da montagem em quilos e gravou o novo valor de estoque na mesma unidade. O histórico do item mostra a subtração de 4,5 kg com um marcador de robô ao lado, como qualquer outra alteração feita pelo MCP.

Perguntas que só fazem sentido com uma unidade

  • “Quais itens medidos em litros estão abaixo do nível de alerta?”
  • “Quantos pães o estoque atual de farinha consegue fazer?” (o assistente lê a montagem, ou faz a divisão sozinho)
  • “Converta as sugestões de reposição para sacos, considerando que um saco tem 25 kg.” O aplicativo não converte, mas o assistente converte com prazer, e vai dizer que fez isso.
  • “Crie um item chamado Resina de fundição, rastreado em ml, e defina o nível de alerta em 250.”
  • “Recebemos 3 rolos de cabo com 100 m cada. Adicione 300 m ao cabo blindado de 6 mm.”

A lista geral de perguntas continua valendo; estas são as que eram impossíveis de responder bem antes de a unidade viajar junto com o número.

O que mudou nas ferramentas

Se você usa o servidor MCP a partir do seu próprio cliente ou script, três coisas são diferentes.

  • As quantidades são decimais. inventoryCount, onOrderCount, toShipCount e damagedCount em get_inventory e edit_inventory_item aceitam e retornam valores como 12.75. Clientes que trabalham com inteiros continuam funcionando; uma contagem de 12 continua sendo 12.
  • Os itens carregam um unit. Ele é null para itens contados em peças e um rótulo curto (kg, lb, ml, ft, ou o que você tiver digitado) para os medidos. edit_inventory_item pode defini-lo, e create_new_inventory_item aceita um unit opcional.
  • As ferramentas relacionadas acompanham. As linhas de pedido em create_order, as linhas de estoque nas ferramentas de unidade e get_reorder_suggestions informam decimais, e as sugestões de reposição incluem a unidade do item, para que um 50 sugerido se leia como 50 kg.

As descrições das ferramentas também dizem tudo isso, o que importa mais do que parece: um assistente lê a descrição antes de chamar a ferramenta, então ele sabe de antemão que uma contagem em um item medido está na unidade desse item e que definir uma unidade não converte nada.

O que ele não faz

O servidor nunca converte entre unidades. Se você pedir ao assistente para “mudar a farinha para libras”, ele vai trocar o rótulo e, se estiver sendo cuidadoso, avisar que o número não mudou. É a mesma regra que o aplicativo aplica às pessoas, pelo mesmo motivo: uma conversão silenciosa é um ótimo jeito de acabar com 22 kg de farinha que na verdade são 10. Peça a conversão explicitamente, deixe o assistente fazer a conta na conversa e depois confirme a nova contagem.

Ainda não conectou? O guia de configuração leva uns quatro passos, e o acesso é limitado a uma empresa e revogável a qualquer momento. Funciona com Claude, Grok, OpenAI, Gemini e qualquer outro cliente MCP.

Conecte um assistente ao seu estoque