Melhor servidor MCP do Obsidian para o Claude: configuração e opções

O Claude é muito inteligente, mas nunca viu as suas notas. Pergunte sobre as anotações da reunião do último trimestre ou sobre o ensaio meio escrito que está perdido no seu cofre, e ele só consegue adivinhar. Um servidor MCP do Obsidian fecha essa lacuna. Ele abre uma porta controlada para os seus arquivos markdown, para que o Claude possa pesquisar, ler e escrever notas enquanto você continua no controle do que ele mexe.

A dificuldade está na escolha. Existem mais de uma dúzia de servidores, e os nomes dos pacotes, os plugins e as portas mudaram bastante durante 2026. Este artigo mostra qual servidor merece o seu tempo, percorre a configuração exata para o Claude Desktop e o Claude Code e aponta os erros que desperdiçam uma tarde inteira. A resposta curta: escolha o mcpvault para começar rápido, sem plugin, e passe para um servidor baseado em REST, como o obsidian-mcp-server da cyanheads, quando quiser o próprio Obsidian no fluxo.

💡 Veredito rápido: Não precisa de plugin nem de app em execução? Use um servidor de sistema de arquivos. Quer a nota ativa, comandos e notas periódicas? Use um servidor Local REST API.

O que um servidor MCP do Obsidian faz

MCP significa Model Context Protocol, o padrão aberto que a Anthropic apresentou para que apps de IA acessem ferramentas externas por meio de pequenos programas chamados servidores. Um servidor MCP do Obsidian é um desses programas. Ele fica entre o Claude e o seu cofre, uma pasta simples de arquivos markdown, e expõe uma lista curta de ferramentas: listar arquivos, ler uma nota, pesquisar, anexar texto, editar uma seção e, em alguns servidores, mover ou excluir notas.

Como o Claude lê o seu cofre

Quando você faz uma pergunta, o Claude decide se uma chamada de ferramenta ajudaria. Digite "encontre minhas notas sobre o experimento de preços" e ele chama a ferramenta de pesquisa, recebe caminhos de arquivos e trechos, e depois chama a ferramenta de leitura nos melhores resultados. O servidor roda na sua própria máquina, e o Claude Desktop pede a sua aprovação antes de usar uma ferramenta.

Um ponto para ter em mente: qualquer nota que o Claude lê passa a fazer parte da conversa, o que significa que esse texto é enviado à Anthropic para processamento. Mantenha fora da pasta exposta qualquer material realmente privado.

Sistema de arquivos ou Local REST API

Todo servidor do Obsidian se encaixa em um de dois modelos, e essa escolha define todo o resto:

• Servidores de sistema de arquivos leem e escrevem os arquivos .md diretamente. Precisam apenas do caminho do cofre, funcionam com o Obsidian fechado e se instalam em uma linha. Não conseguem ver o estado ao vivo do Obsidian, como qual nota está aberta.
• Servidores Local REST API conversam com o Obsidian por meio do plugin da comunidade chamado Local REST API. Eles conseguem acessar a nota ativa, executar comandos do Obsidian e usar notas periódicas, mas o Obsidian precisa estar em execução e você precisa informar um token gerado pelo plugin.

Os melhores servidores comparados

As listagens de diretório mudam toda semana, então deixo de lado a contagem de estrelas e comparo o que realmente afeta a sua configuração. Leia o README de cada projeto antes de copiar um comando, porque vários projetos renomearam pacotes ou lançaram versões com mudanças incompatíveis neste ano.

Lado a lado

💡 Armadilha do nome: o pacote npm que antes se chamava mcp-obsidian foi renomeado para @bitbonsai/mcpvault no início de 2026. Tutoriais antigos que usam o nome antigo podem levar você ao pacote errado, então copie os nomes do README atual.

mcpvault para configuração fácil

O mcpvault é o caminho mais curto do zero até uma conexão funcionando com o cofre. Você passa um argumento, o caminho do cofre, e ele lê os arquivos diretamente. Se omitir o caminho, ele usa o diretório de trabalho atual, o que é prático quando você abre o Claude Code de dentro do cofre. Suas ferramentas cuidam de leitura e escrita de notas, edições do tipo patch, pesquisa, frontmatter e tags, embora o README tenha a lista atualizada.

Como ele nunca toca na API do próprio Obsidian, o app pode continuar fechado, e ele continua rápido em um cofre com milhares de notas. A contrapartida é que não consegue executar comandos do Obsidian nem saber qual nota você está olhando.

cyanheads para uso intenso

O obsidian-mcp-server da cyanheads é escrito em TypeScript e se conecta pelo plugin Local REST API. Ele teve o maior número de downloads semanais no npm entre as listagens que consultei, e uma versão recente o adaptou para a versão 4 do plugin. O README lista pesquisa global, busca e substituição dentro de uma nota e gerenciamento de frontmatter e tags.

Escolha-o quando o Claude for um parceiro diário, e não um experimento. Você paga por essa profundidade com mais um componente que pode dar defeito: o plugin, o token dele e uma janela do Obsidian aberta.

