Overleaf Web MCP

Overleaf Web MCP

Permita que Claude, Cursor ou qualquer cliente MCP leia, edite, compile e revise seus projetos Overleaf, conectado como você.

Overleaf Web MCP é um servidor não oficial de Model Context Protocol. Ele faz login no Overleaf uma vez por meio de uma janela do navegador que você controla e, em seguida, permite que um assistente de IA trabalhe em seus projetos da mesma forma que você faria no editor web: navegue pelos arquivos, faça edições verificadas por revisão, opcionalmente como alterações rastreadas, compile e lide com comentários de revisão. Ele usa os mesmos endpoints voltados para o navegador que o editor Overleaf usa, portanto, não é necessária integração com Git ou plano premium para o fluxo de trabalho principal.

O que você pode dizer

Depois de conectado, converse com seu assistente em linguagem simples. Ele escolhe as ferramentas.

• "Crie um novo projeto chamado Renovação de bolsa a partir da pasta que eu compactei e torne proposal.tex a raiz."
• "Liste meus projetos Overleaf e abra o chamado Tese."
• "Reescreva a introdução de main.tex para um público geral, como uma alteração rastreada."
• "Compile o artigo e me diga se ele foi compilado."
• "Quais figuras em ./figures diferem do que está no projeto? Envie apenas essas."
• "Faça o projeto corresponder a ~/papers/thesis e mostre-me o que seria excluído primeiro."
• "Resuma os comentários de revisão abertos e responda ao que fala sobre a Tabela 2."

[!CAUTION] Este cliente usa as APIs privadas e voltadas para o navegador do Overleaf, que o Overleaf pode alterar sem aviso prévio. Automatizar www.overleaf.com pode acarretar riscos aos Termos de Serviço e à conta. Comece com um projeto descartável e mantenha o volume de solicitações baixo.

Comece

Você precisa do Node.js 20 ou mais recente, um navegador da família Chrome (Chrome, Chromium, Brave ou Edge) e uma conta Overleaf.

1. Faça login uma vez. Uma janela dedicada do navegador é aberta. Conclua o login normal do Overleaf, incluindo SSO ou autenticação de dois fatores. Apenas cookies para a origem do Overleaf são salvos, em um arquivo que somente seu usuário pode ler. A sessão dura cinco dias desde o último uso, então faça login novamente após cinco dias de inatividade ou agende npx overleaf-web-mcp keepalive diariamente para mantê-la ativa (consulte configuração).

npx overleaf-web-mcp login

2. Conecte seu cliente MCP. Para Claude Code:

claude mcp add overleaf --scope user -- npx -y overleaf-web-mcp serve

Para Claude Desktop, Cursor, VS Code e outros clientes, adicione isto à configuração MCP deles:

{
  "mcpServers": {
    "overleaf": {
      "command": "npx",
      "args": ["-y", "overleaf-web-mcp", "serve"]
    }
  }
}

3. Reinicie o cliente e peça para verificar sua conexão com o Overleaf.

Etapas específicas por cliente, Overleaf auto-hospedado e solução de problemas, incluindo o "falha ao conectar" que você obtém quando node é mais antigo que 20, estão no guia de instalação.

O que ele pode fazer

• Iniciar e gerenciar projetos. Crie um projeto em branco ou de exemplo, clone um ou importe um zip; renomeie, mova para a lixeira, restaure ou arquive projetos com o nome confirmado primeiro; defina o documento raiz, o mecanismo TeX e a imagem TeX Live para que a Recompilação do editor web seja seguida.
• Navegar e organizar. Liste e pesquise projetos, leia a árvore de arquivos com o documento raiz e o compilador configurados, crie pastas e arquivos, renomeie, mova, envie um arquivo ou uma lista deles, baixe um arquivo ou o projeto inteiro como zip e exclua com confirmação.
• Sincronizar uma pasta. Compare uma pasta local com o projeto sem alterar nada, depois envie apenas o que mudou e, opcionalmente, exclua o que você removeu localmente, em uma única chamada confirmada. Arquivos de texto alterados passam pelas mesmas edições verificadas por revisão que uma única gravação, portanto, uma edição concorrente de um colaborador nunca é sobrescrita.
• Escrever com segurança. Substitua um documento inteiro ou uma seção única. Cada edição é verificada em relação à revisão que você leu primeiro, portanto, uma alteração concorrente de um colaborador é relatada em vez de sobrescrita. As edições podem ser registradas como alterações rastreadas do Overleaf.
• Trabalhar por seção. Analise os cabeçalhos \section em um arquivo, leia uma seção, substitua uma seção.
• Compilar. Compile o documento raiz configurado do projeto, ou qualquer documento que você nomear, e interrompa uma compilação em andamento.
• Revisar. Liste os tópicos de comentários com suas localizações, responda, adicione um comentário ancorado a texto exato e resolva ou reabra tópicos.
• Seguir o histórico. Consulte o histórico recente do projeto com um cursor de versão para ver quem alterou o quê.

Ferramentas

