Integração via MCP

Passo a passo

1. 1

   Solicite seu acesso

   Fale com nossa equipe (contato no rodapé) informando o nome da empresa e a loja que você representa. Você recebe um token de leitura começando com i24_read_.

2. 2

   Configure no seu cliente MCP

   No Claude Desktop, Claude Code, n8n ou no seu agente, adicione o servidor remoto e o seu token:

   {
     "mcpServers": {
       "industria24": {
         "type": "http",
         "url": "https://mcp.industria24.com.br/mcp",
         "headers": { "Authorization": "Bearer i24_read_SEU_TOKEN" }
       }
     }
   }

3. 3

   Leia os dados

   Peça ao seu agente, por exemplo: “liste os produtos da minha loja” ou “qual o status do pedido 3F9U882N5J?”. As ferramentas de leitura disponíveis:

   • industria24_listar_registros — lista paginada de qualquer tabela.
   • industria24_buscar_registro — um registro por id.
   • industria24_buscar_produtos — busca por nome.
   • industria24_rastrear_corrida — posições GPS de uma entrega em curso.
4. 4

   Peça o acesso de escrita (opcional)

   Para sincronizar catálogo ou atualizar status de pedidos, solicite o token de escrita (i24_write_). Ele é emitido só após aprovação da nossa equipe e vale apenas para a sua loja. Troque o token no header Authorization pelo de escrita.

5. 5

   Edite com segurança

   Ferramentas de escrita (exigem token aprovado):

   • industria24_atualizar_produto — nome, descrição, preço, sku.
   • industria24_atualizar_estoque — estoque atual.
   • industria24_atualizar_status_pedido — status do pedido.
   • industria24_atualizar_entrega — status e rastreio da entrega.

   Toda edição é registrada em auditoria. Um token vazado pode ser revogado a qualquer momento — nunca compartilhe ou versione seu token.

6. 6

   Acompanhe a entrega em tempo real

   Enquanto a carga está em rota, o parceiro logístico registra a posição pelo aplicativo. Peça “onde está a corrida X?” e você recebe as últimas coordenadas com data e hora, no mesmo formato usado pelos padrões de rastreio veicular do mercado (transport, device, locations).

   {
     "transport": { "id": "9f1c...", "status": "EmTransito" },
     "device": { "external_entity_type": "PARCEIRO_LOGISTICO" },
     "locations": [
       { "latitude": -3.101944, "longitude": -60.025,
         "date": "2026-07-20T14:41:01.000Z" }
     ]
   }

   Posições existem entre a coleta e a entrega, na cadência do parceiro em rota — trate a lista como esparsa. Detalhes em Rastreio em tempo real.