OverleafMCP (MCP server) — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Lire l'arborescence du projet et les fichiers .tex individuels
Analyser le LaTeX en arbre section / sous-section
Pousser les modifications via le pont Git d'Overleaf (sans risque d'écrasement)
Inspection Bibtex pour le travail de citations
Fonctionne avec tout plan Overleaf payant qui expose Git

Démo en direct

Aperçu en pratique

overleaf-mcp.replay ▶ prêt

0/0

Installer

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

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.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 utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la 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"
      }
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "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"
      }
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : OverleafMCP

Resserrer une section de papier sans quitter Claude

👤 Chercheurs, rédacteurs techniques ⏱ ~20 min intermediate

Quand l'utiliser : Le Reviewer 2 dit que la section 3 est verbeuse — vous avez 30 minutes pour la corriger.

Prérequis

Plan Overleaf payant avec accès Git — Compte → Paramètres du compte → Authentification Git

Déroulement

Localiser

Utilise le MCP Overleaf. Trouve la section 3 dans main.tex. Montre-moi le texte actuel.✓ Copié

→ Texte de la section retourné avec plage de lignes
Réécrire

Resserre de 30%. Conserve les termes techniques intacts. Ne supprime pas les citations.✓ Copié

→ Réécriture plus courte préservant les citations
Pousser

Remplace la section 3 par la réécriture. Commit avec le message 'Resserrer §3 selon reviewer 2'.✓ Copié

→ Push Git réussi ; le projet se re-compile dans Overleaf

Résultat : Les modifications arrivent dans Overleaf sans toucher à l'interface web.

Pièges

Les modifications concurrentes d'un co-auteur provoquent un conflit — Faites un pull avant push ; résolvez les conflits dans Claude avec le contexte diff

Combiner avec : filesystem

Auditer les citations d'un article

👤 Auteurs finalisant un manuscrit ⏱ ~15 min beginner

Quand l'utiliser : Pré-soumission — vous voulez être sûr que chaque \cite a une entrée .bib correspondante.

Déroulement

Inventaire

Liste toutes les clés \cite{} dans main.tex. Croise avec refs.bib.✓ Copié

→ Tableau de correspondance ; orphelins signalés
Corriger

Pour chaque clé orpheline, suggère la correspondance la plus proche dans .bib ou marque comme manquante.✓ Copié

→ Recommandation par orphelin

Résultat : Zéro citation cassée avant de cliquer sur Soumettre.

Pièges

Les citations dans les commentaires correspondent aussi — Supprimez les commentaires LaTeX avant la regex

Réorganiser les sections en toute confiance

👤 Auteurs restructurant des chapitres ⏱ ~30 min advanced

Quand l'utiliser : Le flux des sections est mauvais ; vous voulez échanger les sections 2 et 4.

Déroulement

Cartographier

Montre-moi l'arbre des sections de main.tex avec les plages de lignes.✓ Copié

→ Arbre hiérarchique
Réordonner

Échange la section 2 avec la section 4. Mets à jour les références internes (\ref) en conséquence.✓ Copié

→ Échange effectué ; références vérifiées

Résultat : Article restructuré qui compile proprement.

Pièges

Les références forward se cassent — Compilez après le réordonnancement ; Claude peut lire les erreurs et les corriger

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

overleaf-mcp + filesystem

Sauvegarde locale du papier avant les modifications structurelles

Effectue un snapshot du projet dans /papers/backup/ avant tout changement structurel.✓ Copié

overleaf-mcp + github

Miroir sur GitHub pour une review avec suivi d'issues

Pousse les mêmes commits vers mon miroir GitHub pour que les co-auteurs puissent laisser des commentaires PR.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
list_files	(aucun)	Découvrir la structure du projet	gratuit
read_file	path	Récupérer un .tex / .bib pour inspection	gratuit
parse_structure	path	Faire le plan avant de modifier	gratuit
edit_section	path, section_id, new_text	Remplacement chirurgical	gratuit
git_push	message	Persister les modifications vers Overleaf	gratuit

Coût et limites

Coût d'exécution

Quota d'API: Git Overleaf est soumis à un débit limité (soyez raisonnable)
Tokens par appel: 500–10000 selon la taille du fichier
Monétaire: MCP gratuit ; plan Overleaf payant requis pour Git
Astuce: Lisez les sections, pas les fichiers entiers, lors des itérations

Sécurité

Permissions, secrets, portée

Portées minimales : Token Git Overleaf — lecture/écriture au niveau dépôt

Stockage des identifiants : Variable d'environnement OVERLEAF_GIT_TOKEN

Sortie de données : git.overleaf.com

Ne jamais accorder : Accès token aux projets d'autres personnes

Les tokens sont limités au projet ; faites-les pivoter quand votre laptop change de mains

Dépannage

Erreurs courantes et correctifs

Authentification échouée lors du git_push

Le token peut être expiré ; régénérez dans les paramètres Overleaf

Vérifier : git ls-remote avec la même URL+token

Erreurs tree-sitter LaTeX lors de l'analyse

Certaines macros perturbent l'analyseur ; repassez à read_file + périmètre manuel

Push rejeté (non-fast-forward)

Un co-auteur a poussé ; faites un pull d'abord, résolvez, puis poussez à nouveau

Alternatives

OverleafMCP vs autres

Alternative	Quand l'utiliser	Compromis
VimTeX / TeXShop en local	Vous n'avez pas besoin de synchronisation cloud du tout	Pas de collaboration Overleaf
Éditeur web Overleaf	Modifications légères uniquement	Pas d'accès agent ; manuel

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills