Adicionar sua chave

As 13 ferramentas gratuitas funcionam sem nada. Para consultar dados reais e operar notas e empresas, conecte suas chaves da NFE.io.

Quais chaves existem

A NFE.io tem duas chaves, com nomes no dashboard:

Chave (dashboard)	Desbloqueia	Nível
Chave de Consulta	Consulta de CNPJ e CEP (lookup_cnpj, lookup_address)	1
Chave de Dados	Notas de serviço e empresas (listar, consultar, emitir, criar)	2

Onde obter

As chaves ficam no painel da NFE.io, em app.nfe.io. A Chave de Consulta é usada para lookups; a Chave de Dados para operações fiscais.

Como passar a chave

Hosted (mcp.nfe.io)

A chave viaja no header da requisição. No seu cliente MCP, adicione o header Authorization:

{
  "mcpServers": {
    "nfe-io": {
      "type": "http",
      "url": "https://mcp.nfe.io/mcp",
      "headers": {
        "Authorization": "Bearer SUA_CHAVE_DE_DADOS"
      }
    }
  }
}

Para uma Chave de Consulta específica, use o header X-NFE-Lookup-Key. Detalhes e precedência em Autenticação.

Claude Desktop (via mcp-remote)

O Claude Desktop não manda headers diretamente - a chave passa como argumento do mcp-remote, lida de uma variável de ambiente local para não ficar em texto puro na config:

{
  "mcpServers": {
    "nfe-io": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.nfe.io/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer SUA_CHAVE_DE_DADOS"
      }
    }
  }
}

Empresa padrão (opcional)

Se você opera uma única empresa, defina um company padrão para não repetir o ID em cada pedido - via header X-NFE-Company-Id (hosted, ou outro --header no mcp-remote para Claude Desktop). Veja Autenticação.

Comece pelo seguro

Ao ativar a Chave de Dados, comece pelas consultas ("lista minhas notas de junho") antes de emitir. Emissão é destrutiva - sempre com modo de teste e confirmação.