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

Versão: Zotero 7.x | Última revisão: Junho 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); acesso ao texto completo via proxy CAPES Periódicos e Sci-Hub; armazenamento de PDFs com Google Drive (rclone no Linux Mint, cliente oficial no macOS e Windows) ou via WebDAV (Koofr); 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), incluindo leitura e conversão de PDFs para Markdown via MarkItDown MCP.

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

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, seus PDFs 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 ou Koofr WebDAV	PDFs acessíveis em qualquer dispositivo, renomeados e organizados automaticamente
Descoberta	ResearchRabbit	Mapeia redes de citação, sugere artigos relacionados, identifica autores-chave
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, leitura de PDFs via MarkItDown, geração de notas literárias, análise de lacunas metodológicas

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 converte qualquer PDF para Markdown via MarkItDown MCP, sem necessidade de copiar texto manualmente.
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 três fontes são consultadas simultaneamente: "quais artigos sobre mercúrio ainda não foram fichados?" é uma pergunta que o Claude responde comparando os três 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

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
Zotero Connector e acesso ao texto completo
Plugins Essenciais
Sincronização com Google Drive — Linux Mint (rclone)
Armazenamento de PDFs via Koofr WebDAV
Configuração do Attanger com o Google Drive
Integração com ResearchRabbit
Fluxo de trabalho completo
Ecossistema Obsidian + Claude Desktop + Zotero via MCP
Solução de problemas
Referências e recursos adicionais

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
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.

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).

winget (alternativo):

winget install Zotero.Zotero

2. Zotero Connector e acesso ao texto completo

O Connector é uma extensão de navegador que permite salvar referências diretamente de páginas web e bases de dados 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 desejado e clique no ícone do Connector na barra de ferramentas. Em páginas de resultados (Google Scholar, PubMed), o Connector detecta múltiplos itens e oferece seleção em lote.

2.1 Proxy CAPES Periódicos (ez54) — acesso institucional UnB

O Portal de Periódicos da CAPES utiliza EZproxy por baixo do CAFe. O servidor da UnB é o ez54. Com essa configuração, o Connector detecta artigos de publishers assinados (ScienceDirect, Springer, ACS, Taylor & Francis, RSC, ASM etc.) e os redireciona automaticamente pelo proxy da CAPES ao salvar, baixando o PDF junto com os metadados.

Como confirmar o servidor da sua instituição:

Autentique-se via CAFe no Portal CAPES e acesse qualquer artigo de um publisher. O subdomínio na barra de endereço identifica o servidor:

www-sciencedirect-com.ez54.periodicos.capes.gov.br
                         ^^^^
                         servidor da UnB

Configuração no Zotero Connector:

Clique com o botão direito no ícone do Connector → Opções (Chrome) ou Preferências (Firefox).
Acesse a aba Proxies.
Marque Enable proxy redirection.
Clique no + para adicionar um novo proxy e preencha:

Campo	Valor
Login URL	`https://ez54.periodicos.capes.gov.br/login?url=%u`
Proxied URL	`%h.ez54.periodicos.capes.gov.br/%p`

Marque Automatically associate new hosts.
Deixe desmarcado "Automatically convert between dots and hyphens" — o CAPES usa hífens no padrão www-sciencedirect-com, não pontos.

Usuários de outras instituições: substitua ez54 pelo servidor identificado na barra de endereço após autenticação via CAFe. Cada instituição brasileira pode usar um servidor diferente (ez1, ez24, ezl, ez54 etc.).

Fluxo de uso:

Autentique-se via CAFe no Portal CAPES uma vez no navegador.
Ao salvar um artigo pelo Connector em qualquer publisher assinado, ele usa a sessão ativa para baixar o PDF automaticamente.
À medida que você navega por publishers autenticados, o Connector aprende e associa novos hosts automaticamente.

2.2 Sci-Hub como resolvedor de PDFs (fallback)

Para artigos não cobertos pela assinatura institucional da CAPES, o Zotero pode ser configurado para buscar PDFs automaticamente via Sci-Hub ao usar o recurso Encontrar texto completo.

Importante: esta configuração aplica-se à função "Encontrar texto completo" do Zotero desktop. Ela atua como fallback para artigos já na biblioteca sem PDF. O mecanismo do proxy CAPES (seção 2.1) é o meio primário; o Sci-Hub é o recurso secundário.

Como configurar:

No Zotero desktop: Editar → Configurações → Avançado → Editor de configurações.
Clique em Accept the Risk and Continue.
No campo de busca, digite resolve.
Localize extensions.zotero.findPDFs.resolvers e clique no ícone de lápis (editar).
Substitua o conteúdo pelo JSON abaixo e salve:

{
  "name": "Sci-Hub",
  "method": "GET",
  "url": "https://sci-hub.ee/{doi}",
  "mode": "html",
  "selector": "#pdf",
  "attribute": "src",
  "automatic": true
}

Como usar:

Selecione um ou mais artigos na biblioteca → clique com o botão direito → Encontrar texto completo.
O Zotero tentará primeiro fontes de acesso aberto (Unpaywall) e usará o Sci-Hub como fallback para artigos com DOI.

Adicionar artigos por identificador:

Use o ícone de varinha mágica na barra de ferramentas (Adicionar itens segundo identificador), cole o identificador e pressione Enter. É possível colar múltiplos identificadores de uma vez, um por linha.

