OverleafMCP (MCP server) — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

프로젝트 트리와 개별 .tex 파일 읽기
LaTeX를 섹션/소섹션 트리로 파싱
Overleaf의 Git 브릿지를 통해 편집 내용 푸시 (덮어쓰기 위험 없음)
인용 작업을 위한 BibTeX 검사
Git이 노출된 모든 Overleaf 유료 플랜에서 작동

라이브 데모

실제 사용 모습

overleaf-mcp.replay ▶ 준비됨

0/0

설치

클라이언트 선택

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

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.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는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

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

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "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"
      }
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

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

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

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

context_servers에 추가. 저장 시 Zed가 핫 리로드.

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

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: OverleafMCP

Claude를 벗어나지 않고 논문 섹션 다듬기

👤 연구자, 기술 작가 ⏱ ~20 min intermediate

언제 쓸까: Reviewer 2가 3번 섹션이 장황하다고 했을 때 — 30분 안에 수정해야 할 때.

사전 조건

Git 접근이 가능한 Overleaf 유료 플랜 — 계정 → Account Settings → Git authentication

흐름

위치 파악

Use Overleaf MCP. Find section 3 in main.tex. Show me current text.✓ 복사됨

→ 줄 범위와 함께 섹션 텍스트 반환
재작성

Tighten this 30%. Keep technical terms intact. Don't drop citations.✓ 복사됨

→ 인용을 유지하는 더 짧은 재작성
푸시

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

→ Git 푸시 성공; Overleaf에서 프로젝트 재렌더링

결과: 웹 UI를 건드리지 않고 Overleaf에 편집 내용이 반영됨.

함정

공동 저자의 동시 편집으로 병합 충돌 발생 — 푸시 전 pull; diff 컨텍스트와 함께 Claude에서 충돌 해결

함께 쓰기: filesystem

논문의 인용 감사

👤 원고를 마무리하는 저자 ⏱ ~15 min beginner

언제 쓸까: 제출 전 — 모든 \cite에 .bib 항목이 있는지 확인하고 싶을 때.

흐름

목록 작성

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

→ 매칭 테이블; 고아 항목 표시
수정

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

→ 고아 항목별 권고 사항

결과: 제출 클릭 전 깨진 인용 제로.

함정

주석 내 인용도 매칭됨 — regex 전 LaTeX 주석 제거

섹션을 안전하게 재배치

👤 챕터를 재구성하는 저자 ⏱ ~30 min advanced

언제 쓸까: 섹션 흐름이 어색할 때; 2번과 4번 섹션을 바꾸고 싶을 때.

흐름

매핑

Show me the section tree of main.tex with line ranges.✓ 복사됨

→ 계층적 트리
재정렬

Swap section 2 with section 4. Update internal references (\ref) accordingly.✓ 복사됨

→ 교체 완료; 참조 확인

결과: 재구성된 논문이 깨끗하게 컴파일됨.

함정

전방 참조 깨짐 — 재정렬 후 컴파일; Claude가 오류를 읽고 수정 가능

조합

다른 MCP와 조합해 10배 효율

overleaf-mcp + filesystem

구조적 편집 전 논문 로컬 백업

overleaf-mcp + github

이슈 추적 리뷰를 위해 GitHub에 미러링

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
list_files	(없음)	프로젝트 레이아웃 탐색	무료
read_file	path	.tex / .bib 파일 검사	무료
parse_structure	path	편집 전 개요 파악	무료
edit_section	path, section_id, new_text	정밀 교체	무료
git_push	message	Overleaf에 편집 내용 영속화	무료

비용 및 제한

운영 비용

API 쿼터: Overleaf Git은 rate limited (합리적으로 사용)
호출당 토큰: 파일 크기에 따라 500–10000
금액: 무료 MCP; Overleaf 유료 플랜 Git 필요
팁: 반복 작업 시 전체 파일이 아닌 섹션만 읽기

보안

권한, 시크릿, 파급범위

최소 스코프: Overleaf Git token — 레포 수준 읽기/쓰기

자격 증명 저장: OVERLEAF_GIT_TOKEN 환경 변수

데이터 외부 송신: git.overleaf.com

절대 부여 금지: 다른 사람의 프로젝트에 token 접근

Token은 프로젝트 범위; 노트북이 다른 사람에게 넘어가면 즉시 교체

문제 해결

자주 발생하는 오류와 해결

git_push 중 인증 실패

Token이 만료되었을 수 있음; Overleaf 설정에서 재생성

확인: 동일 URL+token으로 git ls-remote 실행

파싱 시 Tree-sitter LaTeX 오류

일부 매크로가 파서를 혼동시킴; read_file + 수동 범위로 대체

Push 거부됨 (non-fast-forward)

공동 저자가 푸시했음; 먼저 pull, 해결 후 재푸시

대안

OverleafMCP 다른 것과 비교

대안	언제 쓰나	단점/장점
VimTeX / TeXShop 로컬 사용	클라우드 동기화가 전혀 필요 없을 때	Overleaf 협업 없음
Overleaf 웹 에디터	간단한 편집만	에이전트 접근 없음; 수동

OverleafMCP