Todas as 29 ferramentas, agrupadas como na referência de ferramentas, que tem todos os parâmetros e resultados. Ferramentas somente leitura não alteram nada no Overleaf e não gravam nada no seu computador. Ferramentas destrutivas podem substituir ou remover conteúdo existente. Todas, exceto stop_compile, precisam de um valor repetido primeiro: o caminho, nome ou contagem do que excluem, a revisão do documento que substituem, o planToken de uma sincronização de pasta ou overwrite para um arquivo que existe. Até 0.6.0, um envio que substitui um arquivo e uma sincronização de pasta sem um planToken ainda são executados sem um e relatam uma depreciação; a partir de 0.6.0, eles são recusados. A última coluna mostra quais ferramentas leem ou gravam arquivos no computador em que o servidor é executado.

Grupo	Ferramenta	O que faz	Anotação	Efeito local
Conta	auth_status	Verifique a sessão salva e relate quando ela expira	somente leitura
Conta	list_projects	Liste e pesquise projetos, do mais recente ao mais antigo	somente leitura
Ciclo de vida do projeto	create_project	Crie um projeto em branco ou de exemplo
Ciclo de vida do projeto	clone_project	Copie um projeto, incluindo arquivos e configurações
Ciclo de vida do projeto	import_project_zip	Crie um projeto a partir de um arquivo .zip local		lê
Ciclo de vida do projeto	manage_project	Renomeie, mova para a lixeira, restaure, arquive, desarquive ou exclua um projeto	destrutiva
Ciclo de vida do projeto	update_project_settings	Defina o documento raiz, o mecanismo TeX, a imagem TeX Live ou o idioma de verificação ortográfica
Arquivos	get_project_tree	Leia a árvore de arquivos com as configurações de compilação do projeto	somente leitura
Arquivos	read_file	Leia um documento de texto e sua revisão	somente leitura
Arquivos	write_file	Substitua um documento com uma edição mínima verificada por revisão	destrutiva	lê
Arquivos	create_file	Crie um documento de texto, opcionalmente com conteúdo
Arquivos	manage_entity	Crie uma pasta, ou renomeie, mova ou exclua uma entidade	destrutiva
Arquivos	upload_file	Envie um arquivo local, substituindo o que está nesse caminho quando confirmado	destrutiva	lê
Arquivos	batch_upload	Envie uma lista de arquivos locais para os caminhos fornecidos, criando pastas ausentes	destrutiva	lê
Arquivos	download_file	Salve um documento ou arquivo binário localmente	destrutiva	grava
Arquivos	download_project_zip	Salve o projeto inteiro localmente como um arquivo zip	destrutiva	grava
Sincronização de pasta	plan_sync	Compare uma pasta local com o projeto e mostre o que uma sincronização faria	somente leitura	lê
Sincronização de pasta	sync_directory	Envie o que mudou e, no modo espelho, exclua o que foi removido localmente	destrutiva	lê
Sincronização de pasta	delete_entities	Exclua vários arquivos ou pastas em uma única chamada confirmada	destrutiva
Seções	get_sections	Analise os cabeçalhos de seção de um arquivo	somente leitura
Seções	get_section_content	Leia o corpo de uma seção	somente leitura
Seções	write_section	Substitua o corpo de uma seção, verificado por revisão	destrutiva
Compilação	compile_project	Compile o projeto
Compilação	stop_compile	Interrompa a compilação ativa	destrutiva
Revisão	list_comments	Liste os tópicos de revisão com suas localizações	somente leitura
Revisão	reply_to_comment	Responda em um tópico existente
Revisão	add_comment	Adicione um comentário ancorado a texto exato
Revisão	set_comment_status	Resolva ou reabra um tópico	destrutiva
Histórico	monitor_project_history	Consulte o histórico recente do projeto com um cursor	somente leitura

Como ele mantém seu projeto seguro

• Edições de texto exigem a revisão de uma leitura anterior e falham com um conflito se o documento mudou por baixo.
• Alterações rastreadas são opcionais e nunca são silenciosamente rebaixadas para edições simples.
• Excluir um arquivo exige que seu caminho seja confirmado, excluir vários exige sua contagem, e mover para a lixeira ou excluir um projeto exige seu nome. Os projetos vão para a lixeira primeiro; a exclusão permanente só funciona a partir daí. Downloads, incluindo um zip do projeto inteiro, nunca sobrescrevem um arquivo local, a menos que solicitado, e nunca gravam sobre a sessão salva.
• Uma gravação que expira é observada, nunca reenviada, portanto, nada é aplicado duas vezes. O mesmo vale para cada arquivo em um envio em lote.
• Dado o planToken de plan_sync, uma sincronização de pasta para antes de alterar qualquer coisa se o projeto ou a pasta mudou desde o plano. Sem um, não há nada com que comparar, o que 0.6.0 recusará. Ela exclui apenas no modo espelho, apenas com a contagem de exclusão confirmada e nunca após um envio com falha.
• Opcionalmente, você pode limitar quais projetos, quais pastas no seu computador e quais tipos de alteração o servidor pode tocar (política de acesso). Ele mantém um assistente dentro do que você deu a ele; não é uma sandbox.
• Seu cookie de sessão permanece na sua máquina em um arquivo que somente você pode ler e nunca é retornado por nenhuma ferramenta.
• Enquanto um projeto está aberto, até 90 segundos após a última chamada, você pode aparecer online para colaboradores.

