Overleaf MCP

Lee y edita proyectos de Overleaf desde Claude, usando el puente git de Overleaf.

ADVERTENCIA: Cuando proporcionas al MCP un ID de proyecto, esto le da a Claude acceso a TODO el directorio del proyecto.

Requisitos

• Overleaf premium (¡comprueba el acceso de tu institución!)

• uv, git, distribución de TeX y pdftocairo (puedes brew install poppler en Macs)

Related MCP server: overleaf-mcp

Configuración

1. Clona el repositorio.

2. Crea ~/.overleaf-mcp/projects.json. Hay un ejemplo en projects.json.example. El id del proyecto es la cadena después de /project/ en la URL de Overleaf.

   { "default": "paper", "projects": { "paper": "<project-id>" } }

3. Añade el servidor a tu configuración de Claude. Puedes generar el token de git en la Configuración de la Cuenta de Overleaf.

   {
     "mcpServers": {
       "overleaf": {
         "command": "/absolute/path/to/uv",
         "args": ["run", "--directory", "/absolute/path/to/overleaf-mcp", "overleaf-mcp"],
         "env": { "OVERLEAF_TOKEN": "your_git_token" }
       }
     }
   }

4. Reinicia Claude.

Cómo funciona

Un proyecto está unverified hasta que open_project tiene éxito, lo que comprueba que cada \usepackage se resuelve contra tu entorno TeX local, y compila la línea base de cada raíz.

Todas las escrituras se rechazan hasta que open_project pase

Un .tex que contiene \documentclass es una raíz, mientras que los hijos se incluyen mediante \input/\include/\subfile. Editar un hijo recompila las raíces que lo incluyen. Por ejemplo, esto cubre un proyecto estándar main.tex + sections/, un artículo de un solo archivo, o incluso una carpeta de documentos independientes de una página con la misma regla. Además, cualquier error bloquea un push, mientras que las advertencias solo se informan.

Herramientas