Zotero + Google Drive + ResearchRabbit + Obsidian + Claude Desktop — Guia Completo de Instalação e Configuração

Versão: Zotero 7.x | Última revisão: Abril 2026 (validado em Linux Mint 22, macOS e Windows)
Este guia cobre a instalação e configuração de um ecossistema completo de gestão do conhecimento científico: Zotero com plugins essenciais (Better BibTeX, Attanger, Better Notes, scite.ai, PubPeer); sincronização de PDFs com Google Drive (rclone no Linux Mint, cliente oficial no macOS e Windows); descoberta de literatura via ResearchRabbit; organização de notas no Obsidian com integração direta ao Zotero; e conexão de tudo ao Claude Desktop via MCP (Model Context Protocol), permitindo busca cruzada e geração de notas com IA.

Introdução

O que é o Zotero

O Zotero é um gerenciador de referências bibliográficas gratuito, de código aberto e multiplataforma, desenvolvido pelo Roy Rosenzweig Center for History and New Media da George Mason University. Lançado em 2006 e atualizado continuamente pela comunidade e pelos mantenedores do projeto, ele se consolidou como uma das ferramentas mais adotadas por pesquisadores, estudantes de pós-graduação e profissionais que lidam com produção científica intensiva.

Diferentemente de alternativas comerciais como EndNote ou Mendeley (adquirido pela Elsevier em 2013), o Zotero não impõe limitações de armazenamento restritivas nem vincula os dados do usuário a um ecossistema proprietário fechado. A biblioteca fica armazenada localmente em formatos abertos (SQLite + arquivos), podendo ser exportada, versionada e migrada a qualquer momento.

Como o Zotero funciona

O Zotero opera em três camadas integradas:

1. Captura de referências

O Zotero é capaz de identificar e importar metadados de praticamente qualquer fonte bibliográfica — artigos em bases como Google Scholar, PubMed, Scopus, Web of Science e SciELO; livros pelo ISBN; teses e dissertações; páginas web; vídeos; e documentos institucionais. Essa captura é feita pelo Zotero Connector, uma extensão de navegador que reconhece o tipo de conteúdo da página e salva os metadados (título, autores, periódico, DOI, ano, resumo etc.) com um único clique — muitas vezes baixando também o PDF associado automaticamente.

Para fontes sem suporte nativo, é possível importar por DOI, ISBN, arXiv ID ou PMID diretamente no app, ou ainda importar arquivos .bib, .ris e .enl exportados de outras ferramentas.

2. Organização da biblioteca

Dentro do Zotero, as referências são organizadas em coleções (equivalentes a pastas) e subcoleções, que podem espelhar a estrutura de projetos de pesquisa, disciplinas ou capítulos de uma tese. Um mesmo item pode pertencer a múltiplas coleções sem duplicação — a referência existe uma vez no banco de dados e é apenas vinculada a cada coleção relevante.

Cada item possui um painel de metadados completo, uma aba de notas (onde é possível registrar anotações, fichamentos e resumos), uma aba de tags (palavras-chave livres) e uma aba de itens relacionados (para criar conexões explícitas entre referências). O leitor de PDF integrado permite destacar trechos, adicionar comentários e criar notas diretamente a partir do texto, com as anotações sincronizadas ao item na biblioteca.

3. Exportação e integração com editores de texto

O Zotero instala um plugin no Microsoft Word, no LibreOffice e no Google Docs que permite inserir citações e gerar bibliografias automaticamente, em qualquer estilo (ABNT, APA, Vancouver, Chicago, Nature, IEEE e milhares de outros via repositório CSL). A mesma lógica se aplica a fluxos baseados em LaTeX e Quarto/R Markdown, onde o plugin Better BibTeX exporta e mantém atualizado um arquivo .bib sincronizado com a biblioteca.

Como o Zotero auxilia na produção científica

O maior gargalo no ciclo de uma pesquisa não costuma ser a ausência de literatura — é o custo cognitivo de gerenciá-la. Encontrar um artigo que você leu há seis meses, lembrar em qual contexto ele era relevante, formatar uma lista de referências segundo as normas do periódico alvo, manter consistência entre citações no texto e a lista final: cada uma dessas tarefas, feita manualmente, consome tempo e introduz erros.

O Zotero resolve esse problema em cada etapa do fluxo científico:

Etapa da pesquisa	Sem Zotero	Com Zotero
Coleta de literatura	Download manual de PDFs, planilha de controle	Captura com 1 clique, metadados preenchidos automaticamente
Leitura e fichamento	Notas em arquivos dispersos	Anotações vinculadas ao item, pesquisáveis na biblioteca
Descoberta de literatura relacionada	Busca manual nas referências dos artigos	ResearchRabbit + Citation Network automáticos
Citação no texto	Digitação manual, risco de erros de formatação	Plugin insere e formata a citação automaticamente
Geração da bibliografia	Formatação manual item por item	Gerada automaticamente no estilo correto
Colaboração	Envio de arquivos `.bib` por e-mail	Bibliotecas de grupo compartilhadas em tempo real
Mudança de estilo	Reformatação manual de cada referência	Um clique para converter toda a bibliografia

Para o contexto de um doutorado, onde a revisão bibliográfica pode envolver centenas de artigos ao longo de anos, o ganho é ainda mais expressivo. A possibilidade de sincronizar a biblioteca entre dispositivos, integrá-la ao Google Drive (para manter os PDFs acessíveis de qualquer lugar) e conectá-la a ferramentas de descoberta como o ResearchRabbit transforma o Zotero no núcleo de um sistema de gestão do conhecimento científico — não apenas um repositório de referências.

Por que este ecossistema?

Gerenciar literatura científica é um problema resolvido há décadas pelo Zotero. O que este guia propõe vai além: conectar o Zotero a uma cadeia de ferramentas que transforma a maneira como você coleta, descobre, lê, anota e utiliza literatura científica — com IA integrada em cada etapa.

O ecossistema em uma frase

Você captura um artigo no navegador → o PDF vai automaticamente para o Google Drive → o ResearchRabbit descobre artigos relacionados → o Obsidian gera notas literárias vinculadas ao Zotero → o Claude Desktop lê sua biblioteca e seu vault simultaneamente e raciocina sobre eles como um assistente de pesquisa com memória permanente.

As cinco camadas e o que cada uma resolve

Camada	Ferramenta	Problema que resolve
Captura e organização	Zotero + plugins	Elimina entrada manual de metadados, formata citações automaticamente, mantém anotações vinculadas ao PDF
Armazenamento	Google Drive + Attanger	PDFs acessíveis em qualquer dispositivo, renomeados e organizados automaticamente por regras configuráveis
Descoberta	ResearchRabbit	Mapeia redes de citação, sugere artigos relacionados, identifica autores-chave — sem buscas manuais repetitivas
Notas e síntese	Obsidian + Zotero Integration	Fichamentos estruturados vinculados aos itens do Zotero, com backlinks, tags e grafo de conhecimento
IA com contexto	Claude Desktop + MCP	Busca cruzada entre biblioteca e vault, geração de notas literárias, análise de lacunas metodológicas, síntese entre fontes — tudo sem copiar e colar conteúdo manualmente

Por que o MCP muda o jogo

Sem o MCP, usar IA na pesquisa significa copiar trechos de artigos ou notas e colar na conversa — custoso, fragmentado e sem memória entre sessões. Com o MCP:

O Claude Desktop enxerga sua biblioteca Zotero via API local: busca por tema, autor, ano ou qualquer campo; lê metadados e texto completo dos PDFs.
O Claude Desktop lê e escreve no vault do Obsidian: cria notas estruturadas, verifica o que já foi fichado, atualiza frontmatter, cruza informações entre notas.
As duas fontes são consultadas simultaneamente: "quais artigos sobre mercúrio ainda não foram fichados?" é uma pergunta que o Claude responde comparando os dois sistemas em tempo real.
O contexto persiste no vault: análises, roadmaps e sínteses gerados pelo Claude são salvos como notas Markdown — não se perdem ao fechar a conversa.

Para quem é este guia

Este ecossistema é especialmente valioso para:

Doutorandos e pesquisadores com biblioteca extensa e múltiplos projetos ativos simultaneamente.
Profissionais que produzem relatórios técnicos com base em literatura científica (saúde pública, engenharia, meio ambiente).
Qualquer pessoa que usa Zotero e quer integrar IA ao fluxo de pesquisa sem abrir mão do controle sobre os dados.

Sobre controle dos dados: toda a cadeia funciona localmente ou em infraestrutura sob seu controle (Zotero local, Google Drive próprio, vault local no Obsidian). Nenhuma nota ou PDF é enviado a servidores de terceiros sem sua ação explícita.

Sumário

Instalação do Zotero
Linux Mint (recomendado: via repositório deb)
macOS
Windows
Zotero Connector (extensão do navegador)
Plugins Essenciais
Better BibTeX
Attanger
Better Notes
Translate for Zotero
scite.ai
PapersGPT
PubPeer
Notero (condicional — usuários Notion)
Sincronização com Google Drive — Linux Mint (rclone)
Instalação do rclone
Configuração do remote gdrive
Criação do ponto de montagem
Serviço systemd --user
Configuração do Attanger com o Google Drive
Linux Mint — diretório montado via rclone
macOS — cliente oficial do Google Drive
Windows — cliente oficial do Google Drive
Modelo de renomeação de arquivos (todos os sistemas)
Opções críticas (todos os sistemas)
Integração com ResearchRabbit
Fluxo de trabalho completo
Ecossistema Obsidian + Claude Desktop + Zotero via MCP
Visão geral da arquitetura
Instalação do Obsidian
Camada 1 — Zotero → Obsidian: escolha do plugin
- ZotLit vs Zotero Integration — contexto da decisão
- Zotero Integration (opção recomendada)
- Alternativa: ZotLit (requer downgrade)
Camada 2 — Claude Desktop + Zotero MCP
- Instalação do Claude Desktop (Linux Mint, macOS, Windows)
- Instalação do uv e do servidor Zotero MCP
- Configuração da API local do Zotero
- Configuração do claude_desktop_config.json
Camada 3 — Claude Desktop + Obsidian MCP
Uso combinado — prompts validados
Gantt no Obsidian — visualização de roadmap
Solução de problemas

1. Instalação do Zotero

1.1 Linux Mint

O método recomendado é via repositório .deb mantido pelo projeto zotero-deb (retorquere). Ele garante atualizações automáticas via apt e não requer gestão manual de AppImage ou tarball.

# 1. Baixar e executar o script de configuração do repositório
curl -sL https://raw.githubusercontent.com/retorquere/zotero-deb/master/install.sh | sudo bash

# 2. Atualizar a lista de pacotes
sudo apt update

# 3. Instalar o Zotero
sudo apt install zotero

Por que esse método? O script adiciona a chave GPG e o repositório apt automaticamente. A partir daí, sudo apt upgrade atualiza o Zotero junto com o sistema, sem intervenção manual.

Verificação:

zotero --version
# Exemplo de saída: Zotero 7.0.x

Desinstalação (se necessário):

sudo apt remove zotero
# Para remover também o repositório:
sudo rm /etc/apt/sources.list.d/zotero*.list
sudo apt update

1.2 macOS

Pré-requisitos: macOS 10.15 Catalina ou superior (Intel ou Apple Silicon).

Acesse https://www.zotero.org/download/.
Clique em Download para baixar o arquivo .dmg.
Abra o .dmg e arraste o ícone do Zotero para a pasta Applications.
Ejeite o volume e abra o Zotero em Applications ou via Spotlight (⌘ Space → "Zotero").

Apple Silicon (M1/M2/M3): O Zotero 7 é universal binary — roda nativamente em ARM sem Rosetta.

Atualização: O Zotero possui atualizador interno. Acesse Zotero → Check for Updates periodicamente ou ative atualizações automáticas em Preferences → General → Automatically check for updates.

Homebrew (alternativo):

brew install --cask zotero

1.3 Windows

Pré-requisitos: Windows 10 ou 11 (64-bit).

Acesse https://www.zotero.org/download/.
Clique em Download para baixar o instalador .exe.
Execute o instalador e siga as instruções (Next → Install → Finish).
O Zotero será adicionado ao menu Iniciar e à área de trabalho.

winget (alternativo, Windows 10/11):

winget install Zotero.Zotero

Perfil e dados: Por padrão, o Zotero armazena a biblioteca em:

C:\Users\<SeuUsuário>\Zotero

Você pode alterar esse caminho em Edit → Preferences → Advanced → Files and Folders → Data Directory Location.

2. Zotero Connector

O Connector é uma extensão de navegador que permite salvar referências diretamente de páginas web, bases de dados (Google Scholar, PubMed, Scopus, Web of Science etc.) e PDFs online com um clique.

Navegador	Link
Firefox	Mozilla Add-ons
Chrome / Brave / Edge	Chrome Web Store
Safari (macOS)	Incluído no pacote do Zotero para Mac

Como usar:

Com o Zotero aberto no desktop, navegue até o artigo/livro desejado.
Clique no ícone do Connector na barra de ferramentas do navegador.
Escolha a coleção de destino e confirme.

Dica: Em páginas de resultados (Google Scholar, PubMed), o Connector detecta múltiplos itens e oferece uma janela de seleção em lote.

3. Plugins Essenciais

Os plugins são instalados via Tools → Add-ons → gear icon → Install Add-on From File (arquivo .xpi). Baixe cada .xpi no GitHub do respectivo projeto.

3.1 Better BibTeX

Função: Gera e mantém chaves de citação BibTeX estáveis e personalizáveis. Essencial para integração com LaTeX, Overleaf, Pandoc e Quarto.

Repositório: https://github.com/retorquere/zotero-better-bibtex

Instalação:

Baixe o último .xpi em Releases.
No Zotero: Tools → Add-ons → Install Add-on From File → selecione o .xpi.
Reinicie o Zotero.

Configuração recomendada:

Tools → Better BibTeX → Open Better BibTeX Preferences
Citation keys → Citation key formula:

[auth:lower][year][veryshorttitle:lower]

Exemplo de saída: silva2023carbon

Exportação contínua (auto-export):

Clique com o botão direito na coleção → Export Collection.
Formato: Better BibLaTeX.
Marque Keep updated.
Salve o arquivo .bib onde seu projeto LaTeX/Quarto possa acessá-lo.

3.2 Attanger

Função: Gerencia onde os PDFs e anexos são armazenados. Permite usar um diretório customizado (ex.: ~/Gdrive) em vez do armazenamento interno do Zotero, economizando cota na nuvem do Zotero e integrando com qualquer solução de sync (rclone, Nextcloud, Dropbox etc.).

Repositório: https://github.com/MuiseDestiny/zotero-attanger

Instalação:

Baixe o último .xpi em Releases.
Tools → Add-ons → Install Add-on From File → selecione o .xpi.
Reinicie o Zotero.

A configuração detalhada do Attanger está na Seção 5.

3.3 Better Notes

Função: Transforma o sistema de notas do Zotero em um ambiente robusto, com suporte a Markdown, templates, notas vinculadas entre itens e exportação estruturada.

Repositório: https://github.com/windingwind/zotero-better-notes

Instalação:

Baixe o .xpi em Releases.
Tools → Add-ons → Install Add-on From File → selecione o .xpi.
Reinicie o Zotero.

Uso básico:

Abra um item → aba Notes → Add note from template.
Acesse o editor completo em Tools → Better Notes → Open Note Editor.
Use [[nome do item]] para criar links entre notas.

3.4 Translate for Zotero

Função: Traduz resumos, títulos e notas diretamente no painel do Zotero, usando DeepL, Google Translate ou LibreTranslate.

Repositório: https://github.com/windingwind/zotero-pdf-translate

Instalação:

Baixe o .xpi em Releases.
Tools → Add-ons → Install Add-on From File → selecione o .xpi.
Reinicie o Zotero.

Configuração:

Edit → Preferences → Translate (nova aba criada pelo plugin).
Selecione o serviço de tradução (recomendado: DeepL Free — requer chave de API gratuita em deepl.com).
Idioma de destino: Português (BR).

Uso:

Selecione texto no leitor de PDF → clique direito → Translate.
No painel lateral, o resumo aparece traduzido automaticamente ao abrir um item.

3.5 scite.ai

Função: Mostra citações contextuais — se um artigo foi citado de forma supporting, contrasting ou mentioning por outros trabalhos. Adiciona badges de Smart Citations diretamente nos itens da biblioteca.

Site: https://scite.ai (requer conta gratuita ou paga)

Instalação:

Acesse https://scite.ai/zotero para baixar o .xpi oficial.
Tools → Add-ons → Install Add-on From File → selecione o .xpi.
Reinicie o Zotero e faça login com sua conta scite.

Uso:

Os badges aparecem automaticamente na coluna de itens e no painel de detalhes.
Clique no badge para ver as citações contextuais no site do scite.

3.6 PapersGPT

Função: Integra LLMs (GPT-4, Claude, Gemini) ao Zotero para sumarização de PDFs, extração de trechos relevantes e geração de notas automáticas.

Repositório / Site: Consulte a documentação do plugin para a versão atual e chave de API necessária.

Instalação:

Baixe o .xpi em Releases.
Tools → Add-ons → Install Add-on From File → selecione o .xpi.
Reinicie o Zotero.
Configure a chave de API do provedor desejado em Edit → Preferences → PapersGPT.

3.7 PubPeer

Função: Exibe alertas diretamente nos itens da biblioteca quando há comentários de revisão pós-publicação no PubPeer — uma plataforma de fiscalização científica onde pesquisadores discutem anonimamente problemas metodológicos, manipulação de imagens, inconsistências de dados e outros problemas em artigos publicados. Muitos dos problemas sinalizados no PubPeer resultam em correções ou retratações posteriores.

Repositório / Site: https://pubpeer.com/static/faq#12

Instalação:

Acesse https://pubpeer.com/static/faq#12 e localize o link para o plugin do Zotero.
Baixe o arquivo .xpi.
Tools → Add-ons → Install Add-on From File → selecione o .xpi.
Reinicie o Zotero.
Faça login com sua conta PubPeer em Edit → Preferences → PubPeer (opcional, mas recomendado para receber notificações de novos comentários).

Uso:

Os alertas aparecem automaticamente nos itens que possuem comentários no PubPeer, na forma de um ícone ou badge na coluna de itens.
Clique no badge para abrir a thread de discussão correspondente no site do PubPeer.
O plugin verifica por DOI — itens sem DOI não são checados.

Nota de compatibilidade: O plugin PubPeer para Zotero é mantido pela PubPeer Foundation. Verifique sempre a página oficial para a versão mais atual compatível com o Zotero 7.

3.8 Notero (condicional — usuários Notion)

Função: Sincroniza automaticamente itens e notas do Zotero para o Notion, criando uma entrada estruturada no banco de dados do Notion para cada referência adicionada à biblioteca.

Repositório: https://github.com/dvanoni/notero

Este plugin é relevante apenas para quem usa o Notion como ferramenta de organização da pesquisa. Para usuários que preferem o Obsidian como PKM, consulte a Seção 8.

Instalação:

Baixe o .xpi em Releases no GitHub.
Tools → Add-ons → Install Add-on From File → selecione o .xpi.
Reinicie o Zotero.

Configuração:

Crie uma integração no Notion em notion.so/my-integrations:
Clique em + New integration.
Dê um nome (ex.: "Zotero Sync") e selecione o workspace.
Copie o Internal Integration Token gerado.
No Notion, crie um banco de dados para as referências (ou use um existente) e compartilhe-o com a integração (botão Share → adicione a integração pelo nome).
Copie o ID do banco de dados da URL (formato: https://notion.so/<workspace>/<database_id>?v=...).
No Zotero: Edit → Preferences → Notero:
Cole o Notion Token.
Cole o Database ID.
Configure as coleções que serão sincronizadas.
Reinicie o Zotero.

Uso:

A cada novo item adicionado às coleções configuradas, o Notero cria uma linha no banco de dados do Notion com título, autores, ano, DOI, resumo e link zotero://select para abrir o item diretamente no Zotero.

4. Sincronização com Google Drive — Linux Mint (rclone)

⚠️ Esta seção é exclusiva para Linux Mint. No macOS e Windows, o Google Drive possui cliente oficial que já expõe uma pasta local sincronizada automaticamente — não é necessário instalar o rclone. Consulte a Seção 5 para a configuração do Attanger em cada sistema.

O Linux não possui cliente oficial do Google Drive. A solução adotada é o rclone, que monta a raiz completa do Google Drive como um diretório local (~/Gdrive) via FUSE, de forma transparente para qualquer aplicativo — incluindo o Attanger, o Obsidian e qualquer outro uso pessoal ou profissional.

Por que montar o Drive inteiro e não apenas uma subpasta? Montar a raiz permite usar ~/Gdrive para qualquer finalidade (doutorado, aulas de música, Fiocruz, arquivos pessoais) sem precisar criar serviços separados. O Attanger é configurado para apontar para a subpasta específica do projeto dentro de ~/Gdrive, e os vaults do Obsidian podem ser criados em qualquer subpasta do Drive conforme necessário.

4.1 Instalação do rclone

sudo apt update && sudo apt install rclone -y

Verificação:

rclone version
# rclone v1.6x.x ...

4.2 Configuração do remote gdrive

rclone config

Siga as etapas interativas:

Prompt	Resposta
`n) New remote`	`n`
`name>`	`gdrive`
`Storage>`	Número do Google Drive (procure na lista, geralmente 18 ou próximo)
`client_id>`	Enter (usar padrão) — ou seu próprio client_id do Google Cloud Console
`client_secret>`	Enter (usar padrão)
`scope>`	`1` (Full access)
`service_account_file>`	Enter (deixar vazio)
`Edit advanced config?`	`n`
`Use auto config?`	`y`
(autenticação no navegador)	Faça login no Google e autorize o acesso
`Configure this as a Shared Drive?`	`n` (para conta pessoal)
`Keep this "gdrive" remote?`	`y`
Sair da configuração	`q`

Verificação do remote:

rclone lsd gdrive:
# Deve listar as pastas da raiz do seu Google Drive

4.3 Criação do ponto de montagem

mkdir -p ~/Gdrive

Teste manual de montagem (antes de configurar o serviço):

rclone mount gdrive: ~/Gdrive \
    --vfs-cache-mode full \
    --daemon

Verifique se o Drive aparece com as pastas da raiz:

ls ~/Gdrive
# Deve listar todas as pastas do seu Google Drive (ex: doutorado-unb-2026, Obsidian, etc.)

Para desmontar o teste:

fusermount3 -u ~/Gdrive

4.4 Serviço systemd --user

Crie o arquivo de serviço para que a montagem ocorra automaticamente no login:

mkdir -p ~/.config/systemd/user
nano ~/.config/systemd/user/rclone-gdrive.service

Cole o conteúdo abaixo:

[Unit]
Description=Montagem completa do Google Drive via Rclone
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
# Limpa qualquer montagem travada antes de começar
ExecStartPre=-/bin/fusermount3 -u %h/Gdrive
ExecStart=/usr/bin/rclone mount gdrive: %h/Gdrive \
    --config=%h/.config/rclone/rclone.conf \
    --vfs-cache-mode full \
    --vfs-cache-max-age 168h \
    --vfs-cache-max-size 10G \
    --vfs-read-chunk-size 128M \
    --dir-cache-time 5m \
    --vfs-cache-poll-interval 1m
ExecStop=/bin/fusermount3 -u %h/Gdrive
Restart=on-failure
RestartSec=10

[Install]
WantedBy=default.target

Ativar e iniciar o serviço:

# Recarregar configurações do systemd
systemctl --user daemon-reload

# Iniciar o serviço agora
systemctl --user start rclone-gdrive.service

# Verificar status
systemctl --user status rclone-gdrive.service

# Habilitar na inicialização do usuário
systemctl --user enable rclone-gdrive.service

Verificação final:

ls ~/Gdrive
# Deve listar todas as pastas da raiz do seu Google Drive

Parâmetros explicados:

Parâmetro	Função
`--vfs-cache-mode full`	Cache local completo; leitura e escrita passam pelo cache antes de ir para a nuvem
`--vfs-cache-max-age 168h`	Mantém arquivos em cache por até 7 dias
`--vfs-cache-max-size 10G`	Limite de 10 GB de cache local em disco
`--vfs-read-chunk-size 128M`	Baixa arquivos em chunks de 128 MB (melhor para PDFs grandes)
`--dir-cache-time 5m`	Atualiza o índice de diretórios a cada 5 minutos
`--vfs-cache-poll-interval 1m`	Verifica o cache a cada 1 minuto

5. Configuração do Attanger com o Google Drive

O Attanger é configurado de forma idêntica em todos os sistemas no que diz respeito ao modelo de renomeação e às opções críticas. A única diferença é o caminho do diretório base, que varia conforme o sistema operacional e o método de sincronização com o Drive.

5.1 Linux Mint — diretório montado via rclone

Com o rclone montando a raiz completa do Drive em ~/Gdrive conforme a Seção 4, aponte o Attanger para a subpasta específica do projeto:

No Zotero: Edit → Preferences → Attanger (ou Tools → Attanger Settings).
Em Base Directory, clique em Browse e selecione:

/home/<SeuUsuário>/Gdrive/doutorado-unb-2026

Use o caminho absoluto com a subpasta explícita. Evite ~/Gdrive/doutorado-unb-2026 no campo de texto — alguns builds do Zotero não expandem o til corretamente nessa caixa. Evite também apontar para ~/Gdrive diretamente (raiz do Drive), pois o Attanger moveria os PDFs para a raiz em vez da pasta do projeto.

O Attanger moverá todos os novos anexos para dentro de ~/Gdrive/doutorado-unb-2026, que o rclone mantém sincronizado com o Google Drive em background. As demais pastas do Drive (~/Gdrive/Obsidian, ~/Gdrive/estudo-musica etc.) permanecem acessíveis mas não são afetadas pelo Attanger.

5.2 macOS — cliente oficial do Google Drive

No macOS, instale o Google Drive para Desktop (drive.google.com/drive/download). Após fazer login, o cliente cria automaticamente um volume montado acessível em:

/Users/<SeuUsuário>/Google Drive/My Drive

ou, em versões mais recentes do cliente:

/Volumes/Google Drive/My Drive

Como confirmar o caminho exato: Abra o Finder → barra lateral → clique em Google Drive → arraste a pasta doutorado-unb-2026 para o Terminal para ver o caminho completo.

Configuração no Attanger:

Edit → Preferences → Attanger → Base Directory → Browse.
Navegue até Google Drive → My Drive → doutorado-unb-2026 e confirme.

O caminho resultante será algo como:

/Users/<SeuUsuário>/Google Drive/My Drive/doutorado-unb-2026

Comportamento: O cliente do Drive sincroniza os arquivos em tempo real. Quando o Attanger move um PDF para essa pasta, ele aparece na nuvem em poucos segundos (sujeito à velocidade de upload).

Modo Streaming vs. Mirror:

Modo	Comportamento	Recomendado para Attanger
Stream files (padrão)	Arquivos ficam na nuvem; baixados sob demanda	⚠️ Pode causar lentidão ao abrir PDFs
Mirror files	Cópia local completa em disco	✅ Recomendado — garante acesso offline e velocidade

Para ativar o Mirror: Google Drive (ícone na barra de menus) → Preferences → Google Drive → Mirror files.

5.3 Windows — cliente oficial do Google Drive

No Windows, instale o Google Drive para Desktop (drive.google.com/drive/download). Após fazer login, o cliente mapeia o Drive como uma unidade virtual, geralmente:

G:\My Drive

ou

G:\Meu Drive

Como confirmar a letra da unidade: Abra o Explorador de Arquivos → barra lateral → localize Google Drive (G:) ou similar. A letra pode variar conforme as unidades já mapeadas no sistema.

Configuração no Attanger:

Edit → Preferences → Attanger → Base Directory → Browse.
Navegue até G:\My Drive\doutorado-unb-2026 (ou o caminho equivalente) e confirme.

O caminho resultante será algo como:

G:\My Drive\doutorado-unb-2026

Modo Streaming vs. Mirror (mesmo critério do macOS):

Para ativar o Mirror no Windows: Google Drive (ícone na bandeja do sistema) → Preferences → Google Drive → Mirror files. Isso garante que os PDFs estejam disponíveis localmente, sem depender de conexão para o Zotero abri-los.

Atenção com barras: O Attanger no Windows usa barras invertidas (\) no caminho. Não altere manualmente o campo de texto — use sempre o botão Browse para evitar erros de formatação.

5.4 Modelo de renomeação de arquivos (todos os sistemas)

A renomeação automática de arquivos não é configurada no Attanger, mas sim nas preferências nativas do próprio Zotero. O Attanger delega essa responsabilidade ao Zotero, que aplica o modelo definido pelo usuário ao mover qualquer anexo.

Caminho de acesso:

Edit → Preferences → General → File Renaming → Configuring file renaming

Ao clicar em Configuring file renaming, uma janela auxiliar é aberta com uma caixa de texto para o modelo do nome do arquivo. É nessa caixa que o template deve ser inserido.

Modelo recomendado:

{{ creator familyOnly="true" suffix=" - " }}{{ year suffix=" - " }}{{ title truncate="50" }}

Exemplos de saída:

Dados do item	Nome gerado
Silva, 2023, "Carbon flux in Amazonian watersheds: a review"	`Silva - 2023 - Carbon flux in Amazonian watersh`
Buffon et al., 2015, "Cheia do Rio Acre"	`Buffon - 2015 - Cheia do Rio Acre`

Por que esse modelo?

familyOnly="true" — usa só o sobrenome, evitando nomes longos com múltiplos autores ou sufixos como "e outros".
truncate="50" — limita o título a 50 caracteres, impedindo que caminhos de arquivo ultrapassem limites do sistema de arquivos quando há subpastas.
Separador - entre os campos — padrão legível e compatível com Linux, macOS e Windows (sem caracteres especiais).

Como aplicar (passo a passo):

No Zotero: Edit → Preferences → General.
Localize a seção File Renaming.
Clique em Configuring file renaming — uma janela auxiliar é aberta.
Na caixa de texto Filename template, apague o conteúdo atual e cole o modelo acima.
Feche a janela auxiliar para salvar.

5.5 Opções críticas (todos os sistemas)

✅ Marcar: "Rename linked files" (Renomear arquivos linkados)

Esta opção também está em Edit → Preferences → General → File Renaming — é uma caixa de seleção localizada na mesma seção, imediatamente acima ou abaixo do botão Configuring file renaming.

Como o Attanger trabalha com linked files (arquivos fora do armazenamento interno do Zotero), você deve marcar essa opção em qualquer sistema operacional.

Por que? Sem ela, ao mover o arquivo para a pasta do Drive, o Zotero não aplica o modelo de renomeação aos arquivos linkados — apenas aos arquivos armazenados internamente. Com a opção marcada, o Zotero renomeia o arquivo no Drive sempre que os metadados mudam (ex.: você corrige o ano ou o autor).

Resumo de configuração por sistema:

Sistema	Attanger — Base Directory	Zotero — Rename linked files
Linux Mint	`/home/<usuário>/Gdrive/doutorado-unb-2026`	✅ Marcado
macOS	`/Users/<usuário>/Google Drive/My Drive/doutorado-unb-2026`	✅ Marcado
Windows	`G:\My Drive\doutorado-unb-2026`	✅ Marcado

Resumindo a divisão de responsabilidades: o Attanger decide para onde o arquivo vai (Base Directory). O Zotero nativo decide como o arquivo se chama (Filename template) e se arquivos linkados também são renomeados (Rename linked files). As duas configurações precisam estar corretas para o fluxo funcionar.

6. Integração com ResearchRabbit

O ResearchRabbit é uma ferramenta de descoberta de literatura que se conecta à sua biblioteca Zotero para sugerir artigos relacionados, mapear redes de citação e identificar lacunas na revisão bibliográfica.

Criação de conta e conexão:

Acesse https://www.researchrabbit.ai e crie uma conta gratuita.
No painel do ResearchRabbit, clique em Connect Zotero.
Você será redirecionado para o site do Zotero para autorizar o acesso OAuth.
Autorize e volte ao ResearchRabbit.

Sincronização de coleções:

Em ResearchRabbit → Collections → Import from Zotero.
Selecione as coleções que deseja importar (ex.: Doutorado, Revisão Sistemática).
O ResearchRabbit importa os itens e gera um mapa de citações interativo.

Funcionalidades principais:

Funcionalidade	Descrição
Similar Papers	Artigos relacionados baseados em embeddings semânticos
Citation Network	Visualização interativa de quem cita quem
Co-Authors	Autores que frequentemente colaboram nos seus temas
Time Machine	Linha do tempo da literatura por tema
Collections Sync	Atualiza automaticamente quando você adiciona itens no Zotero

Adicionar descobertas ao Zotero:

Em qualquer artigo sugerido, clique em + para adicioná-lo diretamente a uma coleção do Zotero.
O Zotero Connector então baixa os metadados (e o PDF, se disponível).

7. Fluxo de trabalho completo

┌──────────────────────────────────────────────────────────────────────────┐
│                         FLUXO DE PESQUISA                                │
│                                                                          │
│  Navegador                                                               │
│  (Scholar/PubMed)  ──[Connector]──▶  Zotero ◀──[OAuth]── ResearchRabbit │
│                                         │                                │
│                                    Attanger                              │
│                                         │                                │
│              ┌──────────────────────────┼──────────────────────┐        │
│         Linux Mint                    macOS                  Windows     │
│         ~/Gdrive                   ~/Google Drive/         G:\My Drive\  │
│         [rclone FUSE]              [cliente oficial]        [cliente     │
│              └──────────────────────────┼──────────────────────┘        │
│                                    ☁️ Google Drive                       │
│                                                                          │
│  Zotero (biblioteca) ──[ZotLit]──▶  Obsidian vault (notas Markdown)     │
│                    │                       │                             │
│                    │                  [MCP server]                       │
│                    │                       │                             │
│                [MCP server]                ▼                             │
│                    └───────────────▶  Claude Desktop                    │
│                                      (acesso simultâneo a               │
│                                       biblioteca + vault)                │
│                                                                          │
│  Zotero (refs) ──[Better BibTeX]──▶  .bib ──▶  LaTeX / Quarto           │
└──────────────────────────────────────────────────────────────────────────┘

Passo a passo típico:

Encontrou um artigo relevante no Google Scholar ou ResearchRabbit.
Clique no Zotero Connector no navegador → salva metadados + PDF.
O Attanger detecta o novo PDF → move para a pasta do Drive → renomeia automaticamente.
A sincronização com o Google Drive ocorre em background:
Linux: o rclone envia o arquivo para gdrive:doutorado-unb-2026.
macOS/Windows: o cliente oficial detecta a mudança na pasta local e faz upload automaticamente.
O ZotLit exporta o item para o vault do Obsidian como nota Markdown com metadados completos.
Abra o PDF no Zotero → use Translate for Zotero para traduzir trechos e adicione anotações.
No Claude Desktop, consulte a biblioteca e o vault simultaneamente via MCP: "Resuma os artigos sobre mercúrio em bacias hidrográficas e conecte com minhas notas no Obsidian sobre GNNs".
Verifique o impacto do artigo com scite.ai e cheque alertas com PubPeer.
Ao escrever, o Better BibTeX exporta o .bib atualizado automaticamente para LaTeX/Quarto.

8. Ecossistema Obsidian + Claude Desktop + Zotero via MCP

8.1 Visão geral da arquitetura

O Obsidian é um editor de notas local, baseado em Markdown puro, com um sistema de grafo que conecta notas por links bidirecionais. Integrado ao Zotero via Zotero Integration e ao Claude via MCP (Model Context Protocol), ele se torna o núcleo de um sistema de gestão do conhecimento científico onde a IA tem acesso simultâneo à sua biblioteca de referências e às suas próprias notas e ideias.

A integração opera em três camadas independentes que se complementam:

Camada	Tecnologia	O que conecta	O que permite
1	Zotero Integration	Zotero → Obsidian	Importar referências como notas Markdown com metadados e anotações via hotkey
2	Zotero MCP	Zotero → Claude Desktop	Claude consultar e pesquisar a biblioteca diretamente
3	Obsidian MCP	Obsidian → Claude Desktop	Claude ler, criar e editar notas no vault

Pré-requisito fundamental: as Camadas 2 e 3 exigem o Claude Desktop (app nativo para Linux, macOS ou Windows), não a interface web do Claude.ai. O MCP funciona apenas no app desktop.

8.2 Instalação do Obsidian e estratégia de vaults

Linux Mint:

# Via Flatpak (recomendado — atualizações automáticas)
flatpak install flathub md.obsidian.Obsidian

# Ou via AppImage (baixe em obsidian.md/download)
chmod +x Obsidian-*.AppImage
./Obsidian-*.AppImage

macOS:

brew install --cask obsidian
# Ou baixe o .dmg em https://obsidian.md/download

Windows:

winget install Obsidian.Obsidian
# Ou baixe o instalador em https://obsidian.md/download

Estratégia de vaults múltiplos com API key compartilhada

O Obsidian suporta múltiplos vaults independentes — cada um com seus próprios plugins, configurações e notas. Isso é ideal para separar contextos profissionais completamente distintos (doutorado, Fiocruz, IFB, música, uso pessoal).

O problema é que o plugin Local REST API (necessário para o MCP do Obsidian) gera uma API key por vault. Se você tiver vaults separados, cada um precisaria de uma chave diferente — e o claude_desktop_config.json só aceita uma instância do servidor MCP por vez.

Solução: vault raiz + sub-vaults

Crie um vault raiz chamado Obsidian (vazio, apenas container) e dentro dele crie os vaults reais como subpastas. Todos os sub-vaults compartilham a mesma instância do Local REST API, instalada no vault raiz.

~/Gdrive/Obsidian/              ← vault raiz (aberto no Obsidian)
├── doutorado-unb/              ← sub-vault
│   ├── Sources/
│   ├── Templates/
│   ├── Projetos/
│   │   ├── mercurio-gnn/
│   │   ├── rio-acre-swat/
│   │   └── weathermesh/
│   └── Diário/
├── fiocruz/                    ← sub-vault
│   ├── Vigiante/
│   └── Gestao/
├── ifb/                        ← sub-vault
│   ├── Aulas/
│   └── Alunos/
└── estudo-musica/              ← sub-vault
    ├── Teoria/
    └── Repertorio/

Por que sub-vaults e não vaults separados? O Local REST API aponta para o vault que está aberto. Com o vault raiz Obsidian sempre aberto, o Claude Desktop enxerga todas as subpastas simultaneamente via MCP — você pode pedir ao Claude para cruzar notas do doutorado-unb com materiais do fiocruz em uma única conversa. Com vaults separados, seria necessário trocar o vault ativo no Obsidian e reiniciar a conversa.

Quando vaults separados fazem sentido: se você precisar de plugins conflitantes entre contextos, ou se quiser garantir isolamento total de dados entre projetos (ex: dados sensíveis de pacientes no vault da Fiocruz).

Criando a estrutura de vaults:

Linux Mint:

# Criar a estrutura no Google Drive
mkdir -p ~/Gdrive/Obsidian/doutorado-unb/{Sources,Templates,Projetos/{mercurio-gnn,rio-acre-swat,weathermesh},Diario}
mkdir -p ~/Gdrive/Obsidian/fiocruz/{Vigiante,Gestao}
mkdir -p ~/Gdrive/Obsidian/ifb/{Aulas,Alunos}
mkdir -p ~/Gdrive/Obsidian/estudo-musica/{Teoria,Repertorio}

macOS:

mkdir -p ~/Library/CloudStorage/GoogleDrive-*/My\ Drive/Obsidian/doutorado-unb/{Sources,Templates,Projetos/{mercurio-gnn,rio-acre-swat,weathermesh},Diario}
# (adapte o caminho conforme retornado pelo Finder)

Windows (PowerShell):

$base = "G:\My Drive\Obsidian"
New-Item -ItemType Directory -Force "$base\doutorado-unb\Sources"
New-Item -ItemType Directory -Force "$base\doutorado-unb\Templates"
New-Item -ItemType Directory -Force "$base\doutorado-unb\Projetos\mercurio-gnn"
New-Item -ItemType Directory -Force "$base\fiocruz\Vigiante"
New-Item -ItemType Directory -Force "$base\ifb\Aulas"
New-Item -ItemType Directory -Force "$base\estudo-musica\Teoria"

Abrindo o vault raiz no Obsidian:

Abra o Obsidian → Open folder as vault.
Selecione ~/Gdrive/Obsidian (ou equivalente no Drive).
Confirme — o Obsidian abre o vault raiz e enxerga todas as subpastas.

O Obsidian trata sub-vaults como pastas comuns. Plugins instalados no vault raiz (como o Local REST API) têm acesso a todo o conteúdo abaixo dele.

Ativar plugins comunitários:

Settings → Community plugins → Turn on community plugins.
Confirme o aviso sobre plugins de terceiros.

8.3 Camada 1 — Zotero → Obsidian: escolha do plugin

Existem dois plugins principais para conectar o Zotero ao Obsidian. Esta seção explica a diferença entre eles, o motivo da escolha adotada nesta documentação, e mantém as instruções de ambos para consulta.

8.3.1 ZotLit vs Zotero Integration — por que esta documentação usa o Zotero Integration

O ZotLit é tecnicamente superior: conecta-se diretamente ao banco de dados SQLite do Zotero, oferece sincronização automática de anotações em tempo real, painel lateral ao vivo e suporte a imagens. No entanto, ele depende de um binário nativo (better-sqlite3) compilado para a versão específica do Electron empacotada no instalador do Obsidian.

O problema é estrutural e recorrente: toda vez que o Obsidian lança um novo instalador com uma versão mais recente do Electron, o ZotLit para de funcionar — em Linux, macOS e Windows igualmente. O histórico de quebras é extenso:

Atualização do Electron	Versão do Obsidian	ZotLit quebrou?	Fix lançado?
Electron 25	~1.3.x	✅ Sim	✅ Sim
Electron 28	~1.5.x	✅ Sim	✅ Sim
Electron 30	~1.6.x	✅ Sim	✅ Sim
Electron 32	~1.7.x	✅ Sim	✅ Sim
Electron 34	1.8.9	✅ Sim	✅ Sim (ZotLit 1.1.10)
Electron 39	1.11+	✅ Sim	❌ Sem fix (abril 2026)

O ZotLit é mantido por um único desenvolvedor. Cada ciclo de quebra pode levar semanas ou meses para ser corrigido, deixando o fluxo de pesquisa paralisado. Para usar o ZotLit com o Obsidian atual (1.11+, Electron 39), é necessário fazer downgrade do Obsidian para a versão 1.10.x e desativar as atualizações automáticas — aceitando que o problema se repetirá na próxima atualização de Electron.

O Zotero Integration (mgmeyers) não usa binários nativos. Ele opera via Better BibTeX, que você já tem instalado, e é completamente imune a atualizações do Electron. A importação é manual (acionada por hotkey), o que significa menos automação mas zero risco de quebra por atualização do Obsidian.

Resumo da troca:

	ZotLit	Zotero Integration
Anotações em tempo real	✅	❌ (manual)
Painel lateral de anotações	✅	❌
Imagens de anotações	✅	⚠️ limitado
Estabilidade entre atualizações	❌ quebra com Electron	✅ nunca quebra
Requer downgrade do Obsidian	Sim (atualmente)	Não
Mantenedor	1 pessoa	obsidian-community

Esta documentação adota o Zotero Integration como opção principal por estabilidade. As instruções do ZotLit estão preservadas na seção 8.3.3 para quem optar pelo downgrade.

8.3.2 Zotero Integration (opção recomendada)

Repositório: github.com/mgmeyers/obsidian-zotero-integration

Pré-requisito: Better BibTeX instalado no Zotero (já coberto na Seção 3.1).

Instalação:

Settings → Community plugins → Browse.
Pesquise por Zotero Integration (autor: mgmeyers).
Instale e ative o plugin.
Acesse Settings → Zotero Integration para configurar.

General Settings — passo a passo

As configurações globais ficam na seção General Settings do plugin, na seguinte ordem:

1. PDF Utility

O PDF Utility é a ferramenta externa pdfannots2json responsável por extrair as anotações dos PDFs. Sem ele, o plugin importa apenas metadados e resumo — nenhuma anotação é incluída.

Clique em Download e aguarde. Quando concluído, o status muda para "PDF utility is up to date".

⚠️ Obsidian instalado via Flatpak (Linux): o Flatpak roda em sandbox e não consegue persistir o executável baixado pelo botão Download entre sessões — o plugin voltará a pedir o download toda vez que for reaberto. A solução é instalar o binário manualmente e usar o campo PDF Utility Path Override.

Instalação manual do pdfannots2json (somente Flatpak no Linux):

# Criar diretório de destino acessível pelo Flatpak
mkdir -p ~/.local/share/zotero-integration

# Baixar o tar.gz da versão mais recente
wget -O /tmp/pdfannots2json.tar.gz \
  "https://github.com/mgmeyers/pdfannots2json/releases/download/1.0.16/pdfannots2json-linux.tar.gz"

# Descompactar — o arquivo extraído chama-se pdfannots2json (sem sufixo)
tar -xzf /tmp/pdfannots2json.tar.gz -C /tmp/

# Mover para o diretório de destino
mv /tmp/pdfannots2json ~/.local/share/zotero-integration/pdfannots2json

# Tornar executável
chmod +x ~/.local/share/zotero-integration/pdfannots2json

# Verificar
~/.local/share/zotero-integration/pdfannots2json --version

Em seguida, no campo PDF Utility Path Override, cole o caminho absoluto:

/home/<seu-usuário>/.local/share/zotero-integration/pdfannots2json

Feche e reabra o Obsidian — o status deve mostrar "PDF utility is up to date" de forma permanente.

Por que esse caminho funciona: o Flatpak do Obsidian tem permissão filesystems=home, ou seja, acesso completo ao diretório home do usuário. O caminho ~/.local/share/zotero-integration/ está dentro do home e é acessível pela sandbox.

Usuários que instalaram o Obsidian via AppImage ou .deb não enfrentam esse problema — o botão Download funciona normalmente e persiste entre sessões.

2. Database

Confirme que está selecionado Zotero (padrão). A alternativa é Juris-M, um fork do Zotero para pesquisa jurídica.

3. Note Import Location

Define a pasta raiz global onde todas as notas importadas serão criadas no vault.

Preencha com: Sources
Os Import Formats usarão esse caminho como base. Com Sources aqui e {{citekey}}.md no formato, a nota é criada em Sources/<citekey>.md.

4. Open the created or updated note(s) after import

Ative se quiser que o Obsidian abra automaticamente a nota recém-importada. Deixe desativado se preferir não ter a janela mudando de foco durante o trabalho.

5. Which notes to open after import

Define qual nota abrir após a importação: a primeira, a última, ou todas em abas separadas. Sugestão: First imported note.

Citation Formats

Os Citation Formats definem como as citações são inseridas inline no Obsidian quando você aciona o comando Insert Citation. Ao criar um formato, o campo Output Format é um seletor com seis opções predefinidas — não é um campo de texto livre:

Output Format	O que gera	Exemplo
LaTeX	Comando `\cite{}`	`\cite{silva2023carbon}`
BibLaTeX	Comando `\autocite{}`	`\autocite{silva2023carbon}`
Pandoc	Marcador Pandoc	`[@silva2023carbon]`
Formatted Citation	Citação formatada pelo estilo CSL ativo no Zotero	`(SILVA, 2023)`
Formatted Bibliography	Referência bibliográfica completa	`SILVA, J. Título...`
Template	Formato livre em Nunjucks	customizável

O estilo CSL usado pelo Formatted Citation e Formatted Bibliography é o estilo configurado em Zotero → Edit → Preferences → Cite → Styles. Para gerar ABNT, confirme que o estilo Associação Brasileira de Normas Técnicas (ABNT) está instalado e selecionado como padrão.

Fluxo 1 — LaTeX/Overleaf (fluxo principal recomendado)

O Obsidian funciona como PKM de pesquisa lateral — você faz suas notas de leitura e síntese aqui, e escreve o documento final no Overleaf. O Better BibTeX exporta o .bib continuamente para o Overleaf usar. O Citation Format no Obsidian serve apenas para registrar referências nas notas de leitura com o citekey correto — o Overleaf/LaTeX resolve a formatação ABNT na compilação.

Zotero Integration: importa artigo → nota em Sources/<citekey>.md
         ↓
Obsidian: fichamento, síntese, conexões entre artigos
         ↓
Overleaf: escrita final com \cite{citekey} ou [@citekey]
Better BibTeX: exporta .bib continuamente para o Overleaf

Por que essa separação faz sentido: o Overleaf resolve bem equações, templates de periódicos, compilação ABNT e colaboração pontual. O Obsidian resolve bem o que o Overleaf não resolve — organização do conhecimento ao longo de meses, conexões entre artigos de projetos diferentes, e o grafo que mostra quais leituras embasam cada argumento. Os dois se complementam sem conflito.

Configuração dos Citation Formats:

Crie dois formatos:

Formato 1 — para notas no Obsidian: 1. Clique em Add Citation Format. 2. Name: Pandoc 3. Output Format: Pandoc 4. Confirme.

Insere [@citekey] — compatível com Pandoc, Quarto e R Markdown.

Formato 2 — para copiar diretamente para o Overleaf: 1. Clique em Add Citation Format. 2. Name: LaTeX 3. Output Format: LaTeX 4. Confirme.

Insere \cite{citekey} — cole diretamente no código LaTeX do Overleaf.

Estilo ABNT no Overleaf:

No Overleaf, use o pacote abntex2cite:

\usepackage[alf]{abntex2cite}  % citações autor-data: (SILVA, 2023)
% ou
\usepackage[num]{abntex2cite}  % citações numéricas: [1]

Com o Better BibTeX exportando o .bib e o abntex2cite instalado, as citações são formatadas automaticamente em ABNT na compilação.

Fluxo 2 — Word / LibreOffice

O plugin do Zotero instalado no processador de texto cuida de tudo — citações e bibliografia são inseridas diretamente no documento com o estilo CSL da ABNT. O Obsidian não participa da escrita, apenas das notas de leitura. O campo Citation Format do Zotero Integration é irrelevante para esse fluxo.

Verificar o estilo ABNT no Zotero:

Edit → Preferences → Cite → Styles.
Verifique se Associação Brasileira de Normas Técnicas (ABNT) aparece na lista.
Se não aparecer, clique em Get additional styles → pesquise "ABNT" → instale.

Inserir citações no Word/LibreOffice:

Com o Zotero aberto, posicione o cursor no local da citação.
Na barra de ferramentas do Word/LibreOffice, clique em Add/Edit Citation.
Pesquise o item e confirme — a citação ABNT é inserida automaticamente.
Ao terminar o documento, clique em Add/Edit Bibliography para gerar a lista de referências.

Fluxo 3 — Obsidian (escrita direta)

Escrever diretamente no Obsidian faz sentido para documentos menores sem templates complexos — relatórios internos, sínteses de literatura, posts, resumos de projetos. Para teses, artigos com template de periódico ou documentos com equações complexas, o Overleaf continua sendo o ambiente correto.

A vantagem do Obsidian para escrita direta é a proximidade com suas notas de leitura — você escreve um parágrafo e a nota do artigo que o embasa está a um clique de distância no grafo. O documento final é compilado via Pandoc para PDF ou DOCX.

Configuração dos Citation Formats para ABNT:

O Output Format Formatted Citation já gera a citação formatada pelo estilo ABNT configurado no Zotero — sem precisar escrever templates manualmente. Crie dois formatos:

Formato 1 — citação entre parênteses (SILVA, 2023): 1. Clique em Add Citation Format. 2. Name: ABNT parênteses 3. Output Format: Formatted Citation 4. Confirme.

Formato 2 — citação com autor fora dos parênteses Silva (2023):

Este caso específico não tem opção direta no Formatted Citation — ele sempre gera o formato padrão do CSL. Para o autor fora dos parênteses, use Template: 1. Clique em Add Citation Format. 2. Name: ABNT inline 3. Output Format: Template 4. Template: {{authors[0].family | upper}}{% if authors | length > 1 %} et al.{% endif %} ({{date | format("YYYY")}}) 5. Confirme.

Compilação com Pandoc para PDF/DOCX:

Para compilar um documento Markdown do Obsidian com referências ABNT:

Instale o Pandoc:
Linux: sudo apt install pandoc -y
macOS: brew install pandoc
Windows: baixe o instalador em pandoc.org/installing.html
Baixe o CSL ABNT em zotero.org/styles pesquisando "ABNT" → salve como abnt.csl.
No frontmatter do documento Obsidian, adicione:

---
bibliography: /caminho/para/seu-arquivo.bib
csl: /caminho/para/abnt.csl
---

Compile:

# Para PDF
pandoc documento.md -o documento.pdf --citeproc

# Para DOCX
pandoc documento.md -o documento.docx --citeproc

O Better BibTeX mantém o .bib sempre atualizado com sua biblioteca Zotero.

Fluxo 4 — OnlyOffice Community

O OnlyOffice tem um plugin oficial do Zotero que funciona de forma similar ao Word — citações inseridas via painel lateral com estilo CSL. O Citation Format do Zotero Integration não se aplica a este fluxo.

Instalação do plugin Zotero no OnlyOffice:

Abra o OnlyOffice Desktop Editors.
Abra qualquer documento de texto.
Menu superior: Plugins → Plugin Manager.
Localize Zotero na lista e clique em Install.
Após a instalação, o Zotero aparece em Plugins → Zotero.

Se o plugin não aparecer no Plugin Manager, baixe o .oxt em github.com/ONLYOFFICE/onlyoffice-zotero e instale via Plugins → Plugin Manager → Upload.

Inserir citações no OnlyOffice:

Com o Zotero aberto, posicione o cursor no local da citação.
Plugins → Zotero → Add/Edit Citation.
O painel do Zotero abre — pesquise e selecione o item.
A citação ABNT é inserida no documento.
Para gerar a lista de referências: Plugins → Zotero → Add/Edit Bibliography.

O Zotero precisa estar aberto e em execução para o plugin do OnlyOffice funcionar.

Resumo comparativo dos quatro fluxos:

Fluxo	Ambiente de escrita	Output Format no Obsidian	Formatação ABNT
LaTeX/Overleaf	Overleaf	`Pandoc` ou `LaTeX`	`abntex2cite` na compilação
Word/LibreOffice	Word ou LibreOffice	Não usado	Plugin Zotero + CSL ABNT
Obsidian direto	Obsidian + Pandoc	`Formatted Citation`	`abnt.csl` via Pandoc
OnlyOffice	OnlyOffice Community	Não usado	Plugin Zotero + CSL ABNT

Import Formats

Os Import Formats definem os perfis de importação completa — nome do arquivo, pasta de destino e template da nota. Antes de configurar o formato no plugin, é necessário criar o arquivo de template no vault.

Passo 1 — Criar o arquivo de template no Obsidian:

O campo Template File no plugin é um seletor que busca arquivos já existentes no vault — não aceita digitação de caminho. O arquivo precisa existir antes de abrir as configurações do Import Format.

No painel esquerdo do Obsidian (File Explorer), clique com o botão direito na raiz do vault → New folder → nomeie Templates.
Clique com o botão direito na pasta Templates → New note → nomeie zotero-nota.
Cole o conteúdo do template abaixo na nota e salve (Ctrl+S):

---
title: "{{title}}"
authors: {% for author in authors %}[[{{author.family}}]]{% if not loop.last %}, {% endif %}{% endfor %}
year: {{date | format("YYYY")}}
journal: "{{publicationTitle}}"
doi: "{{DOI}}"
zotero: "{{pdfZoteroLink}}"
citekey: "{{citekey}}"
tags: [literature-note]
status: unread
---

## Resumo

{{abstractNote}}

## Anotações

{% for annotation in annotations -%}
- {% if annotation.color %}**{{annotation.colorCategory}}** {% endif %}(p. {{annotation.page}}): {{annotation.annotatedText}}{% if annotation.comment %} — *{{annotation.comment}}*{% endif %}
{% endfor %}

## Notas

{% persist "notas" %}
{% if isFirstImport %}
_Escreva aqui suas reflexões sobre o artigo._
{% endif %}
{% endpersist %}

O conteúdo aparecerá em vermelho no Obsidian — isso é esperado e não é um erro. O editor interpreta a sintaxe Nunjucks ({{}} e {%%}) como Markdown inválido e sublinha em vermelho. O arquivo não é lido pelo Obsidian como nota comum, mas sim pelo plugin Zotero Integration como template. Na importação, o Nunjucks substitui tudo corretamente.

O bloco {% persist "notas" %} é essencial. Ele protege tudo que você escrever entre as tags — sem ele, cada re-importação do item sobrescreve a nota inteira, apagando suas anotações pessoais.

Passo 2 — Criar o Import Format no plugin:

Com o arquivo de template criado, configure o formato:

Settings → Zotero Integration → Add Import Format.
Preencha os campos:
Name: Nota Literária
Output path: {{citekey}}.md (relativo ao Note Import Location Sources — resulta em Sources/<citekey>.md)
Image output path: ../Attachments/{{citekey}}/ (sobe um nível para criar fora da pasta Sources)
Template File: comece a digitar zotero no campo de busca → selecione Templates/zotero-nota quando aparecer.
Confirme.

Import Image Settings

Configurações para as imagens extraídas das anotações retangulares nos PDFs:

Image Format: jpg
Image Quality: 90
Image DPI: 120

Esses valores já são os padrões do plugin e oferecem boa qualidade com tamanho de arquivo razoável. Aumente o DPI para 150 se precisar de maior nitidez em figuras científicas.

Enable Annotation Concatenation

Quando ativado, anotações que começam com + são concatenadas à anotação anterior em vez de aparecerem como itens separados. Útil para quando você destaca um trecho longo em múltiplos blocos e quer que apareçam como um único item na nota. Deixe desativado por padrão — ative somente se usar esse padrão de anotação conscientemente.

Image OCR com Tesseract

O OCR permite extrair texto de anotações retangulares feitas sobre imagens dentro dos PDFs — útil para capturar texto de figuras, tabelas escaneadas ou artigos sem camada de texto.

Instalação do Tesseract por sistema operacional:

Linux (Debian/Ubuntu/Mint):

sudo apt update
sudo apt install tesseract-ocr tesseract-ocr-eng tesseract-ocr-por tesseract-ocr-spa -y

macOS:

brew install tesseract

# O pacote tesseract-lang instala todos os idiomas disponíveis
brew install tesseract-lang

# Ou instale idiomas individualmente:
# brew install tesseract-lang não existe em todas as versões do Homebrew
# Baixe os arquivos .traineddata em:
# https://github.com/tesseract-ocr/tessdata
# e coloque em: /usr/local/share/tessdata/ ou /opt/homebrew/share/tessdata/

Windows:

Baixe o instalador em github.com/UB-Mannheim/tesseract/wiki.
Durante a instalação, selecione os idiomas English, Portuguese e Spanish na lista de componentes opcionais.
Anote o caminho de instalação (padrão: C:\Program Files\Tesseract-OCR\).

Verificação dos idiomas instalados (Linux e macOS):

which tesseract
tesseract --list-langs

Saída esperada:

eng
osd
por
spa

Nota sobre o osd: é um módulo interno de detecção de orientação de página — não é um idioma de OCR. Não o inclua no campo Image OCR Language.

Configuração no Obsidian (Settings → Zotero Integration):

Role até a seção Image OCR e preencha os campos na seguinte ordem:

Campo	Valor
Image OCR (toggle)	✅ Ativado
Tesseract path	`/usr/bin/tesseract` (Linux) · resultado de `which tesseract` (macOS) · `C:\Program Files\Tesseract-OCR\tesseract.exe` (Windows)
Image OCR Language	`eng+por+spa`
Tesseract data directory	Deixar em branco (localizado automaticamente)

macOS Apple Silicon (M1/M2/M3): o caminho do Tesseract instalado via Homebrew geralmente é /opt/homebrew/bin/tesseract. Confirme com which tesseract no terminal.

Configurar o atalho de teclado:

Settings → Hotkeys → pesquise por Zotero Integration.
Atribua atalhos para os comandos que você usará com frequência:

Comando	Atalho sugerido
`Zotero Integration: Nota Literária`	`Ctrl+Shift+Z`
`Zotero Integration: Insert Pandoc Citation`	`Ctrl+Shift+C`

Uso no dia a dia:

Pressione Ctrl+Shift+Z → seletor de busca é aberto.
Digite o título ou autor → selecione o item.
O plugin cria Sources/<citekey>.md com metadados, resumo e anotações do PDF (incluindo OCR de imagens se ativado).
Para atualizar anotações após nova leitura no Zotero, acione o hotkey novamente sobre o mesmo item — o bloco persist protege suas notas pessoais.
Para inserir uma citação inline durante a escrita, pressione Ctrl+Shift+C → selecione o item → insere [@citekey].

8.3.3 Alternativa: ZotLit (requer downgrade do Obsidian)

⚠️ Leia antes de prosseguir. O ZotLit está incompatível com o Obsidian 1.11+ (Electron 39) desde janeiro de 2026, sem previsão de correção. Para usá-lo, é necessário fazer downgrade do Obsidian para a versão 1.10.x e desativar as atualizações automáticas. O problema voltará a ocorrer na próxima atualização significativa do Electron. Esta seção é mantida para quem aceitar esse trade-off em troca das funcionalidades exclusivas do ZotLit (sincronização em tempo real, painel ao vivo de anotações, suporte a imagens).

Downgrade do Obsidian para 1.10.x:

Acesse github.com/obsidianmd/obsidian-releases/releases.
Localize a release 1.10.x e baixe o instalador para seu sistema:
Linux: arquivo .AppImage
macOS: arquivo .dmg
Windows: arquivo .exe
Instale sobre a versão atual (seus dados e vault não são afetados).
Após instalar, desative atualizações automáticas: Settings → About → desmarque "Automatic updates".

Instalação do ZotLit:

Settings → Community plugins → Browse.
Pesquise por ZotLit e instale.
Ative o plugin — ele pedirá para baixar o binário better-sqlite3. Confirme.

Configuração — conectar ao banco do Zotero:

Settings → ZotLit → Connect.
Em Zotero data directory, informe o caminho se não for detectado automaticamente:
Linux: /home/<usuário>/Zotero
macOS: /Users/<usuário>/Zotero
Windows: C:\Users\<usuário>\Zotero
O campo deve ficar verde — conexão bem-sucedida.

Configuração — pastas de importação:

Settings → ZotLit → General.
Literature note folder: Sources.
Image folder: Attachments/images.
Image excerpt: Copy.

Template de nota literária (formato .eta):

---
title: "<%= it.title %>"
authors: <%= it.authors.map(a => `[[${a.lastName}]]`).join(', ') %>
year: <%= it.date?.year %>
journal: "<%= it.publicationTitle %>"
doi: "<%= it.DOI %>"
zotero: "<%= it.selectURI %>"
tags: [literature-note]
status: unread
---

## Resumo

<%= it.abstractNote %>

## Anotações

<% for (const annotation of it.annotations) { %>
- **<%= annotation.color %>** (p. <%= annotation.pageLabel %>): <%= annotation.comment || annotation.text %>
<% } %>

Uso no dia a dia:

Pressione Ctrl+Shift+Z para abrir o seletor de referências.
Selecione um item para criar a nota literária ou inserir a citação.
O painel lateral do ZotLit mostra as anotações em tempo real — arraste para a nota atual para importá-las.
Acompanhe o issue #452 no GitHub para saber quando o suporte ao Electron 39 for lançado.

8.4 Camada 2 — Claude Desktop + Zotero MCP

O servidor MCP para o Zotero permite ao Claude Desktop consultar sua biblioteca diretamente — buscar artigos por tema, recuperar metadados, ler notas e resumos — sem que você precise copiar e colar nada.

Pré-requisitos:

Python 3.9+ instalado (python3 --version).
uv instalado (instruções abaixo).
Claude Desktop instalado (instruções abaixo por sistema).

Instalação do Claude Desktop

Linux Mint:

O Anthropic não distribui o Claude Desktop oficialmente para Linux. O projeto da comunidade claude-desktop-debian (aaddrick) reempacota o app oficial do Windows em .deb nativo — sem Wine, sem containers — e suporta MCP completamente.

⚠️ Migração de repositório (abril 2026): o repositório APT foi migrado para pkg.claude-desktop-debian.dev. Instalações anteriores apontando para aaddrick.github.io precisam atualizar o sources.list.

# Adicionar chave GPG e repositório
curl -fsSL https://aaddrick.github.io/claude-desktop-debian/KEY.gpg | sudo gpg --dearmor -o /usr/share/keyrings/claude-desktop.gpg

echo "deb [signed-by=/usr/share/keyrings/claude-desktop.gpg arch=amd64,arm64] https://pkg.claude-desktop-debian.dev stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list

# Instalar
sudo apt update && sudo apt install claude-desktop

Após a instalação, abra o Claude Desktop pelo menu de aplicativos e faça login com sua conta Anthropic.

macOS:

Baixe o instalador oficial em claude.ai/download e siga as instruções de instalação padrão. Após a instalação, o Claude Desktop fica acessível pelo Launchpad ou Spotlight.

Windows:

Baixe o instalador .exe em claude.ai/download e execute. Após a instalação, o Claude Desktop aparece no menu Iniciar. O arquivo de configuração do MCP fica em %APPDATA%\Claude\claude_desktop_config.json.

Instalação do uv e do servidor Zotero MCP

Por que uv e não pip? O Linux Mint (e outras distribuições modernas) bloqueia instalações globais via pip com o erro externally-managed-environment. O uv contorna isso instalando ferramentas em ambientes isolados, sem conflito com os pacotes do sistema.

Linux Mint:

# Instalar o uv via script oficial
curl -LsSf https://astral.sh/uv/install.sh | sh

# Recarregar o PATH (necessário na mesma sessão do terminal)
source ~/.bashrc

# Confirmar instalação
which uvx
# Saída esperada: /home/<usuário>/.local/bin/uvx

macOS:

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.zshrc   # ou ~/.bash_profile dependendo do shell

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Instalar o servidor Zotero MCP (todos os sistemas):

uv tool install zotero-mcp-server

O comando instala o pacote zotero-mcp-server e expõe o executável zotero-mcp, usado pelo Claude Desktop via uvx.

Configuração da API local do Zotero

Passo 2 — Habilitar a API local do Zotero:

No Zotero: Edit → Preferences → Advanced.
Marque a opção "Allow other applications on this computer to communicate with Zotero".
Anote o número da porta exibida (padrão: 23119).

Passo 3 — Obter a chave de API e o Library ID:

A chave de API é necessária mesmo para a API local. Para obtê-la:

Acesse zotero.org/settings/keys.
Clique em Create new private key.
Marque Allow library access → Read Only (para consultas seguras).
Salve a chave gerada — ela aparece uma única vez, copie imediatamente.
Seu Library ID (número de usuário) aparece na mesma página, no bloco "Your userID for use in API calls".

Dica: se você esquecer o Library ID, o próprio Claude Desktop exibirá uma mensagem de erro com o número correto na primeira tentativa de uso — por exemplo: "use o userID 2535796".

Configuração do claude_desktop_config.json

Passo 4 — Configurar o Claude Desktop:

Localize e edite o arquivo de configuração do Claude Desktop:

Linux: ~/.config/Claude/claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione o bloco abaixo (crie o arquivo se não existir):

Linux Mint:

mkdir -p ~/.config/Claude
nano ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "zotero": {
      "command": "/home/<seu-usuário>/.local/bin/uvx",
      "args": ["--upgrade", "zotero-mcp"],
      "env": {
        "ZOTERO_LOCAL": "true",
        "ZOTERO_API_KEY": "SUA_CHAVE_AQUI",
        "ZOTERO_LIBRARY_ID": "SEU_LIBRARY_ID_AQUI"
      }
    }
  }
}