Como ele se compara

Os três servidores MCP Overleaf com mais estrelas e os dois mais próximos em design deste, cada um verificado em relação ao seu próprio código-fonte em 22/09/2026. Eles mudam com frequência, então siga os links para o estado atual deles. ✅ suportado, 🟡 parcialmente (veja as notas numeradas), ❌ não suportado.

	Este projeto	OverleafMCP	olcli	overleaf-mcp-server	overleaf-mcp-rt	netique/overleaf-mcp
Conecta-se por meio de	Sessão web	Ponte Git	Sessão web	Ponte Git	Sessão web	Sessão web
Ferramentas	29	8	19	4	22	17
Funciona sem a integração Git paga do Overleaf	✅	❌	✅	❌	✅	✅
Overleaf auto-hospedado	✅	❌	✅	🟡¹	✅	🟡²
Liste e pesquise seus projetos	✅	🟡³	🟡⁴	❌	🟡⁵	✅
Retorna o texto de um documento ao assistente	✅	✅	🟡⁶	✅	✅	✅
Envia edições como operações OT colaborativas, não arquivos inteiros	✅	❌	❌	❌	✅	✅
Recusa uma edição se o documento mudou desde que foi lido	✅	🟡⁷	❌	❌	✅	🟡⁸
Grava como alterações rastreadas quando solicitado	✅	❌	❌	❌	❌	✅
Aceita ou rejeita alterações rastreadas	❌	❌	❌	❌	❌	✅
Lê e substitui um \section	✅	✅	❌	❌	❌	❌
Cria, renomeia, move e exclui arquivos e pastas	✅	🟡⁹	🟡¹⁰	🟡⁹	✅	❌
Envia e baixa arquivos binários	✅	❌	✅	❌	✅	🟡¹¹
Compara uma pasta local com o projeto	✅	❌	✅	❌	❌	❌
Compila no Overleaf	✅	❌	✅	❌	✅	✅
Lê o log de compilação e erros	❌	❌	❌	❌	✅	✅
Comentários de revisão: listar, responder, adicionar, resolver	✅	❌	✅	❌	✅	🟡¹²
Cria, clona, importa, arquiva e exclui projetos	✅	❌	🟡¹³	❌	❌	❌
Salva o documento raiz, o compilador e a imagem TeX Live	✅	❌	❌	❌	❌	❌
Lê o histórico do projeto	✅	❌	❌	❌	🟡¹⁴	❌
Instala a partir de	npm	npm	npm, Homebrew	fonte	npm	npm
Licença	MIT	MIT	MIT	MIT	AGPL-3.0	AGPL-3.0

1. Somente onde o bridge Git do Overleaf existe, o que em uma instância auto-hospedada significa Server Pro.
2. Documentado, mas o login parece exigir o cookie overleaf_session2 do overleaf.com, que a Community Edition não define por padrão.
3. Somente os projetos nomeados em sua própria configuração.
4. Lista projetos sem busca e omite os arquivados e os da lixeira.
5. Lista projetos, sem busca ou filtro.
6. Os arquivos são salvos no disco do servidor; nenhuma ferramenta retorna o texto de um documento.
7. O Git rejeita o push se o Overleaf avançou após o pull da própria ferramenta, mas uma edição feita entre a leitura do assistente e esse pull é sobrescrita.
8. Somente com strict_version: true; por padrão, uma edição concorrente é relatada após a escrita.
9. Cria arquivos escrevendo-os; sem renomear, mover ou excluir.
10. Cria, renomeia e exclui arquivos e pastas; sem mover.
11. Baixa arquivos binários; sem upload.
12. Lista, responde, resolve e reabre tópicos, mas não pode adicionar um comentário.
13. Cria e renomeia projetos.
14. Relata o que os colaboradores alteraram durante a sessão.

Documentação

Página	O que cobre
Instalação	Claude Code, Claude Desktop, Cursor, VS Code, Overleaf auto-hospedado, solução de problemas
Como usar	Exemplos de prompts e o que acontece por baixo
Referência de ferramentas	Todas as 29 ferramentas com parâmetros e resultados
Modelo de segurança	Revisões, alterações rastreadas, confirmações, códigos de erro
Configuração	Variáveis de ambiente, política de acesso, proxies, onde a sessão é armazenada e como mantê-la ativa
Internos	Notas de protocolo, garantias de confiabilidade, projetos relacionados
Roadmap e Changelog	Para onde isso está indo e o que mudou

Para agentes de IA

O servidor envia instruções de uso ao cliente MCP quando se conecta, e a descrição de cada ferramenta é autocontida, então um assistente não precisa deste README para usá-lo corretamente. Agentes de codificação que contribuem para o repositório devem ler AGENTS.md.

Licença

MIT.