> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP-сервер

> Подключайте к проекту ИИ-клиенты, такие как Claude Code или Codex, через его MCP-сервер.

У каждого проекта есть MCP-сервер, поэтому ИИ-клиенты, такие как Claude Code, Codex, Cursor, VS Code или Gemini CLI, могут работать над ним: читать и редактировать его файлы, компилировать проект, читать журнал LaTeX, скачивать PDF и отвечать на комментарии.

> [!NOTE]
>
> Эта функция разработана в [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro). Она доступна начиная с версии v6.3.1.

![](https://mintcdn.com/ayakaleaf-pro/75JEUzv4DcYJF7Z-/images/on-premises/8b4eca630b3083da54177b4e7a431571.png?fit=max\&auto=format\&n=75JEUzv4DcYJF7Z-\&q=85\&s=73546d80edf492bf43df53303023ca29)

![](https://mintcdn.com/ayakaleaf-pro/z0f8sws6lnhMSWO4/images/on-premises/img-c48f4f64.png?fit=max\&auto=format\&n=z0f8sws6lnhMSWO4\&q=85\&s=b6f33a465bae9952ce7be3bcb15c57c5)

### Настройка

MCP-сервер входит в состав интеграции с Git: включите [git-bridge](https://ayakaleaf-pro.mintlify.site/ru/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md), и MCP-сервер тоже станет доступен. Больше ничего настраивать не нужно.

### Подключение ИИ-клиента

1. В **настройках учётной записи** (**Account Settings**) создайте токен аутентификации Git. Один и тот же токен используется и для MCP-сервера, и для Git.
2. В редакторе откройте **Integrations** и нажмите **MCP server**. Там показан адрес MCP-сервера проекта, `https://<your-overleaf>/project/<project_id>/mcp`, и способ добавить его в каждый ИИ-клиент: скопируйте команду и замените `<token>` своим токеном.

Токен передаётся в HTTP-заголовке `Authorization: Bearer <token>`. Например, команда для Claude Code выглядит так:

```bash theme={null}
claude mcp add --transport http overleaf \
  https://<your-overleaf>/project/<project_id>/mcp \
  --header "Authorization: Bearer <token>"
```

### Использование

После подключения обращайтесь к ИИ-клиенту обычными словами. Например:

| Ваш запрос | Что использует ИИ-клиент |
| - | - |
| *Исправь опечатки во введении.* | `read_file`, `edit_file`: правки сразу отображаются в редакторе |
| *Скомпилируй проект и исправь ошибки LaTeX.* | `compile`, `get_compile_log`, `edit_file` |
| *Ответь на открытые комментарии, затем отметь их как решённые.* | `list_comments`, `reply_to_comment`, `resolve_comment` |
| *Переключись на XeLaTeX и скачай PDF.* | `update_settings`, `compile`, `get_output_file_link` |

### Инструменты

| Группа | Инструменты |
| - | - |
| Проект | `get_clone_info`, `get_settings`, `update_settings`, `list_versions` |
| Файлы | `list_files`, `read_file`, `edit_file`, `write_file`, `delete_file` |
| Компиляция | `compile`, `get_compile_log`, `get_output_file_link`, `word_count` |
| Комментарии | `list_comments`, `reply_to_comment`, `resolve_comment`, `reopen_comment` |

Правки, внесённые с помощью `edit_file` и `write_file`, сразу отображаются в редакторе и объединяются с правками соавторов. Для изменения сразу многих файлов, работы с бинарными файлами или переименований ИИ-клиент также может клонировать проект с помощью Git и выполнить push.

### Права доступа

MCP-сервер, как и Git, следует настройкам совместного доступа к проекту:

* Все, кто может просматривать проект, могут читать его, компилировать и скачивать результаты компиляции.
* Изменять файлы и настройки проекта могут только владелец и редакторы.
* Рецензенты также могут отвечать на комментарии, а также отмечать как решённые или повторно открывать начатые ими комментарии.
* Пользователи с правами на просмотр, присоединившиеся по ссылке, не видят комментарии, как и в редакторе.

### Вопросы и ответы

> [accordion] Я не вижу Integrations или MCP server в редакторе
>
> **Ответ:** У MCP-сервера нет собственной переменной окружения. Он включается с помощью `GIT_BRIDGE_ENABLED=true` в `config/overleaf.rc`, см. [Интеграция с Git](https://ayakaleaf-pro.mintlify.site/ru/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md). После изменения выполните `bin/up -d`. Без git-bridge редактор не показывает вкладку **Integrations** на левой панели.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.