Claudesidian MCP

Nexus MCP para Obsidian

O Nexus dá a agentes de IA e ao chat integrado acesso ao seu cofre do Obsidian para que você possa ler, escrever, pesquisar, organizar e automatizar notas em linguagem natural, mantendo o armazenamento local ao cofre.

O Nexus pode ser usado de duas maneiras:

• Dentro do Obsidian com chat nativo (conecte-se ao seu provedor ou plataforma agêntica favorita!)
• De agentes externos como Claude Desktop, Claude Code, Codex CLI, Gemini CLI, Cursor, Cline e outros clientes MCP

O Nexus é o sucessor do Claudesidian. Instalações legadas em .obsidian/plugins/claudesidian-mcp/ ainda funcionam.

Configuração

• Instale a versão mais recente em GitHub Releases: manifest.json, styles.css e main.js
• Coloque-os em .obsidian/plugins/nexus/ e habilite o Nexus no Obsidian
• Chat nativo no Obsidian: Configuração do provedor e Guia de chat nativo para chat, voz ao vivo, leitura em voz alta e geração integrada de áudio/vídeo
• Agente externo via MCP: use Configurações do Nexus -> Começar -> Agentes externos para criar connector.js e atualizar o Claude Desktop, depois veja Guia de configuração MCP e Prompt de sistema recomendado
• Agente externo via CLI (sem configuração MCP): instale o comando nexus em Começar -> Agentes externos -> CLI local para que agentes de shell (Claude Code, Cursor, Codex) possam operar seu cofre diretamente — veja o Guia do Nexus CLI. A instalação é acionada pelo usuário, grava apenas fora do cofre e, no Windows, adiciona o diretório do Nexus ao PATH do usuário atual sem direitos de administrador; a desinstalação remove apenas as entradas que o Nexus registrou como suas.
• Recursos opcionais de desktop: Busca semântica, Busca adaptativa e Apps e integrações

O chat nativo funciona em desktop e mobile. Clientes MCP, provedores locais de desktop e busca semântica são exclusivos do desktop.

Suporte Mobile (Experimental)

O chat nativo funciona no mobile (iOS e Android). Recursos exclusivos do desktop são ignorados com elegância no mobile — eles não aparecem nem causam erros.

Recurso	Mobile	Desktop
Chat nativo	Sim	Sim
Memória do workspace e tarefas	Sim	Sim
Skills (criar e carregar)	Sim	Sim
Clientes MCP (Claude Desktop, Cursor, etc.)	Não	Sim
Ponte CLI local (comando nexus)	Não	Sim
Busca semântica (embeddings locais)	Não	Sim
Ingestão (PDF, áudio, DOCX)	Não	Sim
Captura web para Markdown (web capture-markdown)	Sim	Sim
Composer e o restante das Web Tools	Não	Sim
Análise de dados (Python sobre CSV/Excel)	Não	Sim

O suporte mobile é novo e pode ter bugs. Por favor, relate problemas no GitHub.

Uso de Rede

O Nexus não faz chamadas externas por conta própria. Nada é enviado quando o plugin carrega, e não há telemetria, análise, relatório de falhas ou rastreamento de uso de qualquer tipo. Suas notas permanecem no seu cofre, a menos que você faça algo que as envie para algum lugar. Cada solicitação abaixo é listada com a ação que a causa.

APIs de provedores de IA. Contatadas somente depois que você insere a chave de API do provedor e a utiliza. Seu prompt — e qualquer conteúdo do cofre que o agente decidir incluir — vai para o provedor que você escolheu, e sua chave só é enviada ao provedor ao qual pertence.

Chat e modelos	openrouter.ai, api.openai.com, api.anthropic.com, generativelanguage.googleapis.com, api.mistral.ai, api.groq.com, api.deepseek.com, api.perplexity.ai, router.requesty.ai, api.githubcopilot.com
Voz e transcrição	api.elevenlabs.io, api.deepgram.com, api.assemblyai.com, streaming.assemblyai.com
Fluxos de login	auth.openai.com e chatgpt.com (OpenAI Codex), api.github.com (GitHub Copilot)

Ollama e LM Studio conversam com sua própria máquina e não saem dela.

Downloads para recursos opcionais de desktop. Alguns recursos buscam seu mecanismo na primeira vez que você os habilita, em vez de virem embutidos no main.js — o download é armazenado em cache e não se repete. Nunca habilitar o recurso significa nunca fazer a solicitação.

