Overleaf MCP

Claude에서 Overleaf git 브리지를 사용하여 Overleaf 프로젝트를 읽고 편집합니다.

경고: MCP에 프로젝트 ID를 제공하면 Claude가 프로젝트 디렉터리 전체에 접근할 수 있게 됩니다.

요구 사항

• Overleaf 프리미엄 (기관의 접근 권한을 확인하세요!)

• uv, git, TeX 배포판, pdftocairo (Mac에서는 brew install poppler로 설치할 수 있습니다)

Related MCP server: overleaf-mcp

설정

1. 리포지토리를 클론합니다.

2. ~/.overleaf-mcp/projects.json을 생성합니다. 예시는 projects.json.example에 있습니다. 프로젝트 ID는 Overleaf URL에서 /project/ 뒤에 오는 문자열입니다.

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

3. Claude 설정에 서버를 추가합니다. git 토큰은 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. Claude를 다시 시작합니다.

작동 방식

프로젝트는 open_project가 성공할 때까지 unverified 상태이며, open_project는 모든 \usepackage가 로컬 TeX 환경에서 확인되는지 검사하고 각 루트를 기준으로 컴파일합니다.

모든 쓰기는 open_project가 통과할 때까지 거부됩니다.

\documentclass를 포함하는 .tex 파일은 루트이며, 자식 파일은 \input/\include/\subfile로 포함됩니다. 자식 파일을 편집하면 이를 포함하는 루트가 다시 컴파일됩니다. 예를 들어, 이 규칙은 표준 main.tex + sections/ 프로젝트, 단일 파일 논문, 또는 같은 규칙이 적용되는 독립형 한 페이지 문서 폴더를 모두 포괄합니다. 또한 오류가 있으면 push가 차단되며 경고는 보고만 됩니다.

도구