---
title: "Configurar seu cliente"
description: "Blocos de configuração copy-paste para Claude Desktop, Claude Code, Cursor, Windsurf e VS Code no endpoint hosted da NFE.io."
source_url: https://nfe.io/docs/mcp/comecar/clientes/
last_updated: 2026-10-07
tags: ["mcp", "referencia"]
---

# 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](/mcp/comecar/adicionar-chave)**.

:::warning 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`](https://www.npmjs.com/package/mcp-remote)** via `npx` como ponte local para o endpoint hosted - requer **Node.js** instalado:

```json
{
  "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](/mcp/comecar/adicionar-chave)**.

---

## Claude Code

Use a CLI:

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

---

## Cursor

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

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

---

## Windsurf

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

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

---

## VS Code

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

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

---

Depois de configurar, volte para **[Conectar](/mcp/comecar/conectar)** e confirme que as ferramentas apareceram - ou vá direto para o **[Livro de receitas](/mcp/comecar/receitas)**.