Identificador	Exemplo
DOI	`10.1016/j.chemosphere.2021.130000`
ISBN	`978-85-387-0278-8`
PMID	`34567890`
arXiv ID	`2301.00001`

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.

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 6.

3.3 Better Notes

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

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.
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

Configuração:

Edit → Preferences → Translate.
Selecione o serviço (recomendado: DeepL Free — requer chave gratuita em deepl.com).
Idioma de destino: Português (BR).

3.5 scite.ai

Função: Mostra citações contextuais — se um artigo foi citado de forma supporting, contrasting ou mentioning por outros trabalhos.

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

Instalação: Acesse https://scite.ai/zotero para baixar o .xpi oficial.

3.6 PapersGPT

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

Instalação: Baixe o .xpi em Releases e configure a chave de API em Edit → Preferences → PapersGPT.

3.7 PubPeer

Função: Exibe alertas quando há comentários de revisão pós-publicação no PubPeer — plataforma onde pesquisadores discutem anonimamente problemas em artigos publicados.

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

O plugin verifica por DOI — itens sem DOI não são checados. 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.

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

Este plugin é relevante apenas para quem usa o Notion. Para usuários do Obsidian, consulte a Seção 9.

Configuração:

Crie uma integração em notion.so/my-integrations e copie o token.
Compartilhe o banco de dados do Notion com a integração.
No Zotero: Edit → Preferences → Notero → cole o token e o Database ID.

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. Consulte a Seção 6 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.

4.1 Instalação do rclone

sudo apt update && sudo apt install rclone -y
rclone version

4.2 Configuração do remote gdrive

rclone config

Prompt	Resposta
`n) New remote`	`n`
`name>`	`gdrive`
`Storage>`	Número do Google Drive na lista
`scope>`	`1` (Full access)
`Use auto config?`	`y`
`Configure this as a Shared Drive?`	`n`

Verificação:

rclone lsd gdrive:

4.3 Criação do ponto de montagem

mkdir -p ~/Gdrive

# Teste manual
rclone mount gdrive: ~/Gdrive --vfs-cache-mode full --daemon
ls ~/Gdrive

# Desmontar o teste
fusermount3 -u ~/Gdrive

4.4 Serviço systemd --user

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

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

[Service]
Type=simple
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 72h \
    --vfs-cache-poll-interval 1m
ExecStartPost=-/bin/bash -c 'sleep 10 && \
    while IFS= read -r folder; do \
        [ -z "$$folder" ] && continue; \
        ls -R %h/Gdrive/"$$folder" > /dev/null 2>&1; \
    done < %h/.config/rclone-persistent/folders.txt'
ExecStop=/bin/fusermount3 -u %h/Gdrive
Restart=on-failure
RestartSec=10

[Install]
WantedBy=default.target

systemctl --user daemon-reload
systemctl --user start rclone-gdrive.service
systemctl --user enable rclone-gdrive.service
systemctl --user status rclone-gdrive.service

Parâmetro	Função
`--vfs-cache-mode full`	Cache local completo
`--vfs-cache-max-age 168h`	Mantém arquivos em cache por 7 dias
`--vfs-cache-max-size 10G`	Limite de 10 GB de cache local
`--vfs-read-chunk-size 128M`	Chunks de 128 MB (melhor para PDFs)
`--dir-cache-time 72h`	Índice de diretórios em cache por 3 dias

4.5 Pastas persistentes (pré-cache no boot)

mkdir -p ~/.config/rclone-persistent
echo "doutorado-unb-2026" > ~/.config/rclone-persistent/folders.txt

Para adicionar pastas:

echo "Obsidian" >> ~/.config/rclone-persistent/folders.txt
nano ~/.config/rclone-persistent/folders.txt

Exemplo com múltiplas pastas:

doutorado-unb-2026
Obsidian
estudo-musica

Aplicar mudanças:

systemctl --user restart rclone-gdrive.service

5. Armazenamento de PDFs via Koofr WebDAV

O Zotero suporta WebDAV como backend alternativo para sincronização de anexos (PDFs), independente do Google Drive e do Attanger.

Separação de responsabilidades:

Metadados (referências, notas, tags): sincronizados pelo Zotero.org — gratuito e ilimitado.

Anexos (PDFs): sincronizados via WebDAV — armazenados no Koofr ou em servidor próprio.

Arquivos WebDAV não ficam acessíveis pela biblioteca web do Zotero (zotero.org/mylibrary). O acesso aos PDFs é feito pelo Zotero desktop ou app mobile.

5.1 Koofr — serviço WebDAV gratuito (10 GB)

O Koofr oferece 10 GB de armazenamento gratuito com suporte nativo a WebDAV, sem necessidade de infraestrutura própria.

Criação da conta e ativação do WebDAV:

Acesse koofr.eu e crie uma conta gratuita.
Após o login, acesse Configurações → Senha do aplicativo.
Crie uma senha de aplicativo específica para o Zotero (ex.: "Zotero WebDAV").
Anote a senha gerada — ela será usada no lugar da senha principal.

Configuração no Zotero desktop:

Editar → Configurações → Sincronização.
Na seção Sincronização de arquivos, marque Sincronizar arquivos anexados em Minha Biblioteca usando.
No menu suspenso, selecione WebDAV.
Preencha os campos:

Campo	Valor
URL	`https://app.koofr.net/dav/Koofr/`
Usuário	seu e-mail do Koofr
Senha	senha de aplicativo criada acima

