MCP-сервер каждого проекта работает в сервисе web (модуль mcp-server) каждого пода Ayakaleaf Pro. Он входит в состав интеграции с Git и не имеет собственных настроек. Как подключить Claude Code, Codex и другие клиенты, описано на странице MCP-сервер.
Настройка
Настройте интеграцию с Git. После этого MCP-сервер доступен по адресу ${OVERLEAF_SITE_URL}/project/<project id>/mcp, и этот адрес должен быть доступен оттуда, где работает ИИ-клиент.
Несколько реплик
Компиляция через MCP выполняется на реплике, получившей запрос, и её журнал и PDF существуют только там. ИИ-клиенты не отправляют cookie, поэтому балансировщик нагрузки может направить следующий запрос — get_compile_log или ссылку для скачивания PDF — на другую реплику, которая ответит «failed to fetch output file from CLSI» или 404. В нашем тесте с тремя репликами без дополнительного правила таким образом завершились ошибкой 5 из 6 запросов журнала и 3 из 4 скачиваний.
Направляйте все MCP-запросы проекта на одну реплику, как и для /git/. С HAProxy из раздела Горизонтальное масштабирование:
Тогда все MCP-компиляции выполняются на узле overleaf-0. С другим ingress-контроллером направляйте путь /project/<id>/mcp и всё, что под ним, на собственное имя одной реплики (overleaf-0.overleaf-hl).
С этим правилом тот же тест (компиляция, 6 запросов журнала и 4 скачивания PDF, все без cookie) каждый раз завершался успешно.
Проверено на Kubernetes
В Kubernetes 1.37 с тремя репликами за HAProxy наши сквозные тесты MCP-сервера проходят (37 сценариев): получение списка инструментов, отклонение неверных, удалённых токенов или токенов без доступа, компиляция и чтение журнала, подсчёт слов, настройки и история проекта, ссылки для скачивания PDF, редактирование файлов с отображением изменений в реальном времени в открытом редакторе и их получением в Git-клоне, комментарии, доступ по ролям, ограничения частоты компиляций и изменения настроек, а также заблокированные учётные записи. Эти запросы поступали из сеанса браузера, поэтому балансировщик нагрузки удерживал их на одной реплике; о клиентах без cookie см. Несколько реплик. Последнее изменение 2 ноября 2026 г.
