> ## 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/uk/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md), і MCP-сервер теж стане доступним. Більше нічого налаштовувати не потрібно.

### Підключення ШІ-клієнта

1. У **налаштуваннях облікового запису** згенеруйте токен автентифікації Git. Той самий токен використовується і для MCP-сервера, і для Git.
2. У редакторі відкрийте **Інтеграції** та натисніть **MCP-сервер**. Там показано адресу 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/uk/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.