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.

npx (local)

A chave vai como variável de ambiente:

{
  "mcpServers": {
    "nfe-io": {
      "command": "npx",
      "args": ["-y", "@nfe/mcp-server"],
      "env": {
        "NFE_API_KEY": "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 NFE_COMPANY_ID (local). 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.