Servidores REST para recursos ao vivo

O mcp-obsidian de MarkusPfundstein é a opção em Python. Você o inicia com uvx, e ele se comunica com o plugin em 127.0.0.1 pela porta HTTPS 27124. Suas ferramentas incluem pesquisa, anexação de texto a uma nota e edição de conteúdo sob um cabeçalho específico. O projeto ficou parado por um bom tempo antes de o mantenedor voltar em maio de 2026, então verifique os commits recentes antes de se comprometer com ele.

Mais dois merecem uma olhada. O Obsidian MCP Tools se instala de dentro do Obsidian e adiciona pesquisa semântica pelo Smart Connections, além de suporte ao Templater. E as versões mais novas do próprio Local REST API trazem um endpoint MCP integrado, o que significa que talvez você consiga apontar o Claude direto para o plugin, sem nenhum programa Node ou Python no meio. Confira as notas de lançamento do plugin para ver o endereço exato.

Minha escolha por situação:

1. Quer funcionando em cinco minutos: mcpvault.
2. Usa o Obsidian o dia todo e quer ferramentas ricas: cyanheads.
3. Já trabalha com ferramentas em Python: mcp-obsidian.
4. Quer o menor número de programas instalados: o endpoint integrado do plugin, se a sua versão tiver.

Configuração no Claude Desktop

Antes de mexer em qualquer configuração, verifique três coisas. O Node.js (LTS atual) está instalado, se você pretende usar um servidor npx, ou uv, se pretende usar uvx. O Claude Desktop está instalado e com login feito. E você conhece o caminho absoluto do seu cofre, por exemplo /Users/you/Documents/MyVault ou C:\Users\you\Documents\MyVault.

Para um servidor REST, você também precisa do plugin. No Obsidian, abra Configurações, Plugins da comunidade, Navegar, pesquise por Local REST API, instale e ative, e depois copie o token exibido na página de configurações do plugin. O plugin escuta na porta HTTPS 27124 com um certificado autoassinado. Existe uma porta HTTP, a 27123, mas ela vem desativada por padrão.

Edite o arquivo de configuração

No Claude Desktop, abra Configurações, depois Desenvolvedor e depois Editar configuração. Isso abre claude_desktop_config.json, que fica em ~/Library/Application Support/Claude/ no macOS e em %APPDATA%\Claude\ no Windows. Adicione o mcpvault assim:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["@bitbonsai/mcpvault@latest", "/Users/you/Documents/MyVault"]
    }
  }
}

Copiar prompt

No Windows, duplique as barras invertidas no caminho: "C:\\Users\\you\\Documents\\MyVault". Salve o arquivo, depois feche o Claude Desktop por completo (pela barra de menus ou pela bandeja do sistema, não apenas pela janela) e abra de novo. O ícone de ferramentas na caixa de chat deve listar agora as ferramentas do Obsidian.

💡 Dica sobre o PATH: o Claude Desktop não herda o PATH do seu shell. Se o servidor não iniciar, substitua npx pelo caminho absoluto exibido por which npx no macOS ou where npx no Windows.

Conecte um servidor REST

Um servidor REST usa o mesmo arquivo com uma entrada diferente. Este é o formato do mcp-obsidian:

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124"
      }
    }
  }
}

Copiar prompt

Adicione mais uma entrada a esse bloco env: o token do seu plugin, com o nome exato da variável que o README do servidor lista. Os nomes mudam de projeto para projeto, por isso não vou chutar um aqui. Mantenha o Obsidian aberto enquanto conversa, porque o servidor acessa o cofre pelo plugin.

Configuração no Claude Code

O Claude Code adiciona servidores pelo terminal, sem editar JSON.

Instalação com um comando

Para o mcpvault:

claude mcp add obsidian --scope user -- npx @bitbonsai/mcpvault@latest /path/to/vault

Copiar prompt

A flag --scope user torna o servidor disponível em todos os projetos. O escopo local padrão o limita ao projeto atual, e o escopo de projeto grava um arquivo .mcp.json que você pode acabar versionando no git. Nunca coloque um token em um .mcp.json compartilhado.

Para um servidor REST, passe os valores de ambiente com -e:

claude mcp add obsidian --scope user -e OBSIDIAN_HOST=127.0.0.1 -e OBSIDIAN_PORT=27124 -- uvx mcp-obsidian

Copiar prompt

Adicione o token do plugin da mesma forma, usando o nome da variável indicado no README.

Verifique e teste com prompts

Execute claude mcp list para ver se o servidor aparece como conectado, ou digite /mcp dentro de uma sessão. Depois teste prompts que comprovem que cada ferramenta funciona:

• "Liste as dez notas alteradas mais recentemente e resuma cada uma em uma linha."
• "Pesquise notas que mencionem o experimento de preços e escreva uma atualização de status com base nelas."
• "Anexe as três decisões de hoje à minha nota diária, sob um cabeçalho chamado Decisões."
• "Encontre notas que mencionem uma pessoa pelo nome, mas que nunca linkem para a página dela."

