Configurar seu cliente

Há um único servidor: o endpoint hosted, em https://mcp.nfe.io/mcp. Não há pacote local para instalar - não publicamos um npx próprio, então desconfie de qualquer instrução que peça para rodar um pacote na sua máquina.

A maioria dos clientes fala HTTP remoto nativamente e aponta direto para essa URL. O Claude Desktop é a exceção: ele ainda não suporta servidores MCP remotos, então precisa de uma ponte local via npx mcp-remote (veja a seção dele abaixo) - nesse caso é necessário ter Node.js instalado.

Sem chave você já tem as 13 ferramentas gratuitas. Para as demais, veja Adicionar sua chave.

Use apenas o MCP oficial da NFE.io

Só existe um servidor MCP oficial da NFE.io: mcp.nfe.io, configurado abaixo. A NFE.io não endossa nem se responsabiliza por MCPs ou conectores de terceiros que usem seu nome - especialmente ao conectar suas chaves de API.

---

Claude Desktop

Abra Settings → Developer → Edit Config (ou edite direto o arquivo):

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

O Claude Desktop não aceita servidor remoto direto ("type": "http"). Use o pacote mcp-remote via npx como ponte local para o endpoint hosted - requer Node.js instalado:

{
  "mcpServers": {
    "nfe-io": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.nfe.io/mcp"]
    }
  }
}

Reinicie o Claude Desktop. Para conectar com sua chave nesse modo, veja Adicionar sua chave.

---

Claude Code

Use a CLI:

claude mcp add --transport http nfe-io https://mcp.nfe.io/mcp

---

Cursor

Edite ~/.cursor/mcp.json (global) ou .cursor/mcp.json (no projeto):

{
  "mcpServers": {
    "nfe-io": {
      "type": "http",
      "url": "https://mcp.nfe.io/mcp"
    }
  }
}

---

Windsurf

Edite ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "nfe-io": {
      "serverUrl": "https://mcp.nfe.io/mcp"
    }
  }
}

---

VS Code

Com a extensão de MCP, edite .vscode/mcp.json no projeto:

{
  "servers": {
    "nfe-io": {
      "type": "http",
      "url": "https://mcp.nfe.io/mcp"
    }
  }
}

---

Depois de configurar, volte para Conectar e confirme que as ferramentas apareceram - ou vá direto para o Livro de receitas.