---
title: "Configurar seu cliente"
description: "Blocos de configuração copy-paste para Claude Desktop, Claude Code, Cursor, Windsurf e VS Code - nos modos hosted (sem instalação) e npx (local)."
source_url: https://nfe.io/docs/mcp/comecar/clientes
last_updated: 2026-08-24
---

# Configurar seu cliente

Há dois modos de conectar:

- **Hosted (recomendado):** aponta para `https://mcp.nfe.io/mcp`. Não requer Node instalado. É o mais simples.
- **npx (local):** roda o servidor na sua máquina via stdio. Requer **Node.js 22+**. Útil quando você prefere não usar o endpoint hosted.

Em ambos, sem chave você tem as 13 ferramentas gratuitas. Para as demais, veja **[Adicionar sua chave](/mcp/comecar/adicionar-chave)**.

---

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

**Hosted:**

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

**npx (local):**

```json
{
  "mcpServers": {
    "nfe-io": {
      "command": "npx",
      "args": ["-y", "@nfe/mcp-server"]
    }
  }
}
```

Reinicie o Claude Desktop.

---

## Claude Code

Use a CLI:

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

# npx (local)
claude mcp add nfe-io -- npx -y @nfe/mcp-server
```

---

## Cursor

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

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

Para o modo local, troque por `"command": "npx", "args": ["-y", "@nfe/mcp-server"]`.

---

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