Clique em Verificar servidor — deve aparecer "Verificação bem-sucedida".
Clique em Sincronizar agora para iniciar o upload dos PDFs existentes.

Formato dos arquivos: o Zotero envia os PDFs compactados como .zip acompanhados de arquivos .prop de metadados. Isso é esperado e não indica erro.

Liberar o armazenamento do Zotero.org:

Após confirmar que os PDFs estão no Koofr, esvazie o armazenamento do Zotero.org:

Acesse zotero.org/settings/storage.
Clique em Purge Storage in My Library.
Confirme — isso remove apenas os arquivos no servidor do Zotero, não afeta sua biblioteca local nem o Koofr.

5.2 WebDAV self-hosted no Oracle Cloud VPS (avançado)

Para quem já possui VPS com Docker e Nginx Proxy Manager, é possível hospedar o próprio servidor WebDAV sem custo adicional.

Deploy via Docker Compose:

services:
  zotero-webdav:
    image: bytemark/webdav
    restart: unless-stopped
    environment:
      AUTH_TYPE: Digest
      USERNAME: seu_usuario
      PASSWORD: sua_senha_forte
      LOCATION: /zotero/
    volumes:
      - ./data:/var/lib/dav

Exposta via Nginx Proxy Manager com HTTPS em webdav.seudominio.net, a configuração no Zotero segue o mesmo padrão:

Campo	Valor
URL	`https://webdav.seudominio.net/zotero/`
Usuário	seu_usuario
Senha	sua_senha_forte

5.3 Comparativo das opções de armazenamento

Opção	Custo	Armazenamento	Acesso web	Manutenção
Zotero.org (gratuito)	Grátis	300 MB	✅ Sim	Nenhuma
Zotero.org (pago)	US$ 20–120/ano	2–25 GB	✅ Sim	Nenhuma
Koofr WebDAV	Grátis	10 GB	❌ Não	Mínima
WebDAV self-hosted	Grátis (VPS próprio)	Ilimitado	❌ Não	Alta
Google Drive + Attanger	Grátis (15 GB)	15 GB	✅ Google Drive	Média

Koofr + Attanger: as duas abordagens são mutuamente exclusivas para o mesmo conjunto de arquivos. Se usar WebDAV (Koofr), o Zotero gerencia o armazenamento dos PDFs internamente — o Attanger não é necessário para movê-los.

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

Esta seção aplica-se apenas a quem usa o Google Drive + Attanger como estratégia de armazenamento. Se você optou pelo Koofr WebDAV (Seção 5), pule esta seção.

6.1 Linux Mint — diretório montado via rclone

No Zotero: Edit → Preferences → Attanger → Base Directory → Browse.
Selecione:

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

Use o caminho absoluto. Evite ~/Gdrive/doutorado-unb-2026 — alguns builds do Zotero não expandem o til corretamente.

6.2 macOS — cliente oficial do Google Drive

Instale o Google Drive para Desktop (drive.google.com/drive/download).
Edit → Preferences → Attanger → Base Directory → Browse.
Navegue até Google Drive → My Drive → doutorado-unb-2026.

Modo Mirror (recomendado): Google Drive → Preferences → Google Drive → Mirror files.

6.3 Windows — cliente oficial do Google Drive

Instale o Google Drive para Desktop.
Edit → Preferences → Attanger → Base Directory → Browse.
Navegue até G:\My Drive\doutorado-unb-2026.

Use sempre o botão Browse — não altere o campo de texto manualmente.

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

A renomeação é configurada nas preferências nativas do Zotero, não no Attanger.

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

Modelo recomendado:

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

Exemplo: Silva - 2023 - Carbon flux in Amazonian watersh

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

Em Edit → Preferences → General → File Renaming, marque Rename linked files. Sem isso, o Zotero não aplica o modelo de renomeação aos arquivos linkados pelo Attanger.

Sistema	Attanger — Base Directory	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

7. Integração com ResearchRabbit

Criação de conta e conexão:

Acesse https://www.researchrabbit.ai e crie uma conta gratuita.
Clique em Connect Zotero → autorize o acesso OAuth.

Sincronização de coleções:

Collections → Import from Zotero.
Selecione as coleções desejadas.

Funcionalidades principais:

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

8. Fluxo de trabalho completo

