Uso local (npx)
Além do endpoint hosted, você pode rodar o servidor na sua máquina via npx, no transporte stdio. Requer Node.js 22+.
{
"mcpServers": {
"nfe-io": {
"command": "npx",
"args": ["-y", "@nfe/mcp-server"],
"env": {
"NFE_API_KEY": "SUA_CHAVE_DE_DADOS"
}
}
}
}
Sem nenhuma variável, o servidor sobe e responde as 13 ferramentas gratuitas.
Variáveis de ambiente
| Variável | Obrigatória | Uso |
|---|---|---|
NFE_API_KEY | não | Chave de Dados - operações fiscais |
NFE_LOOKUP_API_KEY | não | Chave de Consulta - lookups (fallback para a de Dados) |
NFE_COMPANY_ID | não | UUID da empresa padrão |
Hosted ou local?
Hosted (mcp.nfe.io) | Local (npx) | |
|---|---|---|
| Instalação | Nenhuma | Node.js 22+ |
| Credencial | Header por requisição | Variável de ambiente |
| Rate limit / cache | Sim (endpoint público) | Não (protegido por não ter exposição pública) |
| Recomendado para | Maioria dos usuários | Quem prefere rodar local |
Para chaves, precedência e empresa padrão, veja Autenticação.