---
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-10-07
tags: ["mcp", "autenticacao", "how-to"]
---

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

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

```json
{
  "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](/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.
:::