Por que usar o caminho absoluto do uvx no Linux? O Claude Desktop não herda o $PATH do usuário ao iniciar. Usando uvx sem caminho absoluto, o servidor MCP não é encontrado. Confirme o caminho com which uvx e use-o no campo "command".

macOS:

{
  "mcpServers": {
    "zotero": {
      "command": "uvx",
      "args": ["--upgrade", "zotero-mcp"],
      "env": {
        "ZOTERO_LOCAL": "true",
        "ZOTERO_API_KEY": "SUA_CHAVE_AQUI",
        "ZOTERO_LIBRARY_ID": "SEU_LIBRARY_ID_AQUI"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "zotero": {
      "command": "uvx",
      "args": ["--upgrade", "zotero-mcp"],
      "env": {
        "ZOTERO_LOCAL": "true",
        "ZOTERO_API_KEY": "SUA_CHAVE_AQUI",
        "ZOTERO_LIBRARY_ID": "SEU_LIBRARY_ID_AQUI"
      }
    }
  }
}

No macOS e Windows o uvx é encontrado automaticamente pelo PATH — não é necessário usar o caminho absoluto.

Passo 5 — Verificar a conexão:

Reinicie o Claude Desktop completamente.
Linux: pkill -f claude-desktop && sleep 2 && claude-desktop &
macOS/Windows: feche pelo menu e reabra normalmente.
Na interface do Claude Desktop, clique no ícone de conectores — deve aparecer zotero com o badge DEV LOCAL.
Teste com um prompt de busca: "Busque na minha biblioteca Zotero artigos sobre [seu tema]".

Ferramentas disponíveis no zotero-mcp: o servidor expõe três ferramentas — zotero_search_items (busca por texto), zotero_item_metadata (metadados de um item pelo ID) e zotero_item_fulltext (texto completo de um item). Listagem de coleções não está disponível como ferramenta direta — use buscas por tema.

O Zotero deve estar aberto enquanto você usa o MCP local — é a API local do app que responde às consultas.

8.5 Camada 3 — Claude Desktop + Obsidian MCP

Com o MCP do Obsidian configurado, o Claude Desktop passa a poder ler, criar e editar notas no seu vault — transformando-o em um colaborador ativo na gestão do conhecimento.

Pré-requisitos:

Obsidian aberto com o vault de pesquisa ativo.
uv instalado (já instalado se você fez a Camada 2).

Passo 1 — Instalar o plugin Local REST API no Obsidian:

Settings → Community plugins → Browse.
Pesquise por "Local REST API" (autor: Adam Coddington).
Instale e ative o plugin.
Vá em Settings → Local REST API:
Anote a API Key gerada automaticamente (string longa hexadecimal).
O plugin expõe duas portas: 27124 (HTTPS) e 27123 (HTTP). Use a porta 27123 (HTTP) na configuração do MCP — o mcp-obsidian não usa HTTPS por padrão.

Passo 2 — Instalar o servidor MCP para Obsidian:

uv tool install mcp-obsidian

Passo 3 — Adicionar ao claude_desktop_config.json:

Edite o mesmo arquivo da Camada 2. O arquivo completo com os dois servidores fica assim:

Linux Mint:

{
  "mcpServers": {
    "zotero": {
      "command": "/home/<seu-usuário>/.local/bin/uvx",
      "args": ["--upgrade", "zotero-mcp"],
      "env": {
        "ZOTERO_LOCAL": "true",
        "ZOTERO_API_KEY": "SUA_CHAVE_ZOTERO",
        "ZOTERO_LIBRARY_ID": "SEU_LIBRARY_ID"
      }
    },
    "obsidian": {
      "command": "/home/<seu-usuário>/.local/bin/uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "SUA_API_KEY_DO_OBSIDIAN",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27123"
      }
    }
  }
}

macOS:

{
  "mcpServers": {
    "zotero": {
      "command": "uvx",
      "args": ["--upgrade", "zotero-mcp"],
      "env": {
        "ZOTERO_LOCAL": "true",
        "ZOTERO_API_KEY": "SUA_CHAVE_ZOTERO",
        "ZOTERO_LIBRARY_ID": "SEU_LIBRARY_ID"
      }
    },
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "SUA_API_KEY_DO_OBSIDIAN",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27123"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "zotero": {
      "command": "uvx",
      "args": ["--upgrade", "zotero-mcp"],
      "env": {
        "ZOTERO_LOCAL": "true",
        "ZOTERO_API_KEY": "SUA_CHAVE_ZOTERO",
        "ZOTERO_LIBRARY_ID": "SEU_LIBRARY_ID"
      }
    },
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "SUA_API_KEY_DO_OBSIDIAN",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27123"
      }
    }
  }
}

