OverleafMCP (MCP server) — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Projektbaum und einzelne .tex-Dateien lesen
LaTeX in einen Abschnitt/Unterabschnitt-Baum parsen
Änderungen via Overleafs Git-Bridge pushen (kein Überschreibrisiko)
BibTeX-Inspektion für Zitierarbeiten
Funktioniert mit jedem bezahlten Overleaf-Tarif, der Git exponiert

Live-Demo

In der Praxis

overleaf-mcp.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/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"
      }
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.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 nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

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

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "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"
      }
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

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

In context_servers hinzufügen. Zed lädt beim Speichern neu.

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

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: OverleafMCP

Einen Paper-Abschnitt straffen ohne Claude zu verlassen

👤 Forscher, technische Autoren ⏱ ~20 min intermediate

Wann einsetzen: Reviewer 2 sagte, Abschnitt 3 ist weitschweifig — du hast 30 Minuten, um es zu korrigieren.

Voraussetzungen

Overleaf bezahlter Tarif mit Git-Zugang — Account → Account Settings → Git authentication

Ablauf

Lokalisieren

Use Overleaf MCP. Find section 3 in main.tex. Show me current text.✓ Kopiert

→ Abschnittstext mit Zeilenbereich zurückgegeben
Umschreiben

Tighten this 30%. Keep technical terms intact. Don't drop citations.✓ Kopiert

→ Kürzere Überarbeitung mit erhaltenen Zitaten
Pushen

Replace section 3 with the rewrite. Commit with message 'Tighten §3 per reviewer 2'.✓ Kopiert

→ Git-Push erfolgreich; Projekt wird in Overleaf neu gerendert

Ergebnis: Änderungen landen in Overleaf; Web-UI nie angefasst.

Fallstricke

Gleichzeitige Änderungen vom Co-Autor verursachen Merge-Konflikt — Vor dem Push pullen; Konflikte in Claude mit diff-Kontext lösen

Kombinieren mit: filesystem

Zitate in einem Paper prüfen

👤 Autoren, die ein Manuskript finalisieren ⏱ ~15 min beginner

Wann einsetzen: Vor der Einreichung — sicherstellen, dass jedes \cite einen passenden .bib-Eintrag hat.

Ablauf

Inventarisieren

List every \cite{} key in main.tex. Cross-check against refs.bib.✓ Kopiert

→ Abgleichtabelle; Waisen markiert
Korrigieren

For each orphan key, suggest the closest match from .bib or mark as missing.✓ Kopiert

→ Empfehlung pro Waise

Ergebnis: Keine defekten Zitate vor dem Einreichen.

Fallstricke

Zitate in Kommentaren treffen trotzdem zu — LaTeX-Kommentare vor dem Regex-Matching entfernen

Abschnitte sicher umstrukturieren

👤 Autoren, die Kapitel neu anordnen ⏱ ~30 min advanced

Wann einsetzen: Der Ablauf ist holprig; Abschnitte 2 und 4 sollen getauscht werden.

Ablauf

Kartieren

Show me the section tree of main.tex with line ranges.✓ Kopiert

→ Hierarchischer Baum
Umordnen

Swap section 2 with section 4. Update internal references (\ref) accordingly.✓ Kopiert

→ Tausch durchgeführt; Referenzen geprüft

Ergebnis: Umstrukturiertes Paper kompiliert sauber.

Fallstricke

Vorwärtsreferenzen brechen — Nach Umordnung kompilieren; Claude kann Fehler lesen und beheben

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

overleaf-mcp + filesystem

Lokales Backup des Papers vor strukturellen Änderungen

Snapshot the project to /papers/backup/ before any structural changes.✓ Kopiert

overleaf-mcp + github

Auf GitHub spiegeln für Issue-getracktes Review

Push the same commits to my GitHub mirror so co-authors can leave PR comments.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
list_files	(none)	Projektstruktur entdecken	free
read_file	path	Eine .tex / .bib zur Inspektion laden	free
parse_structure	path	Überblick vor dem Bearbeiten	free
edit_section	path, section_id, new_text	Chirurgischer Ersatz	free
git_push	message	Änderungen in Overleaf persistieren	free

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Overleaf Git ist rate-limitiert (maßvoll nutzen)
Tokens pro Aufruf: 500–10000 je nach Dateigröße
Kosten in €: Kostenloser MCP; Overleaf bezahlter Tarif für Git erforderlich
Tipp: Abschnitte lesen, nicht ganze Dateien, beim Iterieren

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: Overleaf Git token — repo-level read/write

Credential-Speicherung: OVERLEAF_GIT_TOKEN Umgebungsvariable

Datenabfluss: git.overleaf.com

Niemals gewähren: Token access to other people's projects

Tokens sind projektbezogen; rotieren wenn dein Laptop den Besitzer wechselt

Fehlerbehebung

Häufige Fehler und Lösungen

Authentication failed during git_push

Token könnte abgelaufen sein; in Overleaf-Einstellungen neu generieren

Prüfen: git ls-remote with the same URL+token

Tree-sitter LaTeX errors on parse

Manche Makros verwirren den Parser; Fallback auf read_file + manuellen Scope

Push rejected (non-fast-forward)

Co-Autor hat gepusht; zuerst pullen, auflösen, erneut pushen

Alternativen

OverleafMCP vs. andere

Alternative	Wann stattdessen	Kompromiss
VimTeX / TeXShop lokal	Du brauchst gar keine Cloud-Synchronisierung	Keine Overleaf-Zusammenarbeit
Overleaf Web-Editor	Nur leichte Änderungen	Kein Agent-Zugang; manuell

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen