overleaf-claude-mcp

Подключите Claude к вашей учётной записи Overleaf. Claude может просматривать список ваших проектов, выбирать нужный, читать LaTeX-файлы и изображения, редактировать файлы, компилировать и забирать готовый PDF.

У Overleaf нет публичного API на бесплатном тарифе: Git-мост и синхронизация с Dropbox доступны только в Premium. Поэтому этот сервер использует те же внутренние HTTP- и сокетные эндпоинты, что и веб-приложение Overleaf, авторизуясь через браузерную сессию, которую вы создаёте один раз. Каждый эндпоинт был извлечён из JavaScript-бандла самого Overleaf и проверен на реальном аккаунте. См. Проверенные эндпоинты.

Учебник

Что потребуется

• Node 20 или новее (node -v)

• Установленный Chrome или Edge

• Учётная запись Overleaf, подойдёт и бесплатный тариф

• Claude Code (claude --version) или Claude Desktop

Шаг 1: Запустите настройку

Из этой папки в Windows:

setup.cmd

В macOS или Linux:

./setup.sh

Настройка выполнит пять шагов и выведет каждый из них:

1. Установит зависимости

2. Соберёт проект в dist/

3. Проверит наличие рабочей сессии Overleaf. Если её нет, в браузере откроется страница входа в Overleaf

4. Прочитает один из ваших реальных проектов, чтобы убедиться, что подключение работает

5. Предложит зарегистрировать сервер в Claude Code

Шаг 2: Войдите, когда откроется браузер

Окно браузера — это настоящий Chrome. Войдите обычным способом, включая двухфакторную аутентификацию. Никто не вводит за вас пароль, и ваш пароль никогда не считывается и не сохраняется.

Как только вы попадёте на страницу со списком проектов, окно закроется само, и настройка продолжится. Файлы cookie вашей сессии сохраняются в ~/.overleaf-claude-mcp/session.json.

Этот файл равносилен полному доступу к вашей учётной записи Overleaf. Он добавлен в .gitignore и создаётся с правами 0600. Не передавайте его никому и не коммитьте.

Шаг 3: Разрешите настройке зарегистрировать сервер

На шаге 5 появится запрос:

      Register this server with Claude Code now? [y/N]

Ответьте y. Будет выполнено:

claude mcp add overleaf -- node C:/CoolYEAH/overleaf-claude-mcp/dist/index.js

Если вы пропустили этот шаг или используете другой клиент, зарегистрируйте сервер вручную. Для Claude Code выполните команду выше. Для Claude Desktop отредактируйте %APPDATA%\Claude\claude_desktop_config.json в Windows или ~/Library/Application Support/Claude/claude_desktop_config.json в macOS:

{
  "mcpServers": {
    "overleaf": {
      "command": "node",
      "args": ["C:/CoolYEAH/overleaf-claude-mcp/dist/index.js"]
    }
  }
}

Шаг 4: Перезапустите Claude

MCP-серверы подхватываются только при запуске. Закройте и снова откройте Claude Code или Claude Desktop.

Убедитесь, что сервер загрузился:

claude mcp list

Вы должны увидеть overleaf в списке подключённых. В сессии Claude Code то же самое показывает /mcp.

Шаг 5: Используйте

Просто сформулируйте запрос обычным языком. Claude сам выберет нужные инструменты.

List my Overleaf projects

Select the Efficient Reasoning project

Read sections/methodology.tex

In sections/results.tex, change "Table 1" to "Table~\ref{tab:main}"

Compile it and tell me what the LaTeX errors are

Show me figures/fig1.png

Save the compiled PDF to C:/tmp/paper.pdf

Выберите проект один раз — и он запомнится. Выбор сохраняется в ~/.overleaf-claude-mcp/state.json и переживает перезапуски, поэтому все последующие запросы будут применяться к этому проекту, пока вы его не смените. Чтобы в одном запросе поработать с другим проектом, не переключаясь, назовите его: «прочитай main.tex из моего проекта thesis».

Related MCP server: claudeleaf

Как это запускается

Никаких слеш-команд и ничего печатать не нужно. Claude читает описания инструментов и вызывает их, когда ваш запрос им соответствует. Достаточно упомянуть Overleaf или уже выбранный проект или файл.

Если Claude не использует инструменты, обычно причина в одном из двух: вы не перезапустили Claude после регистрации, или проект ещё не выбран. Спросите «какой проект Overleaf выбран?», чтобы проверить.

Инструменты

overleaf_select_project принимает id проекта или любую часть имени. Если имя соответствует нескольким проектам, он выведет список кандидатов, а не будет угадывать. overleaf_delete откажется выполниться, если confirm не равен true, так что случайно удалить файл Claude не сможет.

Устранение неполадок

«No Overleaf session at ...» — вы ещё не вошли в систему или срок сессии истёк. Выполните npm run login или снова запустите setup.cmd.

Claude не видит инструменты — вы не перезапустили Claude после регистрации. Проверьте claude mcp list.

Инструмент внезапно перестал работать — возможно, Overleaf изменил какой-то эндпоинт. Запустите npm run recon, который проверит каждый эндпоинт в режиме чтения и точно укажет, какой вызов сломался.

Проверьте настройки из терминала, без Claude:

npm run read -- "Efficient Reasoning"

Выводит дерево файлов и все заголовки разделов подходящего проекта. Добавьте путь, чтобы вывести один файл:

npm run read -- "Efficient Reasoning" sections/methodology.tex

Запускайте настройку заново в любое время. Она переиспользует рабочую сессию и заново проверяет подключение, так что это ещё и проверка работоспособности.

Как это работает

Дерево файлов берётся из сокетного соединения Overleaf, потому что только оно содержит идентификаторы сущностей, а они нужны для записи. Рукопожатие — это GET /socket.io/1/?projectId=<id> в формате socket.io 0.9; затем сервер отправляет joinProjectResponse со всем проектом, включая rootFolder, идентификаторы документов и хеши файлов. Дерево кэшируется на OVERLEAF_TREE_TTL_MS (по умолчанию 15 секунд) и сбрасывается после каждой записи.

Текстовые файлы читаются по одному документу, поэтому чтение всегда отражает текущее состояние. overleaf_grep вместо этого читает архив проекта, так что поиск по всему проекту обходится в один запрос, а не в один на файл.

Запись идёт через эндпоинт загрузки. Загрузка поверх существующего имени — это обновление на месте: идентификатор сущности сохраняется, поэтому история Overleaf и другие участники документа продолжают работать. Недостающие родительские папки создаются автоматически.

Проверенные эндпоинты

Подтверждено на реальном аккаунте, а не предположительно:

:type — это doc, file или folder.

Скрипты

npm run smoke создаёт проект claude-mcp-smoketest, затем выполняет запись, перезапись, загрузку изображения, переименование, перемещение, удаление и компиляцию. Проект остаётся в вашем аккаунте, чтобы вы могли его изучить. Удалите его, когда закончите.

Конфигурация

Всё необязательно. См. .env.example.

Ограничения

Всё это не является поддерживаемым API, и Overleaf может изменить его в любой момент. Используйте только со своей учётной записью. Совместное редактирование в реальном времени не реализовано: запись заменяет целый документ, а не отправляет операции на уровне символов, поэтому избегайте записи в файл, пока кто-то другой в нём печатает.