Conectando o Código Claude ao Seu Vault Obsidian via MCP

Toda vez que você inicia uma nova sessão do Claude Code, você começa do zero. Seu agente lê os arquivos que você aponta — e nada mais. Se suas notas de projeto, ADRs e listas de tarefas estão no Obsidian, seu agente não tem ideia de que elas existem.

Este tutorial conecta o Claude Code diretamente ao seu cofre do Obsidian. Após a configuração, seu agente pode ler suas notas existentes, criar novas e escrever resumos de sessão que persistem entre execuções — tudo isso sem que você precise copiar nada manualmente.

Como funciona

Team Relay é um servidor auto-hospedado que sincroniza seu cofre do Obsidian em tempo real via Yjs CRDTs. O pacote evc-team-relay-mcp envolve sua API REST como ferramentas MCP — assim, qualquer agente compatível com MCP (Claude Code, Codex CLI, OpenCode) pode chamar read_file e upsert_file no seu cofre.

Claude Code - MCP ->  evc-team-relay-mcp - REST -> Team Relay - Yjs -> Obsidian

As mudanças aparecem no Obsidian instantaneamente. As notas que você cria a partir do Claude aparecem na sua barra lateral em segundos.

Passo 1 — Execute o backend do Team Relay

Opção A: auto-hospedado (Docker)

git clone https://github.com/entire-vc/evc-team-relay.git
cd evc-team-relay
cp .env.example .env        # edite: defina RELAY_SECRET, caminho do DB, etc.
docker compose up -d

O plano de controle é executado na porta 8888 por padrão. Crie uma conta de usuário via a interface web em http://localhost:8888.

Opção B: hospedado

Se você preferir pular a parte operacional, uma instância hospedada está disponível em entire.vc. Crie uma conta lá e pule a etapa do Docker. De qualquer forma, você terminará com uma URL do plano de controle, e-mail e senha — isso é tudo que o servidor MCP precisa.

Passo 2 — Compartilhe sua pasta do cofre

No Obsidian, abra as configurações do plugin Team Relay e crie um compartilhamento de pasta para a pasta do cofre que você deseja que o agente acesse. Copie o ID de compartilhamento — você precisará dele em um momento.

Se você ainda não instalou o plugin do Obsidian: evc-team-relay-obsidian-plugin

Passo 3 — Configure o Claude Code

Crie ou edite .mcp.json na raiz do seu projeto (ou ~/.claude/.mcp.json para acesso global):

{
  "mcpServers": {
    "evc-relay": {
      "command": "uvx",
      "args": ["evc-team-relay-mcp"],
      "env": {
        "RELAY_CP_URL": "https://cp.seudominio.com",
        "RELAY_EMAIL": "seu@email.com",
        "RELAY_PASSWORD": "sua-senha"
      }
    }
  }
}

Nenhuma etapa de instalação necessária — uvx baixa o pacote do PyPI na primeira execução. Reinicie o Claude Code e as ferramentas evc-relay aparecerão.

Passo 4 — Experimente

Aqui estão três prompts que demonstram o agente trabalhando com seu cofre. Substitua <share_id> pelo UUID do Passo 2.

Prompt 1: descubra o que há no cofre

Liste os arquivos no meu compartilhamento do Obsidian <share_id> e me diga quais parecem notas de projeto ou listas de tarefas.

Claude chama list_shares, depois list_files, e retorna um resumo da estrutura do seu cofre. Ele ainda não lê nenhum conteúdo — apenas a
árvore de arquivos.

Prompt 2: leia o contexto existente

Leia "Projects/active-sprint.md" do compartilhamento <share_id> e resuma o que está em andamento.

Claude chama read_file com file_path="Projects/active-sprint.md"
e retorna um resumo. O conteúdo do arquivo é puxado ao vivo do seu cofre — se você o editou no Obsidian cinco segundos atrás, o agente vê a versão mais recente.

Prompt 3: escreva um resumo da sessão

Com base no que fizemos nesta sessão, crie um registro de sessão em "AI-sessions/2026-05-15.md" no compartilhamento <share_id>. Inclua: o que mudamos, quaisquer perguntas em aberto e próximos passos.

Claude chama upsert_file. Se o arquivo não existir, ele o cria. Se existir, ele atualiza no local. Abra o Obsidian — a nota aparece na sua barra lateral em poucos segundos.

Referência de ferramentas

O fluxo típico é: list_shares → list_files → read_file /
upsert_file. A autenticação é automática — você nunca passa tokens para
o agente manualmente.

Algumas coisas que vale a pena saber

Nada é executado no shell. Todas as operações são chamadas de função Python sobre JSON-RPC. Credenciais são variáveis de ambiente, nunca argumentos de CLI. Não há superfície de injeção de comando.

O agente não vê todo o seu cofre por padrão. Ele