┌──────────────────────────────────────────────────────────────────────────┐
│                         FLUXO DE PESQUISA                                │
│                                                                          │
│  Navegador ──[Connector + proxy ez54]──▶  Zotero ◀──[OAuth]── ResearchRabbit │
│                                               │                          │
│                              ┌────────────────┴────────────────┐        │
│                         Attanger                           Koofr WebDAV │
│                    (Google Drive)                    (PDFs via WebDAV)   │
│                              │                                           │
│                         ☁️ Drive                                         │
│                                                                          │
│  Zotero (biblioteca) ──[Zotero Integration]──▶  Obsidian vault           │
│                    │                                   │                 │
│               [MCP Zotero]                       [MCP Obsidian]          │
│                    └──────────────┬────────────────────┘                 │
│                                   ▼                                      │
│                            Claude Desktop                                │
│                                   │                                      │
│                          [MCP MarkItDown]                                │
│                                   │                                      │
│                    ┌──────────────┴──────────────┐                       │
│               PDFs locais                   PDFs no Drive                │
│              (file:// via rclone)      (https:// URL pública)            │
│                                                                          │
│  Zotero (refs) ──[Better BibTeX]──▶  .bib ──▶  LaTeX / Quarto           │
└──────────────────────────────────────────────────────────────────────────┘

Passo a passo típico:

Encontrou um artigo no Google Scholar ou ResearchRabbit.
Clique no Zotero Connector — salva metadados + PDF via proxy ez54 se disponível via CAPES, ou via Sci-Hub como fallback.
O Attanger move o PDF para a pasta do Drive com renomeação automática (ou o Koofr WebDAV sincroniza em background).
O Zotero Integration cria a nota literária no Obsidian via hotkey.
No Claude Desktop, consulte a biblioteca, converta PDFs via MarkItDown e escreva notas no vault, tudo via MCP.
O Better BibTeX exporta o .bib atualizado para LaTeX/Quarto.

9. Ecossistema Obsidian + Claude Desktop + Zotero via MCP

9.1 Visão geral da arquitetura

Camada	Tecnologia	O que conecta	O que permite
1	Zotero Integration	Zotero → Obsidian	Importar referências como notas Markdown 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
4	MarkItDown MCP	PDFs/docs → Claude Desktop	Claude converter e ler qualquer documento sem copiar texto

Pré-requisito fundamental: as Camadas 2, 3 e 4 exigem o Claude Desktop (app nativo), não a interface web do Claude.ai.

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

Linux Mint:

flatpak install flathub md.obsidian.Obsidian

macOS:

brew install --cask obsidian

Windows:

winget install Obsidian.Obsidian

Estratégia de vault raiz + sub-vaults:

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

Com o vault raiz sempre aberto, o Claude Desktop enxerga todas as subpastas simultaneamente via MCP.

Criando a estrutura (Linux Mint):

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}

Abrindo o vault raiz: Obsidian → Open folder as vault → selecione ~/Gdrive/Obsidian.

Ativar plugins comunitários: Settings → Community plugins → Turn on community plugins.

9.3 Camada 1 — Zotero → Obsidian: escolha do plugin

9.3.1 ZotLit vs Zotero Integration

	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

O ZotLit está incompatível com o Obsidian 1.11+ (Electron 39) desde janeiro de 2026, sem previsão de correção. Esta documentação adota o Zotero Integration como opção principal.

9.3.2 Zotero Integration (opção recomendada)

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

Instalação: Settings → Community plugins → Browse → pesquise Zotero Integration → Instale e ative.

PDF Utility:

Clique em Download na seção General Settings. Se usar Flatpak no Linux:

mkdir -p ~/.local/share/zotero-integration
wget -O /tmp/pdfannots2json.tar.gz \
  "https://github.com/mgmeyers/pdfannots2json/releases/download/1.0.16/pdfannots2json-linux.tar.gz"
tar -xzf /tmp/pdfannots2json.tar.gz -C /tmp/
mv /tmp/pdfannots2json ~/.local/share/zotero-integration/pdfannots2json
chmod +x ~/.local/share/zotero-integration/pdfannots2json

No campo PDF Utility Path Override:

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

Configurações gerais:

Note Import Location: Sources
Database: Zotero

Citation Formats:

Nome	Output Format	Insere
Pandoc	Pandoc	`[@citekey]`
LaTeX	LaTeX	`\cite{citekey}`
ABNT parênteses	Formatted Citation	`(SILVA, 2023)`

Template de nota literária:

Crie Templates/zotero-nota.md no vault com o conteúdo:

---
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 %}

Import Format:

Settings → Zotero Integration → Add Import Format.
Name: Nota Literária
Output path: {{citekey}}.md
Template File: Templates/zotero-nota

Image OCR com Tesseract:

# Linux
sudo apt install tesseract-ocr tesseract-ocr-eng tesseract-ocr-por -y

Campo	Valor
Image OCR	✅ Ativado
Tesseract path	`/usr/bin/tesseract` (Linux)
Image OCR Language	`eng+por+spa`

Atalhos:

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

9.3.3 Alternativa: ZotLit (requer downgrade do Obsidian)

⚠️ Requer downgrade para Obsidian 1.10.x e desativação de atualizações automáticas. O problema se repetirá na próxima atualização do Electron.

Downgrade: Acesse github.com/obsidianmd/obsidian-releases/releases, baixe a versão 1.10.x e instale. Após instalar: Settings → About → desmarque Automatic updates.

Instalação: Settings → Community plugins → Browse → pesquise ZotLit → instale.

Configuração:

Settings → ZotLit → Zotero data directory: /home/<usuário>/Zotero
Literature note folder: Sources

Acompanhe issue #452 no GitHub para atualizações de compatibilidade.

9.4 Camada 2 — Claude Desktop + Zotero MCP

Instalação do Claude Desktop

Linux Mint:

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

sudo apt update && sudo apt install claude-desktop

macOS / Windows: Baixe o instalador oficial em claude.ai/download.

Instalação do uv e do servidor Zotero MCP

# Linux / macOS
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

# Confirmar
which uvx
# /home/<usuário>/.local/bin/uvx

# Instalar servidor MCP
uv tool install zotero-mcp-server

Windows (PowerShell):

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

Configuração da API local do Zotero

