---
title: "Adicionar sua chave"
description: "Como conectar suas chaves da NFE.io ao MCP para desbloquear consulta de CNPJ/CEP e a operação de notas e empresas."
source_url: https://nfe.io/docs/mcp/comecar/adicionar-chave
last_updated: 2026-08-24
---

# 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 |

:::info Onde obter
As chaves ficam no painel da NFE.io, em [app.nfe.io](https://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`:

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

### npx (local)

A chave vai como variável de ambiente:

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

:::tip 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.
:::