OverleafMCP (MCP server) — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Leia a árvore do projeto e arquivos .tex individuais
Analise o LaTeX em uma árvore de seções/subseções
Envie edições via bridge Git do Overleaf (sem riscos de sobrescrever)
Inspeção de BibTeX para trabalhos com citações
Funciona com qualquer plano pago do Overleaf que exponha Git

Demo ao vivo

Como fica na prática

overleaf-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "overleaf-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "overleaf-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mjyoo2/overleaf-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add overleaf-mcp -- npx -y @mjyoo2/overleaf-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: OverleafMCP

Enxugar uma seção de artigo sem sair do Claude

👤 Pesquisadores, escritores técnicos ⏱ ~20 min intermediate

Quando usar: O Revisor 2 disse que a seção 3 é verbose — você tem 30 minutos para corrigir.

Pré-requisitos

Plano pago do Overleaf com acesso Git — Account → Account Settings → Git authentication

Fluxo

Localizar

Use o MCP do Overleaf. Encontre a seção 3 em main.tex. Mostre-me o texto atual.✓ Copiado

→ Texto da seção retornado com intervalo de linhas
Reescrever

Enxugue em 30%. Mantenha termos técnicos intactos. Não remova citações.✓ Copiado

→ Reescrita mais curta preservando citações
Enviar

Substitua a seção 3 pela reescrita. Faça commit com a mensagem 'Enxugar §3 conforme revisor 2'.✓ Copiado

→ Push Git bem-sucedido; projeto re-renderiza no Overleaf

Resultado: Edições chegam ao Overleaf; você não tocou na interface web.

Armadilhas

Edições simultâneas de coautor causam merge — Faça pull antes do push; resolva conflitos no Claude com contexto de diff

Combine com: filesystem

Auditar citações em um artigo

👤 Autores finalizando um manuscrito ⏱ ~15 min beginner

Quando usar: Pré-submissão — você quer ter certeza de que cada \cite tem uma entrada correspondente no .bib.

Fluxo

Inventariar

Liste todas as chaves \cite{} em main.tex. Compare com refs.bib.✓ Copiado

→ Tabela de correspondência; órfãos sinalizados
Corrigir

Para cada chave órfã, sugira a correspondência mais próxima do .bib ou marque como ausente.✓ Copiado

→ Recomendação por órfão

Resultado: Zero citações quebradas antes de clicar em Submeter.

Armadilhas

Citações dentro de comentários ainda correspondem — Remova comentários LaTeX antes do regex

Mover seções com confiança

👤 Autores reestruturando capítulos ⏱ ~30 min advanced

Quando usar: O fluxo de seções está ruim; você quer trocar as seções 2 e 4.

Fluxo

Mapear

Mostre-me a árvore de seções de main.tex com intervalos de linhas.✓ Copiado

→ Árvore hierárquica
Reordenar

Troque a seção 2 com a seção 4. Atualize referências internas (\ref) de acordo.✓ Copiado

→ Troca feita; refs verificadas

Resultado: Artigo reestruturado compila sem erros.

Armadilhas

Referências futuras quebram — Compile após reordenar; o Claude pode ler os erros e corrigir

Combinações

Combine com outros MCPs para 10× de alavancagem

overleaf-mcp + filesystem

Backup local do artigo antes de edições estruturais

Faça snapshot do projeto em /papers/backup/ antes de qualquer mudança estrutural.✓ Copiado

overleaf-mcp + github

Espelhar no GitHub para revisão rastreada por issues

Envie os mesmos commits para o meu espelho no GitHub para que coautores possam deixar comentários em PRs.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
list_files	(nenhum)	Descobrir o layout do projeto	free
read_file	path	Buscar um .tex / .bib para inspeção	free
parse_structure	path	Esboçar antes de editar	free
edit_section	path, section_id, new_text	Substituição cirúrgica	free
git_push	message	Persistir edições no Overleaf	free

Custo e limites

O que custa rodar

Cota de API: O Git do Overleaf tem limites de taxa (seja razoável)
Tokens por chamada: 500–10000 dependendo do tamanho do arquivo
Monetário: MCP gratuito; plano pago do Overleaf necessário para Git
Dica: Leia seções, não arquivos inteiros, ao iterar

Segurança

Permissões, segredos, alcance

Escopos mínimos: Token Git do Overleaf — leitura/escrita em nível de repositório

Armazenamento de credenciais: Variável de ambiente OVERLEAF_GIT_TOKEN

Saída de dados: git.overleaf.com

Nunca conceda: Acesso por token aos projetos de outras pessoas

Tokens têm escopo de projeto; rotacione quando seu laptop mudar de mãos

Solução de problemas

Erros comuns e correções

Falha de autenticação durante git_push

Token pode ter expirado; regenere nas configurações do Overleaf

Verificar: git ls-remote com a mesma URL+token

Erros do Tree-sitter LaTeX ao analisar

Algumas macros confundem o parser; volte para read_file + escopo manual

Push rejeitado (non-fast-forward)

Coautor fez push; faça pull primeiro, resolva, faça push novamente

Alternativas

OverleafMCP vs. outros

Alternativa	Quando usar	Troca
VimTeX / TeXShop localmente	Você não precisa de sincronização na nuvem de forma alguma	Sem colaboração no Overleaf
Editor web do Overleaf	Edições leves apenas	Sem acesso por agente; manual

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills