Documentação técnica

Desenvolvedores

A Indústria 24h expõe catálogo, pedidos, entregas e rastreio por um servidor MCP (Model Context Protocol) remoto. Qualquer cliente MCP — Claude, n8n, um agente próprio — fala com ele por HTTP com um token Bearer. Se você quer o passo a passo sem código, vá para Integração via MCP.

Endpoint

Servidor Streamable HTTP, sem sessão. Cada requisição carrega o próprio token; não há handshake a manter.

POST https://mcp.industria24.com.br/mcp
Authorization: Bearer i24_read_SEU_TOKEN
Content-Type: application/json

Configuração em um cliente MCP:

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

O modelo em uma tela

Leitura — token i24_read_. Produtos, lojas, categorias, pedidos, entregas, promoções, afiliações, centros de distribuição, corridas de logística e posições GPS.
Escrita — token i24_write_, emitido só após aprovação. Catálogo da sua loja e status de pedido/entrega. Nunca campos financeiros.
Escopo por loja — o token carrega um loja_id. Toda escrita é filtrada por ele; dados de outra loja não são alcançáveis.
Auditoria — cada chamada de escrita fica registrada com token, ferramenta, parâmetros e IP.

Por onde seguir

Autenticação — como obter, usar e revogar tokens.
Referência das ferramentas — parâmetros, retorno, paginação e erros.
Rastreio em tempo real — modelo de rastreio veicular e o que expomos hoje.

Endpoint

Servidor Streamable HTTP, sem sessão. Cada requisição carrega o próprio token; não há handshake a manter.

POST https://mcp.industria24.com.br/mcp
Authorization: Bearer i24_read_SEU_TOKEN
Content-Type: application/json

Configuração em um cliente MCP:

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

O modelo em uma tela

Leitura — token i24_read_. Produtos, lojas, categorias, pedidos, entregas, promoções, afiliações, centros de distribuição, corridas de logística e posições GPS.
Escrita — token i24_write_, emitido só após aprovação. Catálogo da sua loja e status de pedido/entrega. Nunca campos financeiros.
Escopo por loja — o token carrega um loja_id. Toda escrita é filtrada por ele; dados de outra loja não são alcançáveis.
Auditoria — cada chamada de escrita fica registrada com token, ferramenta, parâmetros e IP.