Edit → Preferences → Advanced → marque "Allow other applications on this computer to communicate with Zotero" (porta padrão: 23119).
Acesse zotero.org/settings/keys → Create new private key → Read Only.
Copie a chave e o Library ID exibido na mesma página.

Configuração do claude_desktop_config.json

Linux (~/.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 o caminho absoluto do uvx no Linux? O Claude Desktop não herda o $PATH do usuário ao iniciar. Use sempre o caminho absoluto retornado por which uvx.

macOS:

{
  "mcpServers": {
    "zotero": {
      "command": "/Users/<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"
      }
    }
  }
}

Windows (%APPDATA%\Claude\claude_desktop_config.json):

{
  "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"
      }
    }
  }
}

Verificação: Abra o Claude Desktop com o Zotero em execução. O ícone de ferramentas (🔧) deve aparecer na interface indicando que o MCP está ativo.

9.5 Camada 3 — Claude Desktop + Obsidian MCP

Instalação do plugin Local REST API no Obsidian:

Settings → Community plugins → Browse → pesquise Local REST API (coddingtonbear).
Instale e ative.
Settings → Local REST API → copie a API Key gerada.

Adicionar ao claude_desktop_config.json:

{
  "mcpServers": {
    "zotero": { "...": "..." },
    "obsidian": {
      "command": "/home/<seu-usuário>/.local/bin/uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "SUA_API_KEY_AQUI",
        "OBSIDIAN_BASE_URL": "http://localhost:27123"
      }
    }
  }
}

Mantenha o Obsidian aberto com o vault raiz ativo para que o Claude Desktop possa acessar as notas via MCP.

9.6 Uso combinado — prompts validados

Com Zotero e Obsidian conectados via MCP, o Claude Desktop pode responder perguntas que cruzam as duas fontes:

"Quais artigos sobre mercúrio em bacias hidrográficas estão na minha biblioteca e ainda não foram fichados no Obsidian?"
"Resuma os 5 artigos mais recentes sobre GNNs na minha biblioteca e crie uma nota de síntese no vault."
"Liste os autores que mais aparecem nas minhas notas do doutorado e verifique se há artigos deles não lidos na biblioteca."
"Com base nos artigos fichados em Sources/, identifique lacunas metodológicas para o capítulo de métodos."

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

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

O Obsidian renderiza diagramas Mermaid nativamente. Crie uma nota e insira:

```mermaid
gantt
    title Roadmap Doutorado 2026
    dateFormat  YYYY-MM-DD
    section Revisão Bibliográfica
    Levantamento inicial       :done,    lit1, 2026-01-01, 2026-02-28
    Fichamento artigos chave   :active,  lit2, 2026-03-01, 2026-04-30
    section Modelagem
    Construção do KG           :         mod1, 2026-05-01, 2026-06-30
    Treinamento GNN            :         mod2, 2026-07-01, 2026-08-31
    section Escrita
    Capítulo de métodos        :         esc1, 2026-09-01, 2026-10-31
    Defesa                     :milestone, def1, 2026-12-15, 0d
```

9.7.2 Obsidian-PM (plugin com Gantt interativo)

Settings → Community plugins → Browse → pesquise Obsidian-PM.
Instale e ative.
Crie uma nota com frontmatter de projeto e use o comando Open Project View.

9.8 Organização da biblioteca Zotero — estrutura recomendada para pesquisa de doutorado

A estrutura abaixo foi validada em um doutorado com revisão sistemática em múltiplas perguntas de pesquisa (P1, P2, P3). Ela é escalável: novas coleções podem ser criadas para artigos derivados (artigos, capítulos, relatórios) sem quebrar a hierarquia principal.

Hierarquia de coleções no Zotero

Minha biblioteca
└── Doutorado UnB
    ├── Referencias-Gerais          ← referências de uso geral (metodologia, teoria, escrita)
    ├── Buscas brutas               ← resultados brutos exportados das bases de dados
    │   ├── P1-buscas-brutas
    │   ├── P2-buscas-brutas
    │   └── P3-buscas-brutas
    └── Relevantes                  ← artigos triados e aprovados para uso na pesquisa
        ├── p1-relevantes
        ├── p2-relevantes
        └── p3-relevantes

Por que manter "Buscas brutas" separado? Os resultados brutos exportados das bases de dados (Web of Science, Scopus, IEEE, ACM) têm valor metodológico independente — podem ser reutilizados em futuras revisões ou submetidos como dado suplementar ao protocolo PRISMA. Nunca misture resultados brutos com artigos já triados.

Escalabilidade: para trabalhos derivados da tese (artigo submetido a periódico, capítulo de livro), crie novas subcoleções dentro de Relevantes sem precisar reorganizar nada:

Relevantes/ ├── p1-relevantes ├── p2-relevantes ├── p3-relevantes └── artigo-mercurio-pnb/ ← nova coleção criada para um artigo específico

Como criar a estrutura no Zotero

Clique com o botão direito em Minha biblioteca → Nova coleção → Doutorado UnB.
Clique com o botão direito em Doutorado UnB → Nova subcoleção → Referencias-Gerais.
Repita para Buscas brutas e Relevantes.
Dentro de Buscas brutas, crie P1-buscas-brutas, P2-buscas-brutas, P3-buscas-brutas.
Dentro de Relevantes, crie p1-relevantes, p2-relevantes, p3-relevantes.

