MCP-Server

Verbinden Sie KI-Clients wie Claude Code oder Codex über den MCP-Server eines Projekts mit diesem Projekt.

Jedes Projekt hat einen MCP-Server, sodass KI-Clients wie Claude Code, Codex, Cursor, VS Code oder Gemini CLI daran arbeiten können: seine Dateien lesen und bearbeiten, es kompilieren, das LaTeX-Log lesen, das PDF herunterladen und Kommentare beantworten.

Diese Funktion wurde von ayaka-notes/ayakaleaf-pro entwickelt. Sie ist ab v6.3.1 verfügbar.

​

Einrichtung

Der MCP-Server ist Teil der Git-Integration: Aktivieren Sie git-bridge, dann ist auch der MCP-Server verfügbar. Weitere Konfiguration ist nicht erforderlich.

​

Einen KI-Client verbinden

1. Erzeugen Sie in den Kontoeinstellungen ein Git-Authentifizierungstoken. Dasselbe Token wird für den MCP-Server und für Git verwendet.
2. Öffnen Sie im Editor Integrations und klicken Sie auf MCP server. Dort werden die Adresse des MCP-Servers des Projekts, https://<your-overleaf>/project/<project_id>/mcp, sowie die Anleitung zum Hinzufügen zu jedem KI-Client angezeigt: Kopieren Sie den Befehl und ersetzen Sie <token> durch Ihr Token.

Das Token wird als HTTP-Header Authorization: Bearer <token> gesendet. Der Befehl für Claude Code lautet zum Beispiel:

claude mcp add --transport http overleaf \
  https://<your-overleaf>/project/<project_id>/mcp \
  --header "Authorization: Bearer <token>"

​

Verwendung

Sobald die Verbindung steht, formulieren Sie Ihre Anfragen an den KI-Client in normaler Sprache. Zum Beispiel:

Ihre Anfrage	Der KI-Client verwendet
Korrigiere die Tippfehler in der Einleitung.	read_file, edit_file: Die Änderungen erscheinen live im Editor
Kompiliere das Projekt und behebe die LaTeX-Fehler.	compile, get_compile_log, edit_file
Beantworte die offenen Kommentare und schließe sie dann.	list_comments, reply_to_comment, resolve_comment
Wechsle zu XeLaTeX und lade das PDF herunter.	update_settings, compile, get_output_file_link

​

Tools

Gruppe	Tools
Projekt	get_clone_info, get_settings, update_settings, list_versions
Dateien	list_files, read_file, edit_file, write_file, delete_file
Kompilierung	compile, get_compile_log, get_output_file_link, word_count
Kommentare	list_comments, reply_to_comment, resolve_comment, reopen_comment

Mit edit_file und write_file vorgenommene Änderungen erscheinen live im Editor und werden mit denen der Mitarbeitenden zusammengeführt. Für viele Dateien auf einmal, Binärdateien oder Umbenennungen kann der KI-Client das Projekt auch mit Git klonen und pushen.

​

Berechtigungen

Der MCP-Server folgt wie Git den Freigabeeinstellungen des Projekts:

• Alle, die das Projekt ansehen können, können es lesen, kompilieren und seine Ausgabe herunterladen.
• Nur der Besitzer und Mitarbeitende mit Bearbeitungsrechten können seine Dateien und Einstellungen ändern.
• Reviewer können außerdem auf Kommentare antworten und die von ihnen begonnenen Kommentare schließen oder wieder öffnen.
• Betrachter, die über einen Link beigetreten sind, können die Kommentare nicht sehen, genau wie im Editor.

​

Fragen & Antworten

Ich sehe im Editor weder Integrations noch MCP server

Antwort: Der MCP-Server hat keine eigene Umgebungsvariable. Er wird mit GIT_BRIDGE_ENABLED=true in config/overleaf.rc aktiviert, siehe Git-Integration. Führen Sie nach der Änderung bin/up -d aus. Ohne die git-bridge zeigt der Editor den Tab Integrations in seiner linken Leiste nicht an.