---
title: "Servidor MCP do Niv"
description: "niv mcp é o servidor MCP do Niv: roda no seu computador e deixa o Claude Code, o Cursor, o Claude Desktop e outros apps MCP lerem as notas de uma pasta e trabalharem com os bancos de dados de um Space. Sete ferramentas, sem servidor hospedado."
canonical: https://niv.md/pt-br/mcp
language: pt-BR
last_updated: 2026-11-14T17:16:54.000Z
---

# Servidor MCP do Niv

niv mcp deixa um app que fala MCP (Model Context Protocol), como o Claude Code, o Cursor ou o Claude Desktop, ler as notas de uma pasta, e ler e alterar os bancos de dados de um Space. É um servidor local: o app o inicia no seu computador e fala com ele por stdio. Vem com o niv, a linha de comando do Niv.

## Local, não hospedado

Não existe um servidor MCP do Niv na internet para conectar, e não vai existir um que leia as suas notas: todo Space criado agora é cifrado de ponta a ponta, então os servidores do Niv não têm chave para decifrar as notas dele. (Um Space criado antes da criptografia fica sem ela até quem é dono dele ativá-la.) As suas chaves ficam no seu dispositivo, e o niv mcp lê as notas ali, como arquivos numa pasta do seu computador. Nada para implantar, nenhuma chave para criar.

**O que o seu agente lê pelo niv vai para o provedor de IA dele, sob os termos desse provedor. Isso inclui notas de um Space criptografado: elas são descriptografadas neste dispositivo, então o provedor consegue ler. As linhas de bancos de dados não têm criptografia de ponta a ponta.**

## Como configurar

Instale o niv primeiro: [Niv CLI](https://niv.md/pt-br/cli).

No Claude Code, adicione direto:

```sh
claude mcp add niv -- niv mcp --folder <path>
```

No Claude Desktop, no Cursor ou em outro app, isto imprime o que adicionar às configurações:

```sh
niv mcp config --folder <path>
```

A pasta é sempre indicada, porque um app pode iniciar em qualquer lugar. Nunca é a sua pasta pessoal nem acima dela.

## As ferramentas

- `list_notes`: Lista as notas por caminho
- `read_note`: Lê uma nota, até 256 KB de texto, e avisa se cortou
- `search_notes`: Encontra notas por palavras no título ou no texto, sem diferenciar maiúsculas. Não é semântica
- `list_databases`: Lista os bancos de dados de um Space
- `query_rows`: Lê as linhas de um banco de dados
- `insert_row`: Adiciona uma linha
- `update_row`: Altera as células de uma linha

Aqui as notas são somente leitura. Para alterar uma, o seu agente edita o arquivo, e o niv sync ou o app leva a alteração.

## Do que precisa

- Notas não precisam de sincronização, chaves nem rede: são arquivos comuns na pasta. Cada resposta diz se a pasta está sendo sincronizada, e quando foi pela última vez.
- Bancos de dados precisam deste computador conectado com niv sign-in. Cada ferramenta de banco de dados recebe o Space, por nome ou id.
- Não faz nada até uma ferramenta ser chamada, e termina quando o app o fecha. Vários podem rodar, ao lado do niv sync e do app.

Mais na documentação: [Niv Docs](https://niv.md/docs).

---

Mais: [Niv](https://niv.md/pt-br) · [Sobre](https://niv.md/pt-br/about) · [Contato](https://niv.md/pt-br/contact) · [Privacidade](https://niv.md/pt-br/privacy) · [Criptografia](https://niv.md/pt-br/encryption) · [Termos](https://niv.md/pt-br/terms) · [llms.txt](https://niv.md/llms.txt) · [English](https://niv.md/mcp)