Porta HTTP vs HTTPS: o Local REST API expõe a porta 27124 (HTTPS) e 27123 (HTTP). Use sempre a 27123 com o mcp-obsidian — o cliente não valida certificados autoassinados e a conexão local via HTTP é igualmente segura.

Passo 4 — Verificar:

Reinicie o Claude Desktop.
Linux: pkill -f claude-desktop && sleep 2 && claude-desktop &
macOS/Windows: feche e reabra normalmente.
No painel de conectores, devem aparecer tanto zotero (badge DEV LOCAL) quanto obsidian (badge RUNNING).
Teste: "Liste os arquivos na raiz do meu vault do Obsidian".

⚠️ Atenção de segurança: o MCP do Obsidian concede ao Claude Desktop acesso completo de leitura e escrita ao vault. Mantenha um backup regular (o próprio Google Drive já cobre isso se o vault estiver dentro da pasta sincronizada). Nunca compartilhe publicamente a API Key do Local REST API.

8.6 Uso combinado — prompts validados

Com as três camadas ativas, o Claude Desktop torna-se um assistente de pesquisa com contexto completo sobre sua biblioteca e suas notas. Os prompts abaixo foram validados em ambiente real (Linux Mint 22, abril de 2026).

Busca cruzada — fichados vs. não fichados

"Busque na minha biblioteca Zotero artigos sobre mercúrio em bacias hidrográficas. Para cada um que encontrar, verifique se já existe uma nota no meu vault do Obsidian e me diga quais ainda não foram fichados."

O Claude consulta o Zotero via zotero_search_items, lista as notas do vault via MCP do Obsidian, faz a comparação e retorna os artigos não fichados com avaliação de relevância para o projeto.

Geração de notas literárias em lote

"Crie notas de leitura no vault para os artigos [título 1] e [título 2] da minha biblioteca Zotero."

O Claude busca os metadados via zotero_item_metadata, cria arquivos .md estruturados no vault com referência bibliográfica, tabela de metadados, checklist de leitura, seções para anotações e tags temáticas.

Síntese metodológica entre fontes

"Leia as notas fichadas sobre [tema] no meu vault e identifique lacunas metodológicas que minha pesquisa de GNN pode endereçar."

O Claude lê os fichamentos existentes no Obsidian e gera uma análise estruturada de lacunas, mapeando cada uma para uma solução específica da abordagem GNN, com matriz de impacto e roadmap de implementação.

Persistência de análise no vault

"Salve essa análise de lacunas como uma nota no vault com o roadmap de implementação."

O Claude cria um arquivo .md completo com frontmatter, análise de lacunas detalhada, pseudo-código de implementação e cronograma de fases — tudo persistido no vault para referência futura.

