Synapse

Taproot

Suas notas. A memória da sua IA.

Servidor MCP que conecta qualquer cliente de IA — Claude, ChatGPT, Cursor, Windsurf — ao seu cofre Obsidian. Salve qualquer coisa de qualquer lugar, faça perguntas em suas notas, mantenha a base de conhecimento que sua IA lê.

Configuração em 30 Segundos

Claude Desktop

1. Abra a configuração: Mac ~/Library/Application Support/Claude/claude_desktop_config.json | Windows %APPDATA%\Claude\claude_desktop_config.json
2. Adicione o Taproot ao objeto mcpServers:

{
  "mcpServers": {
    "taproot": {
      "command": "npx",
      "args": ["-y", "synapse-obsidian", "/path/to/your/obsidian-vault"]
    }
  }
}

3. Reinicie o Claude Desktop. As ferramentas do Taproot aparecem automaticamente.

Claude Code

Adicione ao .claude/.mcp.json no seu diretório inicial:

{
  "mcpServers": {
    "taproot": {
      "command": "npx",
      "args": ["-y", "synapse-obsidian", "/path/to/your/vault"]
    }
  }
}

Claude.ai / ChatGPT / Qualquer IA remota

Execute o Taproot localmente e exponha-o com um túnel gratuito:

# Terminal 1: Start Taproot
npx synapse-obsidian /path/to/vault --http --port 3777

# Terminal 2: Expose it (free, no account needed)
npx cloudflared tunnel --url http://localhost:3777

Copie a URL do túnel. Adicione https://your-tunnel-url.trycloudflare.com/mcp como uma integração MCP personalizada no seu cliente de IA.

Primeiros Passos

Depois de conectado, diga:

"Ajude-me a começar com o Taproot"

O Taproot examina seu cofre e oferece três opções:

• Usar meu cofre existente — Detecta sua estrutura de pastas, wikilinks, convenções de nomenclatura. Nada é movido ou sobrescrito. O Taproot se adapta a você.
• Configurar uma base de conhecimento — Cria pastas organizadas: sources/ para conteúdo bruto, notes/ para conhecimento compilado, outputs/ para resultados de consulta. Melhor para um tópico de pesquisa focado.
• Personalizado — Você diz ao Taproot como deseja que as coisas sejam organizadas.

Ele também pergunta para que você usará o cofre (pesquisa, negócios, acadêmico, sistema de vida) para que possa adaptar a experiência.

O Que Você Pode Fazer

Salve qualquer coisa, de qualquer lugar

"Salve este artigo: https://example.com/interesting-post"

Busca a página, converte para markdown, salva no seu cofre. Funciona a partir do seu telefone.

Faça perguntas em suas notas

"O que minhas notas dizem sobre estratégia de preços?"

Pesquisa em seu cofre, lê arquivos relevantes, sintetiza uma resposta citada.

Construa uma wiki composta

"Processe todos os novos artigos no meu cofre"

Transforma fontes brutas em resumos, páginas de conceito, páginas de entidades — todas interligadas com wikilinks. Cada resposta alimenta a base de conhecimento.

Verificação de saúde das suas notas

"Execute uma verificação de saúde no meu cofre"

Encontra links quebrados, páginas órfãs, frontmatter ausente, conteúdo desatualizado. Corrige o que pode.

Todas as Ferramentas

Ferramenta	O que faz
taproot_plant	Onboarding — examina o cofre, apresenta opções, configura o Taproot
taproot_till	Salva suas preferências do cofre
taproot_seed	Salva conteúdo de uma URL ou texto colado
taproot_status	Visão geral completa do cofre com ações sugeridas
taproot_water	Processa uma fonte em páginas organizadas
taproot_cultivate	Encontra e processa todas as fontes não processadas
taproot_harvest	Pesquisa uma pergunta em sua base de conhecimento
taproot_prune	Verificação de saúde para links quebrados, órfãos, lacunas
taproot_sow	Cria uma nova base de conhecimento do zero
garden_read	Lê qualquer arquivo
garden_plant	Cria ou atualiza qualquer arquivo
garden_survey	Lista arquivos no cofre ou subdiretório
garden_forage	Pesquisa de texto completo
garden_measure	Contagens de arquivos e estrutura
garden_tag	Lê metadados YAML de um arquivo

Como Funciona

O Taproot é um servidor MCP — um protocolo aberto para conectar IA a ferramentas e dados. Ele dá ao seu IA acesso de leitura/escrita ao seu cofre (e nada mais — isolado ao diretório do cofre).

• Stdio (padrão) — Para aplicativos de IA de desktop (Claude Desktop, etc.)
• HTTP (--http) — Para IA baseada em navegador (Claude.ai, ChatGPT, etc.) atrás do Tailscale ou outro túnel

Seu cofre é apenas uma pasta de arquivos markdown. O Taproot não precisa que o Obsidian esteja em execução — funciona com qualquer pasta.

Requisitos

• Node.js 18+ (verifique com node -v)
• Um cofre Obsidian ou qualquer pasta de arquivos markdown
• Qualquer cliente de IA compatível com MCP

Licença

MIT — Taproot