Setup MCP Vault
Conecta teu editor ao Kodama Vault via MCP (Model Context Protocol) — leitura/escrita de notas direto do agente de IA.
Setup MCP Vault
Conecta teu agente de IA ao conteúdo do vault via MCP (Model Context Protocol). Com MCP configurado, o agente lê, cria e edita notas em brain/ direto do teu editor — sem copy-paste.
O que é
O MCP vault é um servidor filesystem que expõe o diretório local do vault (kodama-vault/) pro agente. Ele usa o pacote oficial @modelcontextprotocol/server-filesystem.
- Escopo: filesystem local — cada pessoa clona o repo e aponta o MCP pro seu path
- Permissões: leitura e escrita dentro do path permitido (confinado ao clone local)
- Sync: commits vão via git pra
github.com/kodama1/vault, deploy atualizavault.kodama.solutions
Pré-requisitos
- Node.js 20+ instalado (
node -v) - Git instalado e autenticado no GitHub
- Acesso ao repo
kodama1/vault(pede pro admin) - Clone local:
Windows:git clone git@github.com:kodama1/vault.git ~/kodama-vaultC:\Users\<user>\kodama-vault
Escolhe teu cliente
- setup/claude-code — Claude Code CLI (terminal/IDE)
- setup/claude-desktop-mcp — Claude Desktop (app oficial Anthropic)
- setup/vscode-copilot — VS Code + GitHub Copilot
Depois de configurar
- Abre o cliente, pergunta: "lista o conteúdo de brain/"
- Deve retornar a estrutura de pastas do vault
- Edição: peça pra criar/editar qualquer
.mdembrain/ - Commit: o agente pode rodar
git add/commit/pushou tu faz manual
Troubleshooting
- Permission denied: confirma que o path do clone está correto e Node 20+ ativo
- Tool not available: reinicia o editor após adicionar MCP
- Conflitos git: faz
git pull --rebaseantes de editar (Stop hook do admin faz auto-sync)