Revisão de cobertura da literatura

"Leia as notas que estão no meu vault do Obsidian e me diga quais artigos do Zotero ainda não foram fichados sobre o tema [tema]."

Variação do primeiro prompt — útil para revisões periódicas durante o processo de escrita da tese.

Nota sobre consumo de tokens: o MCP busca apenas os itens relevantes para cada prompt, evitando que você cole todo o conteúdo manualmente. O ganho principal não é econômico, mas de fluxo — o Claude localiza automaticamente as informações sem que você precise abrir arquivos ou lembrar onde cada dado está.

Sobre vaults múltiplos: o MCP do Obsidian aponta para o vault que estiver aberto no momento. Para alternar contexto (ex: doutorado → Fiocruz), basta trocar o vault ativo no Obsidian antes de iniciar a conversa no Claude Desktop. Recomenda-se manter vaults separados para contextos profissionais completamente distintos (ex: doutorado-unb, fiocruz, ifb) e um único vault por contexto com subpastas por projeto.

8.7 Gantt no Obsidian — visualização de roadmap de pesquisa

O Obsidian oferece duas abordagens para criar Gantt charts, adequadas para visualizar roadmaps de tese, cronogramas de fases de pesquisa ou planos de projeto.

8.7.1 Mermaid nativo (sem plugin — recomendado para começar)

