Model Context Protocol · Oficial

Seu Claude Desktop agora emite nota fiscal. Em 30 segundos.

Cole uma linha de config. Zero instalação. Zero glue code. Seu agente de IA passa a emitir NFS-e, consultar CNPJ e resolver CEP brasileiro — como se fosse nativo. Primeira API fiscal brasileira com MCP server oficial hospedado.

Conectar agora → Ver no GitHub

5 tools prontas · 3 formas de conectar · Claude · Cursor · Continue · Windsurf · VS Code

claude_desktop_config.json

// Cole isso. Reinicie o Claude. Pronto.
{
  "mcpServers": {
    "nfeio": {
      "type": "http",
      "url": "https://mcp.nfe.io/mcp",
      "headers": {
        "Authorization": "Bearer SUA_API_KEY"
      }
    }
  }
}

você → claude

→ você pergunta
"Consulte o CNPJ 12.345.678/0001-90
 e me diga se está ativo."

← claude responde (chama a tool)
nfeio_lookup_cnpj({
  cnpj: "12345678000190"
})

✓ Ativo · Razão social: ACME Ltda
✓ CNAE principal: 62.01-5
✓ Abertura: 2014-08-22
✓ Endereço: R. Example, 100 · SP

O que é MCP

Model Context Protocol. Pensa nele como USB-C pra agentes de IA.

MCP é o padrão criado pela Anthropic e adotado por OpenAI, Google e a indústria inteira pra conectar agentes (Claude, ChatGPT, Cursor) a ferramentas e APIs externas. Sem MCP, você escreve scripts. Com MCP, seu agente já conecta. Em segundos.

Sem MCP

Scripts. Wrappers. Retrabalho.

Seu dev escreve uma camada pra cada API que ele quer que a IA use. Cada LLM com seu formato. Cada versão quebra. O agente alucina os nomes de parâmetros porque não tem contrato claro.

Com MCP

Padrão único. Zero cola.

Cliente MCP (Claude, Cursor, Continue, Windsurf, VS Code) lê a lista de tools expostas, seus schemas e descrições. Agente escolhe, chama, funciona. Sem adivinhação. Sem código adaptador.

Resultado

Integração de horas, não de sprints.

"Emita uma NFS-e pra esse cliente" vira uma frase em linguagem natural. Do prompt à nota emitida: 30 segundos. Sem build. Sem deploy. Sem SDK glue code.

3 formas de conectar

Escolhe a que combina com seu setup.

Todas usam a mesma API key da NFE.io. Todas expõem as mesmas 5 tools. Você troca o transporte conforme a sua necessidade.

#1 · Hosted

mcp.nfe.io

Zero instalação. Cola a URL, passa sua API key no header, pronto. Recomendado pra 95% dos casos. Hospedado na borda Cloudflare Workers.

{
  "type": "http",
  "url": "https://mcp.nfe.io/mcp",
  "headers": {
    "Authorization": "Bearer ..."
  }
}

#2 · via npx

Rodando local

Stdio transport, sem build, sem clone. Útil em ambiente corporativo com firewall, ou pra rodar em pipeline de CI.

{
  "command": "npx",
  "args": ["-y",
    "@nfe/mcp-server"],
  "env": {
    "NFE_API_KEY": "..."
  }
}

#3 · Docker

Self-hosted

Imagem OCI multi-arch (amd64 + arm64) em ghcr.io/nfe/mcp-server. Deploy em AWS Fargate, Cloud Run, Kubernetes, Fly.io, on-prem.

docker run --rm \
  -p 3000:3000 \
  ghcr.io/nfe/mcp-server:latest

As 5 tools

Tudo que seu agente precisa pra operar fiscal brasileiro.

Todas com schemas Zod validados, descrições longas escritas pra agentes entenderem quando (e quando não) chamar, e mensagens de erro acionáveis.

nfeio_issue_service_invoice

Emite NFS-e pra uma empresa. Faz polling automático até estado terminal (5 min default). Suporta borrower, endereço, cálculo de impostos.

⚠ destrutivo · emite documento fiscal real

nfeio_list_service_invoices

Lista NFS-e de uma empresa com filtros de data e paginação por offset. Útil pra relatórios e reconciliação.

nfeio_get_invoice_status

Consulta o estado de processamento de uma nota específica. Útil após timeout de polling ou pra monitorar notas em fluxo.

nfeio_lookup_cnpj

Dados da Receita Federal pra um CNPJ: razão social, nome fantasia, situação cadastral, CNAE, sócios, endereço.

nfeio_lookup_address

Resolve CEP em logradouro, bairro, cidade (com código IBGE) e UF. Útil pra autofill de endereço no emissor.

Comece em 30 segundos

Sua próxima nota fiscal pode ser emitida por um agente.

Crie conta grátis na NFE.io, pega sua API key, cola no config do Claude Desktop (ou Cursor, VS Code, Continue, Windsurf). Pronto.

Criar conta grátis → Ver código