Recurso	Baixado de
Busca semântica	cdn.jsdelivr.net (transformers.js), huggingface.co (modelo de embedding)
Cache de vetores	cdn.jsdelivr.net ou unpkg.com (sqlite3.wasm)
Análise de dados	cdn.jsdelivr.net (Pyodide), files.pythonhosted.org (openpyxl)
Ingestão de PDF	cdn.jsdelivr.net (worker do pdf.js)
Modelos locais no navegador	cdn.jsdelivr.net, esm.run, huggingface.co, raw.githubusercontent.com (pesos do modelo)

Manutenção. Abrir as configurações do Nexus verifica se há uma versão mais recente (api.github.com, raw.githubusercontent.com). Pedir a um agente para carregar o workspace de guias integrados busca os guias atuais (raw.githubusercontent.com).

Não são solicitações. Duas coisas parecem hosts externos, mas não são. Chamadas ao OpenRouter e à Requesty carregam HTTP-Referer: https://synapticlabs.ai e X-Title: Nexus — os cabeçalhos de atribuição de aplicativo que esses roteadores exibem em seus painéis. São valores de cabeçalho; nada é buscado nesse endereço. E botões como Baixar Node.js ou Obter uma chave de API abrem nodejs.org, ollama.com, lmstudio.ai, claude.ai, github.com ou o console do próprio provedor (platform.openai.com, console.anthropic.com, aistudio.google.com e assim por diante) no seu navegador — o plugin nunca os recupera.

Casos de Uso

Se você quiser...	Comece aqui
Conectar Claude Desktop, Codex CLI, Gemini CLI, Cursor, Cline ou outro cliente MCP	Configuração MCP
Operar seu cofre pelo shell com Claude Code, Cursor ou Codex — sem configuração MCP	Nexus CLI
Configurar provedores de chat integrados no Obsidian	Configuração do provedor
Usar voz ao vivo, ler notas em voz alta ou salvar áudio falado de volta nas suas notas	Chat nativo
Gerar áudio de voz ou arquivos de texto-para-vídeo diretamente no seu cofre	Chat nativo
Dar ao seu agente melhores instruções para usar o Nexus	Prompt de sistema recomendado
Gerenciar trabalhos de longa duração com contexto persistente de workspace	Memória do workspace
Acompanhar projetos, tarefas, bloqueios e dependências	Gerenciamento de tarefas
Pesquisar notas e conversas passadas por significado	Busca semântica
Fazer a busca aprender com as notas que você realmente abre, totalmente no dispositivo	Busca adaptativa
Editar texto selecionado diretamente nas notas	Edição inline
Abrir páginas web no Obsidian e salvá-las como Markdown, PNG ou PDF (experimental)	Apps
Converter PDFs e arquivos de áudio em notas Markdown — clique com o botão direito no cofre ou automático ao adicionar (experimental)	Apps
Mesclar PDFs, concatenar markdown ou misturar faixas de áudio em um único arquivo (experimental)	Apps
Criar e carregar Skills reutilizáveis de agente diretamente do seu cofre	Apps
Executar análise Python/pandas sobre os dados CSV e Excel do seu cofre (experimental, desktop)	Apps
Criar rotinas recorrentes e fluxos de trabalho reutilizáveis	Exemplos de fluxos de trabalho
Entender o design do MCP e as ferramentas disponíveis	Arquitetura de duas ferramentas
Estender o Nexus com apps opcionais	Apps

Prompt Para Seu Agente

Se você quiser que outro agente o guie pela configuração, cole isto:

Help me set up Nexus for Obsidian and guide me step by step.

Use these docs as the source of truth:
- README: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/README.md
- Provider setup: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/guide/provider-setup.md
- MCP setup: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/guide/mcp-setup.md
- Recommended system prompt: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/guide/recommended-system-prompt.md
- Native chat guide: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/guide/native-chat.md

Start by figuring out whether I want native chat inside Obsidian, an external MCP agent, or both. Ask for my OS and the agent I want to use if that matters. Then walk me through the exact setup path, one step at a time.

When a config file needs to be edited, show the exact snippet with my vault path inserted. Do not invent config formats or skip restart/reload steps. If multiple setup paths are possible, recommend the simplest one first.

Mais Guias

• Memória do workspace
• Gerenciamento de tarefas
• Busca semântica
• Busca adaptativa
• Chat nativo
• Edição inline
• Apps
• Exemplos de fluxos de trabalho
• Arquitetura de duas ferramentas
• Nexus CLI

Desenvolvimento

npm install
npm run dev
npm run build
npm run test
npm run lint

Licença

MIT. Veja LICENSE.