O Obsidian suporta Mermaid nativamente desde a versão 1.0. Nenhum plugin adicional é necessário.

Crie um bloco de código com a linguagem mermaid em qualquer nota:

```mermaid
gantt
    title Roadmap GNN — Mercúrio em Bacias Hidrográficas
    dateFormat  YYYY-MM-DD
    section Fase 1 · Fundação
    GCN simples na bacia Madeira        :f1, 2026-05-01, 90d
    section Fase 2 · Hidro-Geomorfologia
    Integração QSWAT+                   :f2, after f1, 90d
    section Fase 3 · Biogeoquímica
    Grafo heterogêneo                   :f3, after f2, 90d
    section Fase 4 · Temporal-Espacial
    T-GNN (milestone crítico)           :crit, f4, after f3, 90d
    section Fase 5 · Transfer Learning
    Aplicação Rio Acre                  :crit, f5, after f4, 90d
    section Fase 6 · Fontes & Mitigação
    Rastreamento de origem              :f6, after f5, 90d
    section Fase 7 · Documentação
    Papers + GitHub                     :f7, after f6, 180d
```

O Obsidian renderiza o gráfico diretamente em modo Preview (Ctrl+E). O modificador crit destaca barras em vermelho como milestones críticos. Use after <id> para encadear fases automaticamente sem precisar calcular datas.

Limitações do Mermaid: não permite arrastar barras, não tem dependências visuais interativas e não sincroniza com tarefas do vault.

8.7.2 Obsidian-PM (plugin com Gantt interativo)

Para gerenciamento de projetos mais completo — com arrastar e soltar, dependências visuais e rastreamento de progresso — instale o Obsidian-PM:

Settings → Community plugins → Browse
Pesquise "Obsidian-PM"
Instale e ative
Clique com botão direito em qualquer pasta do vault → New project
Dentro do projeto, alterne entre as abas Table, Kanban e Gantt

O Obsidian-PM salva tudo como Markdown puro — os dados não ficam presos em formato proprietário.

Quando usar cada um: use o Mermaid para documentar cronogramas em notas de projeto (simples, portável, funciona em qualquer exportação). Use o Obsidian-PM quando precisar gerenciar ativamente um projeto com múltiplas tarefas, responsáveis e dependências em andamento.

[Linux] rclone: "Transport endpoint is not connected"

O ponto de montagem ficou em estado zumbi. Execute:

systemctl --user stop rclone-gdrive.service
fusermount3 -u ~/Gdrive
systemctl --user start rclone-gdrive.service

[Linux] rclone não inicia com o sistema

Verifique se o linger está habilitado para seu usuário (necessário para serviços --user iniciarem antes do login gráfico):

loginctl enable-linger $USER

[Linux] Attanger não move os arquivos

Confirme que ~/Gdrive está montado (ls ~/Gdrive deve listar arquivos).
Confirme que Base Directory aponta para o caminho absoluto correto (com /home/<usuário>/ explícito, não ~/).
Confirme que Rename linked files está marcado.

[Linux] Attanger perde o link após reinicialização

O rclone precisa estar montado antes do Zotero ser aberto. Garanta que o serviço systemd está habilitado:

systemctl --user enable rclone-gdrive.service
systemctl --user status rclone-gdrive.service

[macOS] Attanger não encontra a pasta do Drive

O caminho do volume do Google Drive pode mudar após atualizações do cliente. Abra o Finder, localize a pasta doutorado-unb-2026 dentro do Google Drive, arraste-a para o Terminal para confirmar o caminho atual e atualize o Base Directory no Attanger.

[macOS] PDFs abrem lentamente no Zotero

O cliente do Drive está no modo Stream (padrão). Mude para Mirror files em Google Drive → Preferences → Google Drive → Mirror files para manter uma cópia local completa.

[Windows] Letra da unidade G: não aparece

O Google Drive para Desktop às vezes não monta a unidade automaticamente após a reinicialização. Abra o cliente pelo ícone na bandeja do sistema e aguarde a sincronização. Se persistir, vá em Preferences → Google Drive e confirme que a opção de unidade virtual está ativa.

[Windows] Caminho com espaços causa erro no Attanger

Evite editar o campo Base Directory manualmente. Use sempre o botão Browse para navegar até G:\My Drive\doutorado-unb-2026 — isso garante que o caminho seja registrado corretamente, incluindo aspas quando necessário.

[Todos] Attanger não move os arquivos após adicionar PDF manualmente

Quando um PDF é adicionado via Add Attachment → Attach Stored Copy of File, o Attanger pode não detectá-lo automaticamente. Clique com o botão direito no item → Attanger → Move and Rename Attachment para forçar a operação.

[Todos] Better BibTeX: chaves duplicadas

Em Tools → Better BibTeX → Open Better BibTeX Preferences → Citation keys, marque Force citation key para itens com conflito, ou adicione um sufixo manual diretamente no campo Citation Key do item.

[Todos] Zotero Connector não detecta PDF

Alguns sites bloqueiam download direto. Nesse caso:

Baixe o PDF manualmente.
No Zotero, selecione o item → Add Attachment → Attach Stored Copy of File.
Clique com o botão direito → Attanger → Move and Rename para mover para o Drive.

[Todos] scite.ai não carrega badges

Verifique se está logado na conta scite dentro do plugin (Edit → Preferences → scite).
Alguns DOIs não estão indexados no scite; isso é esperado para artigos muito recentes ou de periódicos de nicho.

[Zotero Integration] PDF Utility pede download toda vez que o plugin é reaberto

Problema específico do Obsidian instalado via Flatpak no Linux. O Flatpak roda em sandbox e não consegue persistir o executável baixado pelo botão Download entre sessões.

Solução: instale o binário manualmente e configure o PDF Utility Path Override conforme descrito na seção 8.3.2. O caminho a usar é:

/home/<seu-usuário>/.local/share/zotero-integration/pdfannots2json

Após configurar o Path Override e reiniciar o Obsidian, o status deve mostrar "PDF utility is up to date" de forma permanente.

Usuários que instalaram o Obsidian via AppImage ou .deb não enfrentam esse problema.

[MCP] Claude Desktop não reconhece o servidor Zotero ou Obsidian

Confirme que o arquivo claude_desktop_config.json é JSON válido (sem vírgula após o último item de cada bloco).
Reinicie o Claude Desktop completamente após qualquer edição no arquivo de configuração.
Linux: pkill -f claude-desktop && sleep 2 && claude-desktop &
Linux: use sempre o caminho absoluto do uvx no campo "command" (ex: /home/<usuário>/.local/bin/uvx). O Claude Desktop não herda o $PATH do usuário — "command": "uvx" sem caminho absoluto não funciona no Linux.
O Zotero precisa estar aberto e a API local habilitada (Edit → Preferences → Advanced → Allow other applications...).
O Obsidian precisa estar aberto com o vault ativo e o plugin Local REST API habilitado.

[MCP] Erro de autenticação no Zotero MCP ("authentication error" ou "library not found")

Verifique se os valores no claude_desktop_config.json foram preenchidos corretamente — os placeholders SUA_CHAVE_AQUI e SEU_LIBRARY_ID_AQUI são erros comuns. Confirme também o Library ID: na primeira tentativa com ID incorreto, o Claude Desktop exibe uma mensagem de erro com o número correto (ex: "use o userID 2535796"). Use esse número no campo ZOTERO_LIBRARY_ID.

[MCP] ZotLit não encontra o banco de dados do Zotero

Confirme o caminho do data directory em Zotero → Edit → Preferences → Advanced → Data Directory Location.
Cole esse caminho exato em Obsidian → Settings → ZotLit → Connect → Zotero data directory.
O campo deve ficar verde. Se ficar vermelho, verifique se o Zotero foi aberto ao menos uma vez desde o último boot (o arquivo zotero.sqlite precisa existir).

[MCP] Obsidian MCP retorna "API key not configured" ou erro de conexão

A API Key gerada pelo plugin Local REST API muda se o plugin for desinstalado e reinstalado. Acesse Settings → Local REST API no Obsidian, copie a chave atual e atualize o campo OBSIDIAN_API_KEY no claude_desktop_config.json.

Confirme também que está usando a porta 27123 (HTTP) e não a 27124 (HTTPS) — o mcp-obsidian não suporta HTTPS por padrão.

[ZotLit] "The electron in current version of Obsidian is newer than the one supported by installed ZotLit"

Esse aviso indica que o Obsidian foi atualizado para uma versão do Electron mais recente do que a suportada pelo ZotLit instalado. A partir do Obsidian 1.11 (Electron 39), o ZotLit 1.1.11 — versão mais recente disponível — não carrega em nenhum sistema operacional.

Solução recomendada: migrar para o Zotero Integration, conforme descrito na seção 8.3.2. Não requer downgrade do Obsidian e é imune a esse tipo de quebra.

Solução alternativa: fazer downgrade do Obsidian para 1.10.x conforme descrito na seção 8.3.3. Resolve temporariamente, mas o problema voltará na próxima atualização significativa do Electron.

Acompanhe o status do fix oficial em: github.com/PKM-er/obsidian-zotlit/issues/452

Referências e recursos adicionais

Nota sobre plugins com problemas de compatibilidade (Zotero 7)

Os plugins abaixo foram testados e apresentaram incompatibilidades com o Zotero 7 no momento da elaboração desta documentação. Verifique os repositórios para versões atualizadas antes de tentar instalá-los:

Plugin	Problema conhecido
Zotero DOI Manager (bwiernik)	v1.5.0 disponível para Zotero 7, mas busca de shortDOIs com falhas; limpeza e validação funcionam
Citation Counts Manager (eschnett v1.3.0)	Incompatível com Zotero 7 — usar fork FrLars21 v2.0, também beta
Zotero Storage Scanner	Verificar compatibilidade com Zotero 7 antes de instalar

Documentação preparada com base na configuração real do ambiente de doutorado (Linux Mint 22, UnB/PPGCA, 2026). Seções MCP validadas em abril de 2026 com zotero-mcp-server, mcp-obsidian e claude-desktop-debian.