Equipes podem compartilhar um cofre por meio de uma pasta sincronizada, e cada pessoa adiciona o servidor na própria máquina. Limite o acesso de escrita às pessoas que realmente precisam dele.

Hábitos seguros antes do acesso de escrita

Acesso de leitura tem pouco risco. Acesso de escrita tem risco alto, porque uma única instrução mal interpretada pode sobrescrever uma nota ou apagar um arquivo. Alguns hábitos eliminam a maior parte do perigo.

Faça backup primeiro

Transforme o cofre em um repositório git com o plugin Obsidian Git, ou confirme que o histórico de versões do Obsidian Sync está ativado, ou pelo menos copie a pasta para um segundo disco. Depois teste uma restauração uma vez. Um backup que você nunca restaurou é uma esperança, não um backup.

Aprove as ferramentas de escrita e exclusão uma chamada por vez até confiar no comportamento. Leia a alteração proposta antes de clicar em Permitir.

Limite o que o Claude acessa

Servidores de sistema de arquivos aceitam qualquer caminho de pasta, então aponte-os para uma subpasta dedicada, e não para o cofre inteiro. Mantenha diários e rascunhos privados fora dela. Guarde tokens somente na sua configuração local, nunca em um repositório.

Como corrigir falhas comuns de configuração

A maioria das primeiras tentativas falha por motivos banais. Percorra estes itens na ordem.

O servidor aparece com falha

• Node ou uv ausente. Execute node --version ou uv --version em um terminal.
• PATH errado. Use o caminho absoluto até npx ou uvx na configuração.
• Nome de pacote antigo. Troque mcp-obsidian no npm por @bitbonsai/mcpvault.
• JSON quebrado. Procure por uma vírgula sobrando, uma aspa faltando ou barras invertidas simples em um caminho do Windows.
• App desatualizado. Feche o Claude Desktop por completo e abra de novo.

Se nada ajudar, abra os arquivos de log do MCP. No macOS eles ficam em ~/Library/Logs/Claude/, e no Windows em %APPDATA%\Claude\logs. As últimas linhas costumam indicar o problema exato.

Erros de porta e certificado

Servidores REST têm falhas próprias. O Obsidian precisa estar em execução com o plugin ativado. Uma resposta 401 ou 403 significa que o token não corresponde, então copie-o de novo, sem espaço no final. Um erro de certificado na porta 27124 vem do certificado autoassinado do plugin: siga o README do servidor para confiar nele, ou ative a porta HTTP 27123 nas configurações do plugin e use-a somente em localhost. Se outro programa estiver usando a porta, altere-a no plugin e no bloco env ao mesmo tempo.

Rascunhe notas com o Claude no PicassoIA

O MCP funciona dentro do Claude Desktop e do Claude Code, então uma ferramenta de navegador não pode substituí-lo. O que o PicassoIA acrescenta é a outra metade do trabalho: rascunhar e limpar o texto antes que ele chegue ao seu cofre, sem nada para instalar. O Claude Sonnet 5 é uma boa escolha, e o Claude Opus 4.7 e o Claude 4.5 Haiku cuidam de tarefas mais pesadas e mais leves.

Como usar o Claude Sonnet 5 no PicassoIA:

1. Abra a página do Claude Sonnet 5.
2. Cole o seu material bruto em Prompt: uma transcrição solta, tópicos desorganizados ou um despejo de pesquisa confuso. Depois informe o formato de nota que você quer.
3. Preencha System Prompt uma vez com as convenções do seu cofre, como frontmatter em YAML, wikilinks para pessoas e o seu estilo de cabeçalhos.
4. Escolha um nível de Effort e execute.
5. Copie o resultado para o Obsidian, ou passe para o seu Claude conectado ao MCP arquivar na pasta certa.

💡 O campo de imagem é útil para pesquisa: fotografe um quadro branco, deixe o Claude transformá-lo em uma nota estruturada e arquive-a no seu cofre.

Crie suas próprias imagens no Picasso IA

Um cofre cheio de texto fica mais fácil de percorrer quando as notas trazem uma imagem. Uma foto de cabeçalho para a nota de um projeto, um painel de referências para um briefing de design, uma cena fotorrealista para o rascunho de uma história: cada uma exige um prompt curto e alguns segundos no Picasso IA.

Experimente o Seedream 4.5 para cenas detalhadas e polidas, o GPT Image 2 quando o prompt for longo e específico, o FLUX 2 Pro para fotografia realista e nítida, ou o P-Image quando quiser resultados rápidos. Descreva o assunto, a luz e a lente, e mantenha o texto tão concreto quanto a lista de tomadas de um fotógrafo.

Configure o seu servidor MCP do Obsidian esta semana, depois abra o Picasso IA e crie a primeira imagem para o seu próprio cofre. Teste alguns prompts, guarde os que combinam com as suas notas e construa um hábito visual junto com o escrito.