---
title: "Uso local (npx)"
description: "Rodar o servidor MCP da NFE.io localmente via npx (stdio), com variáveis de ambiente."
source_url: https://nfe.io/docs/mcp/referencia/uso-local-npx
last_updated: 2026-08-25
---

# 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+**.

```json
{
  "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](/mcp/referencia/autenticacao)**.