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.
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.
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.
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.
Descrição oficial de um código NCM de 8 dígitos (tabela vigente) e o link da página com produtos de exemplo.
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.
No terminal:
claude mcp add --transport http si5-global https://global.si5.com.br/api/mcp \ --header "Authorization: Bearer SEU_TOKEN"
Em ~/.cursor/mcp.json:
{
"mcpServers": {
"si5-global": {
"url": "https://global.si5.com.br/api/mcp",
"headers": { "Authorization": "Bearer SEU_TOKEN" }
}
}
}Em .vscode/mcp.json:
{
"servers": {
"si5-global": {
"type": "http",
"url": "https://global.si5.com.br/api/mcp",
"headers": { "Authorization": "Bearer SEU_TOKEN" }
}
}
}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.
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.
“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.
{
"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)"
}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.
É 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.
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.
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.