SI5 Global SI5 Global
MCP • disponível • somente leitura

Use o SI5 Global dentro do seu assistente de IA

O servidor MCP do SI5 Global deixa o Claude, o Cursor, o VS Code e outros clientes MCP consultarem o catálogo: produto por código de barras ou por nome, com marca, foto, NCM e CEST, e a descrição oficial de qualquer NCM. Mais de 14 milhões de produtos.

Ferramentas disponíveis

consultar_codigo_barras

Produto de um código de barras GS1 (GTIN/EAN de 8, 12, 13 ou 14 dígitos): nome, marca, categoria, NCM, CEST, país do prefixo GS1, foto e link da página.

buscar_produtos

Busca por texto livre (nome, marca, tipo de produto), tolerando erro de digitação. Devolve até 10 produtos com código de barras, marca, NCM e link.

consultar_ncm

Descrição oficial de um código NCM de 8 dígitos (tabela vigente) e o link da página com produtos de exemplo.

Dados do servidor

URL: https://global.si5.com.br/api/mcp

Transporte: Streamable HTTP (JSON-RPC 2.0) · Autenticação: cabeçalho Authorization: Bearer SEU_TOKEN

A descoberta das ferramentas (initialize, tools/list) é aberta; cada consulta (tools/call) exige o token e desconta 1 da franquia do seu plano da API. Troque SEU_TOKEN pelo token criado na sua conta.

Como instalar

Claude Code

No terminal:

claude mcp add --transport http si5-global https://global.si5.com.br/api/mcp \
  --header "Authorization: Bearer SEU_TOKEN"

Cursor

Em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "si5-global": {
      "url": "https://global.si5.com.br/api/mcp",
      "headers": { "Authorization": "Bearer SEU_TOKEN" }
    }
  }
}

VS Code

Em .vscode/mcp.json:

{
  "servers": {
    "si5-global": {
      "type": "http",
      "url": "https://global.si5.com.br/api/mcp",
      "headers": { "Authorization": "Bearer SEU_TOKEN" }
    }
  }
}

Claude Desktop

No arquivo de configuração do Claude Desktop, pelo adaptador mcp-remote (precisa do Node.js):

{
  "mcpServers": {
    "si5-global": {
      "command": "npx",
      "args": ["mcp-remote", "https://global.si5.com.br/api/mcp",
               "--header", "Authorization:Bearer SEU_TOKEN"]
    }
  }
}

Os formatos de configuração podem mudar entre versões de cada cliente; se algo não funcionar, confira a documentação de MCP do cliente.

ChatGPT e claude.ai (web): em breve

Os conectores personalizados desses dois pedem login por OAuth (você clica em Conectar e autoriza com a sua conta do SI5 Global). Esse login está em desenvolvimento; quando ficar pronto, esta página mostra o passo a passo.

Exemplo real

Você pede ao assistente

“Qual é o produto do código de barras 7891000100103 e qual o NCM dele?”

O assistente chama a ferramenta consultar_codigo_barras e responde com os dados ao lado, citando a página do produto.

O servidor devolve

{
  "codigo_barras": "7891000100103",
  "nome": "Leite Condensado Moça Lata Nestlé 395g",
  "marca": "NESTLE",
  "categoria": "MERCEARIA",
  "ncm": "04029900",
  "cest": "1702000",
  "pais_registro_gs1": "Brasil",
  "pagina": "https://global.si5.com.br/produtos/7891000100103",
  "fonte": "SI5 Global (global.si5.com.br)"
}

Limites e cuidados

Só leitura: o servidor nunca altera dados. Cada consulta desconta 1 da franquia diária do seu plano (30 por dia no gratuito); há também um limite de 30 chamadas por minuto por IP.

Envie o código de barras como texto para preservar zeros à esquerda. Nem todo código está no catálogo e alguns campos podem faltar.

NCM e CEST são referências do catálogo, com a origem registrada. Confirme a classificação fiscal com seu contador antes de emitir notas.

Perguntas frequentes

O que é o servidor MCP do SI5 Global?

É um conector no padrão MCP (Model Context Protocol) que deixa assistentes de IA como Claude, Cursor e VS Code consultarem o catálogo SI5 Global: produto por código de barras ou por nome, com marca, foto, NCM e CEST, e a descrição oficial de códigos NCM.

Precisa pagar?

Não para começar: o token é grátis e dá 30 consultas por dia. Cada consulta feita pelo assistente desconta 1 da franquia do seu plano da API.

Funciona no ChatGPT e no claude.ai?

Ainda não: esses dois pedem login por OAuth nos conectores personalizados, que está em desenvolvimento. Hoje funciona em clientes que aceitam o cabeçalho Authorization com o token, como Claude Code, Claude Desktop, Cursor e VS Code.