Como conectar o Obsidian ao YouMind com MCP
Seu cofre do Obsidian pode já conter tudo o que você precisa para o seu próximo projeto: pesquisas, planos, anotações de leitura e tarefas inacabadas. Conectá-lo ao YouMind permite que você transforme essas anotações em algo utilizável, com uma solicitação em linguagem natural.
Neste guia, você conectará um cofre local do Obsidian ao YouMind, pedirá ao YouMind para ler e organizar um conjunto de anotações e salvará o resultado de volta no Obsidian. O exemplo usa cinco anotações sobre alimentação anti-inflamatória para criar um plano de ação com links para as fontes originais.
Antes de começar
Você vai precisar de:
- A versão desktop do Obsidian e um cofre que você possa editar.
- Uma conta do YouMind com acesso a conectores personalizados.
- Uma conta do ngrok. Usaremos o ngrok para dar ao seu servidor MCP local um endereço HTTPS que o YouMind possa alcançar.
- Algumas anotações para trabalhar. Você pode usar suas próprias pesquisas, anotações de projeto ou anotações de planejamento de refeições.
A conexão funciona assim:
YouMind → endereço HTTPS do ngrok → Conector MCP → seu cofre do Obsidian
MCP, sigla para Model Context Protocol (Protocolo de Contexto de Modelo), permite que um aplicativo de IA use ferramentas fornecidas por outro aplicativo. O plugin do Obsidian expõe ferramentas para trabalhar com seu cofre, e o YouMind as utiliza para executar sua solicitação.
Mantenha seu computador ligado e conectado à internet, com o Obsidian, o cofre conectado e o ngrok em execução sempre que usar esta conexão. O endereço local 127.0.0.1 aponta apenas para o seu próprio computador, então o YouMind precisa do endereço do ngrok para alcançá-lo.
O conector pode ler ou alterar anotações de acordo com as permissões que você conceder. Mantenha seu token privado e use as permissões de ferramentas do plugin e as configurações de pasta oculta para controlar o acesso. O conteúdo usado em uma tarefa passa pelo ngrok e pelo YouMind; conectar um cofre não sincroniza automaticamente todo o cofre.
As capturas de tela mostram o fluxo de trabalho no macOS. Alguns detalhes da conta foram removidos ou substituídos por valores de exemplo.
1. Permitir plugins da comunidade no Obsidian
Abra Configurações → Plugins da comunidade no Obsidian.
Se o seu cofre estiver no modo Restrito, clique em Sair do modo Restrito para permitir plugins da comunidade.
Clique em Navegar para abrir o diretório de plugins da comunidade.
2. Instalar e habilitar o MCP Connector
Pesquise por MCP Connector e selecione o plugin do istefox. Verifique o nome do autor, pois o diretório inclui plugins com nomes semelhantes.
Abra os detalhes e clique em Instalar.
Após a instalação, clique em Habilitar.
Abra o MCP Connector nas configurações do Obsidian para configurar seu servidor local e token de acesso. Você pode encontrar mais informações na página do diretório do plugin.
3. Definir uma porta de servidor fixa
Encontre Porta fixa, digite 27200 e clique em Salvar.
A seção Porta do servidor agora deve mostrar:
http://127.0.0.1:27200/mcp
Uma porta fixa mantém sua conexão ngrok apontando para o mesmo serviço local. Se a porta 27200 já estiver em uso, escolha uma porta disponível e use esse número no comando ngrok abaixo.
4. Criar um token para o YouMind
Em Controle de Acesso, clique em Adicionar token.
Nomeie o novo token como YouMind para que você possa reconhecê-lo mais tarde.
Clique em Copiar na linha desse token. Você o colará no YouMind em uma etapa posterior.
Cada token pode ter suas próprias permissões de ferramenta. Este exemplo precisa de permissão para ler anotações e criar uma nova anotação. As capturas de tela usam a configuração Todas as 52 ferramentas do plugin; o número de ferramentas disponíveis pode mudar com a versão do plugin e suas configurações.
Trate o token como uma senha para o acesso que ele concede. Você não precisa colá-lo em um chat de IA.
5. Iniciar um túnel ngrok
Se você ainda não instalou o ngrok, siga as instruções oficiais de configuração. No macOS, se você já usa o Homebrew, instale-o com:
brew install ngrok
Adicione o authtoken do seu painel do ngrok:
ngrok config add-authtoken SEU_NGROK_AUTHTOKEN
O authtoken do ngrok conecta o ngrok à sua conta. O token do Obsidian da etapa anterior dá ao YouMind acesso ao seu cofre. Mantenha essas duas credenciais separadas.
No Terminal, execute:
ngrok httphttp://127.0.0.1:27200
Mantenha esta sessão do terminal em execução. Quando o Status da Sessão mostrar online, copie o endereço HTTPS mostrado na linha Encaminhamento.
Adicione /mcp ao final desse endereço. Sua URL final do conector deve ter esta estrutura:
https://SEU_DOMINIO_NGROK/mcp
Use o domínio real mostrado em sua própria sessão do ngrok. O domínio na captura de tela é um exemplo. Se o seu endereço de encaminhamento mudar posteriormente, atualize também o endereço salvo no YouMind.
6. Adicionar o conector personalizado no YouMind
No YouMind, abra Configurações → Conectores e clique em Adicionar conector personalizado.
Digite um nome, como obsidian, e cole seu endereço ngrok com /mcp no final. Expanda Configurações avançadas. Em Parâmetros personalizados, clique em Adicionar parâmetro e configure o seguinte:
Configuração | Valor |
|---|---|
Nome |
|
URL do Servidor | Seu endereço HTTPS do ngrok, seguido por |
ID do Cliente OAuth | Deixe em branco |
Segredo do Cliente OAuth | Deixe em branco |
Parâmetro personalizado |
|
Valor do parâmetro |
|
Secreto | Ativado |
Substitua SEU_TOKEN_OBSIDIAN pelo token completo que você copiou do Obsidian. Inclua um espaço após **Bearer**. Por exemplo, se seu token fosse token-exemplo, o valor seria:
Bearer token-exemplo
Este é apenas um exemplo de formato. Use seu próprio token na configuração real. Esta conexão usa autenticação Bearer Token, portanto, deixe os dois campos OAuth em branco.
Clique em Adicionar, então encontre obsidian na lista de conectores e clique em Conectar.
Você deve ver Conectado ao lado do nome.
Agora vamos verificar a conexão com uma tarefa que lê anotações e escreve uma nova.
7. Preparar algumas anotações relacionadas
O YouMind precisa de conteúdo real para trabalhar. Para este exemplo, o cofre contém cinco anotações em inglês:
Anotação | O que contém |
|---|---|
Noções Básicas de Alimentação Anti-inflamatória | Princípios gerais de alimentação e metas para a primeira semana |
Lista de Compras Anti-inflamatória | Uma lista de compras e substituições de ingredientes |
Plano Alimentar Anti-inflamatório de 7 Dias | Uma semana de cafés da manhã, almoços e jantares |
Preparo Simples de Refeições Anti-inflamatórias | Etapas de preparo, receitas simples e notas de armazenamento |
Revisão Semanal Anti-inflamatória | Um modelo de revisão e tarefas de acompanhamento não concluídas |
Estas anotações são material de amostra para demonstrar o fluxo de trabalho. Elas não constituem um plano médico ou nutricional personalizado.
Você pode usar um tópico diferente. Por exemplo, combine anotações de leitura em um guia de estudo, transforme anotações de projeto em uma lista de próximos passos ou organize pesquisas de viagem em um itinerário. Atualize o tópico no prompt para corresponder às anotações em seu cofre.
8. Peça ao YouMind para ler, organizar e salvar
Inicie uma nova tarefa no YouMind e digite:
Revise minhas anotações do Obsidian sobre alimentação anti-inflamatória. Resuma os princípios-chave, conecte a lista de compras com o plano alimentar e identifique três tarefas pendentes.
Salve o resultado em inglês como uma nova anotação no Obsidian intitulada "Plano de Ação para Alimentação Anti-inflamatória", com links internos para as anotações de origem.
O prompt diz ao YouMind quais anotações ler, como organizar as informações, quais tarefas identificar e onde salvar o resultado. Ele também nomeia a nova anotação e pede links para as fontes, tornando a saída fácil de verificar.
Envie a tarefa. O YouMind usará o conector para encontrar e ler as anotações relevantes e, em seguida, montará o resultado. Você pode acompanhar o progresso na conversa.
9. Abrir a nova anotação no Obsidian
Neste exemplo, o YouMind retornou:
- Um resumo dos princípios na anotação introdutória.
- Conexões entre a lista de compras e o plano alimentar, incluindo quais ingredientes aparecem em várias refeições.
- Três tarefas pendentes: planejar a ida ao supermercado, escolher almoços e sessões de preparo, e completar a revisão depois.
- Uma nova anotação intitulada Plano de Ação para Alimentação Anti-inflamatória, com links internos para as cinco anotações originais.
Todas as tarefas concluídas refere-se à tarefa de leitura, organização e escrita do YouMind. As compras e o preparo das refeições permanecem como ações de acompanhamento para a pessoa que está usando o plano.
Volte para o Obsidian e abra Plano de Ação para Alimentação Anti-inflamatória.
A nova anotação aparece na lista de arquivos e seu conteúdo está salvo em seu cofre. Nesta execução, ela também inclui tags e links clicáveis para as anotações originais. A visualização em gráfico mostra essas conexões junto com as anotações existentes.
Agora você pode continuar editando no Obsidian ou pedir ao YouMind para continuar com uma solicitação mais específica, como expandir uma seção ou atualizar o plano usando outra anotação.
Solução de problemas
Por que vejo 401 Não Autorizado?
Verifique o parâmetro Authorization. Seu valor deve ser Bearer, seguido por um espaço e seu token completo do Obsidian. Certifique-se de ter copiado o token do MCP Connector. Se você o regenerou ou revogou, atualize o valor no YouMind.
Por que vejo "Falha na descoberta do metadados do servidor de autorização OAuth (404)"?
Uma verificação de token mal-sucedida pode fazer com que o cliente tente a descoberta OAuth. Esta conexão de plugin usa um Bearer Token, então primeiro verifique o cabeçalho Authorization e mantenha os campos ID do Cliente OAuth e Segredo do Cliente OAuth em branco. Um prefixo Bearer ausente pode produzir este erro.
Por que abrir a URL /mcp no navegador retorna 405?
O endpoint MCP do plugin aceita solicitações MCP através de POST. Abrir uma URL na barra de endereços do navegador normalmente envia GET, o que pode retornar 405 Método Não Permitido. Verifique a conexão através do YouMind e de uma tarefa real.
Por que uma conexão que funcionava parou de responder?
Verifique se seu computador está ligado e online, se o Obsidian tem o cofre correto aberto, se o plugin está habilitado e se o ngrok ainda mostra online. Em seguida, compare a porta local e a URL do ngrok com os valores salvos no YouMind.
E se eu não conseguir encontrar a nova anotação?
Pesquise no cofre conectado pelo título que você especificou no prompt. Verifique se o token permite criar anotações. Você também pode pedir ao YouMind o caminho exato relativo ao cofre do arquivo que ele criou e, em seguida, abrir esse caminho no Obsidian.
Pronto para testar com suas próprias anotações? Abra o YouMind e peça para transformar algumas anotações relacionadas em uma nova página útil em seu cofre.