Convenção de capitalização: use maiúsculas para coleções estruturais (Doutorado UnB, Buscas brutas, Relevantes) e minúsculas com hífen para coleções folha (p1-relevantes, p2-relevantes). Isso padroniza os nomes de pastas no Google Drive e facilita scripts de automação.

Estrutura de arquivos no Google Drive (via Attanger)

O Attanger com Subfolder = {{collection}} replica a hierarquia completa do Zotero como subpastas. Com Destination Root = ~/Gdrive/doutorado-unb-2026/revisao-sistematica/relevantes, o resultado no sistema de arquivos é:

~/Gdrive/doutorado-unb-2026/
└── revisao-sistematica/
    └── relevantes/
        └── Doutorado UnB/
            └── Relevantes/
                ├── p1-relevantes/    ← PDFs da pergunta P1
                ├── p2-relevantes/    ← PDFs da pergunta P2
                └── p3-relevantes/    ← PDFs da pergunta P3

Nota: o caminho intermediário Doutorado UnB/Relevantes/ aparece porque {{collection}} replica a hierarquia completa do Zotero, não apenas o nome da coleção folha. Isso é esperado e não é um erro — é o comportamento padrão do Attanger.

Configuração do Attanger para esta estrutura:

Campo	Valor
Destination Root	`/home/<usuário>/Gdrive/doutorado-unb-2026/revisao-sistematica/relevantes`
Subfolder	`{{collection}}`
Rename linked files	✅ Marcado nas preferências nativas do Zotero

9.9 Camada 4 — MarkItDown MCP: leitura e conversão de PDFs pelo Claude

O MarkItDown é um pacote oficial da Microsoft que converte documentos para Markdown. Integrado ao Claude Desktop via MCP, permite que o Claude leia o conteúdo completo de qualquer arquivo acessível por URI — incluindo PDFs do Google Drive montado via rclone, documentos Office, imagens e mais — sem que o usuário precise copiar texto manualmente.

Ferramenta exposta: convert_to_markdown(uri) — aceita URIs nos esquemas file://, http://, https:// e data:.

Formatos suportados (principais):

Categoria	Formatos
Documentos	PDF, DOCX, PPTX, XLSX, ODT
Web	HTML, XML, JSON, CSV, RSS
Imagens	JPG, PNG, GIF, BMP (com descrição via visão)
Áudio	MP3, WAV (transcrição automática)
Arquivos	ZIP (conversão recursiva do conteúdo)

Instalação

# Linux / macOS — instalar via uv (mesmo gerenciador usado para Zotero e Obsidian MCP)
uv tool install markitdown-mcp

# Confirmar instalação
uvx markitdown-mcp --help

No Linux Mint, use sempre uv tool install — o sistema bloqueia pip install global por padrão (PEP 668). Não use sudo pip install.

Instalação com suporte completo a todos os formatos (opcional):

uv tool install 'markitdown-mcp[all]'

Configuração no `claude_desktop_config.json`

Linux (~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "zotero": { "...": "..." },
    "obsidian": { "...": "..." },
    "markitdown": {
      "command": "/home/<seu-usuário>/.local/bin/uvx",
      "args": ["markitdown-mcp"]
    }
  }
}

macOS (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "markitdown": {
      "command": "/Users/<seu-usuário>/.local/bin/uvx",
      "args": ["markitdown-mcp"]
    }
  }
}

Windows (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "markitdown": {
      "command": "uvx",
      "args": ["markitdown-mcp"]
    }
  }
}

Por que caminho absoluto no Linux e macOS? O Claude Desktop não herda o $PATH do usuário ao iniciar. Sem o caminho absoluto, o servidor falha silenciosamente. Use which uvx no terminal para confirmar o caminho exato antes de editar o arquivo de configuração.

Após editar, reinicie o Claude Desktop completamente. O ícone de ferramentas (🔧) na interface indicará que todos os MCPs estão ativos.

Verificação — estado esperado dos MCPs

Após configurar os três servidores (Zotero, Obsidian, MarkItDown), o arquivo claude_desktop_config.json completo no Linux deve ter esta estrutura:

{
  "mcpServers": {
    "zotero": {
      "command": "/home/<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"
      }
    },
    "obsidian": {
      "command": "/home/<usuário>/.local/bin/uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "SUA_API_KEY_AQUI",
        "OBSIDIAN_BASE_URL": "http://localhost:27123"
      }
    },
    "markitdown": {
      "command": "/home/<usuário>/.local/bin/uvx",
      "args": ["markitdown-mcp"]
    }
  }
}

Para verificar o status de cada servidor no Claude Desktop: Settings → Developer → MCP Servers. Cada servidor deve aparecer com status running.

Como usar — PDFs locais via rclone

Para PDFs no Google Drive montado em ~/Gdrive, use a URI file:// com o caminho absoluto:

Leia o arquivo:
file:///home/<usuário>/Gdrive/doutorado-unb-2026/revisao-sistematica/relevantes/Doutorado UnB/Relevantes/p1-relevantes/Silva - 2023 - Mercury in Cerrado.pdf

O Claude converte o PDF para Markdown internamente via MarkItDown e processa o conteúdo completo.

Pré-requisito: o serviço rclone deve estar montado (systemctl --user status rclone-gdrive.service). Sem a montagem ativa, a URI file:// não encontra os arquivos.

Como usar — PDFs no Google Drive via URL pública

Para PDFs com link de compartilhamento público no Google Drive:

Obtenha o fileId do arquivo — é a string entre /d/ e /view na URL: https://drive.google.com/file/d/1urqhB2se7V3VswnXB0NSvll_NcKaHq92/view ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ este é o fileId
Construa a URI de download direto: https://drive.google.com/uc?export=download&id=<fileId>
Peça ao Claude para converter: Resuma o artigo em: https://drive.google.com/uc?export=download&id=1urqhB2se7V3VswnXB0NSvll_NcKaHq92

Nota: esta abordagem funciona apenas para arquivos com permissão de compartilhamento público ou "qualquer pessoa com o link". Para arquivos privados, use a URI file:// com o rclone montado.

Fluxo integrado: PDF → Markdown → Obsidian

Com os três MCPs ativos simultaneamente (Zotero + Obsidian + MarkItDown), o Claude pode executar o fichamento completo de um artigo em uma única conversa:

1. Claude busca o artigo na biblioteca Zotero via Zotero MCP (metadados, citekey)
2. Claude converte o PDF para Markdown via MarkItDown MCP (file:// ou https://)
3. Claude extrai resumo, contribuições principais, metodologia e limitações
4. Claude cria nota literária estruturada no vault Obsidian via Obsidian MCP
5. Nota fica vinculada ao citekey do Zotero e persistente no vault

Prompt de exemplo:

Usando o markitdown, leia o PDF em:
file:///home/rui/Gdrive/doutorado-unb-2026/revisao-sistematica/relevantes/Doutorado UnB/Relevantes/p1-relevantes/Zhu - 2018 - Mercury transformations in resuspended contaminate.pdf

Em seguida, crie uma nota literária no Obsidian em Sources/zhu2018mercury.md com as seguintes seções:
- Metadados (título, autores, ano, DOI, citekey)
- Resumo em português (máx. 300 palavras)
- Principais contribuições (lista)
- Metodologia resumida
- Limitações apontadas pelos autores
- Relevância para a pesquisa sobre mercúrio e GNNs

10. Solução de problemas

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

O ponto de montagem ficou em estado inconsistente. Execute:

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

[Linux] rclone não inicia com o sistema

Verifique se o linger está habilitado para seu usuário:

loginctl enable-linger $USER
systemctl --user enable rclone-gdrive.service
systemctl --user start rclone-gdrive.service

[Linux] Attanger não move os arquivos

Confirme que o caminho em Base Directory usa barra / e não ~.
Verifique se o diretório existe e tem permissão de escrita: ls -la ~/Gdrive/doutorado-unb-2026.
Reinicie o Zotero após alterar as configurações do Attanger.

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

O rclone pode não ter montado antes do Zotero iniciar. Adicione um delay no serviço ou inicie o Zotero após confirmar que ~/Gdrive está montado:

ls ~/Gdrive && zotero &

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

O caminho do Google Drive no macOS varia por versão do cliente. Confirme arrastando a pasta para o Terminal para obter o caminho exato, e use-o no campo Browse do Attanger.

[macOS] PDFs abrem lentamente no Zotero

Ative o modo Mirror no cliente do Google Drive: ícone na barra de menus → Preferences → Google Drive → Mirror files.

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

O Google Drive pode ter mapeado em outra letra. Abra o Explorador de Arquivos e localize Google Drive na barra lateral para identificar a letra correta, depois atualize o caminho no Attanger.

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

Use sempre o botão Browse para selecionar o caminho — não edite o campo de texto manualmente.

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

O Attanger monitora apenas PDFs adicionados automaticamente pelo Connector. Para PDFs adicionados manualmente, clique com o botão direito no anexo → Move to Attanger Base Directory.

[Todos] Better BibTeX: chaves duplicadas

Acesse Tools → Better BibTeX → Open Better BibTeX Preferences → Citation keys e clique em Refresh all citation keys. Se persistir, verifique se há itens duplicados na biblioteca.

[Todos] Zotero Connector não detecta PDF

Verifique se o Zotero desktop está aberto.
Confira se o proxy ez54 está configurado e o host foi associado (aba Proxies do Connector).
Tente acessar o artigo diretamente pela URL do publisher autenticado via CAFe antes de acionar o Connector.
Para artigos não acessíveis via CAPES, use "Encontrar texto completo" com Sci-Hub configurado.

[Todos] scite.ai não carrega badges

Verifique se está logado em Edit → Preferences → scite.
Certifique-se de que os itens têm DOI preenchido — o plugin verifica por DOI.
Reinicie o Zotero.

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

Ocorre somente com Obsidian instalado via Flatpak. Instale o binário manualmente conforme a Seção 9.3.2 e configure o campo PDF Utility Path Override.

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

Confirme que o Zotero está aberto e com a API local habilitada (porta 23119).
Confirme que o Obsidian está aberto com o vault raiz ativo e o plugin Local REST API ativado.
Verifique o claude_desktop_config.json — erros de JSON (vírgulas ausentes, chaves mal fechadas) impedem o carregamento de todos os servidores.
No Linux e macOS, confirme que o caminho do uvx é absoluto: which uvx.
Reinicie o Claude Desktop após editar o arquivo de configuração.
Verifique o status em Settings → Developer → MCP Servers.

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

Verifique se a chave de API não expirou em zotero.org/settings/keys.
Confirme o Library ID — ele aparece na mesma página como "Your userID for use in API calls".
Gere uma nova chave e atualize o claude_desktop_config.json.

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

Certifique-se de que o Zotero está fechado antes de abrir o Obsidian com o ZotLit ativo — o SQLite do Zotero não pode ser lido por dois processos simultaneamente. Abra o Obsidian primeiro, depois o Zotero.

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

Confirme que o plugin Local REST API está ativo no Obsidian.
Verifique se a porta 27123 não está bloqueada por firewall local.
Copie a API Key diretamente das configurações do plugin (Settings → Local REST API) e cole no claude_desktop_config.json.

[MCP] MarkItDown MCP não aparece no Claude Desktop

Sintoma	Causa provável	Solução
Servidor ausente no 🔧	Caminho relativo do `uvx` no Linux/macOS	Use caminho absoluto: `/home/<usuário>/.local/bin/uvx`
`convert_to_markdown` retorna erro em PDF	Dependência faltando	`uv tool install 'markitdown-mcp[all]'`
URI `file://` retorna "not found"	rclone não está montado	`systemctl --user status rclone-gdrive.service`
PDF do Drive retorna 403	Arquivo não é público	Use URI `file://` com rclone ou compartilhe o arquivo publicamente
Servidor aparece mas não responde	JSON malformado no config	Valide o arquivo em jsonlint.com

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

O ZotLit está incompatível com a versão atual do Obsidian. Opções:

Recomendado: migre para o Zotero Integration conforme a Seção 9.3.2.
Alternativo: faça downgrade do Obsidian para 1.10.x conforme a Seção 9.3.3.
Acompanhe issue #452 para aguardar correção.

11. Referências e recursos adicionais

Nota sobre plugins com problemas de compatibilidade (Zotero 7)

Alguns plugins populares ainda não foram portados para o Zotero 7 ou apresentam instabilidades conhecidas:

Plugin	Status no Zotero 7	Alternativa
ZotFile	❌ Descontinuado	Attanger
ZotMoov	⚠️ Instável	Attanger
Mdnotes	❌ Não compatível	Zotero Integration (Obsidian)
ZotLit	⚠️ Quebra com cada novo Electron	Zotero Integration (Obsidian)

Verifique sempre a compatibilidade com o Zotero 7 antes de instalar qualquer plugin em zotero.org/support/plugins.

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

Introdução

O que é o Zotero

Como o Zotero funciona

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

Por que este ecossistema?

O ecossistema em uma frase

As cinco camadas e o que cada uma resolve

Por que o MCP muda o jogo

Para quem é este guia

Sumário

1. Instalação do Zotero

1.1 Linux Mint

1.2 macOS

1.3 Windows

2. Zotero Connector e acesso ao texto completo

2.1 Proxy CAPES Periódicos (ez54) — acesso institucional UnB

2.2 Sci-Hub como resolvedor de PDFs (fallback)

3. Plugins Essenciais

3.1 Better BibTeX

3.2 Attanger

3.3 Better Notes

3.4 Translate for Zotero

3.5 scite.ai

3.6 PapersGPT

3.7 PubPeer

3.8 Notero (condicional — usuários Notion)

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

4.1 Instalação do rclone

4.2 Configuração do remote gdrive

4.3 Criação do ponto de montagem

4.4 Serviço systemd --user

4.5 Pastas persistentes (pré-cache no boot)

5. Armazenamento de PDFs via Koofr WebDAV

5.1 Koofr — serviço WebDAV gratuito (10 GB)

5.2 WebDAV self-hosted no Oracle Cloud VPS (avançado)

5.3 Comparativo das opções de armazenamento

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

6.1 Linux Mint — diretório montado via rclone

6.2 macOS — cliente oficial do Google Drive

6.3 Windows — cliente oficial do Google Drive

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

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

7. Integração com ResearchRabbit

8. Fluxo de trabalho completo

9. Ecossistema Obsidian + Claude Desktop + Zotero via MCP

9.1 Visão geral da arquitetura

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

9.3 Camada 1 — Zotero → Obsidian: escolha do plugin

9.3.1 ZotLit vs Zotero Integration

9.3.2 Zotero Integration (opção recomendada)

9.3.3 Alternativa: ZotLit (requer downgrade do Obsidian)

9.4 Camada 2 — Claude Desktop + Zotero MCP

Instalação do Claude Desktop

Instalação do uv e do servidor Zotero MCP

Configuração da API local do Zotero

Configuração do claude_desktop_config.json

9.5 Camada 3 — Claude Desktop + Obsidian MCP

9.6 Uso combinado — prompts validados

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

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

9.7.2 Obsidian-PM (plugin com Gantt interativo)

9.8 Organização da biblioteca Zotero — estrutura recomendada para pesquisa de doutorado

Hierarquia de coleções no Zotero

Como criar a estrutura no Zotero

Estrutura de arquivos no Google Drive (via Attanger)

9.9 Camada 4 — MarkItDown MCP: leitura e conversão de PDFs pelo Claude

Instalação

Configuração no claude_desktop_config.json

Verificação — estado esperado dos MCPs

Como usar — PDFs locais via rclone

Como usar — PDFs no Google Drive via URL pública

Fluxo integrado: PDF → Markdown → Obsidian

10. Solução de problemas

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

[Linux] rclone não inicia com o sistema

[Linux] Attanger não move os arquivos

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

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

[macOS] PDFs abrem lentamente no Zotero

Configuração no `claude_desktop_config.json`