> ## 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.

# Server MCP

> Připojte AI klienta, například Claude Code, k projektu přes MCP, ověřte, že připojení funguje, a zjistěte, co klient umí.

Každý projekt má vlastní server MCP, takže AI klient ve vašem počítači může projekt číst a upravovat, kompilovat ho a odpovídat na jeho komentáře. Klient se přihlašuje pomocí ověřovacího tokenu Git.

> [!NOTE]
>
> Pokud nevidíte kartu **MCP server**, odkažte správce na stránku [Server MCP](https://ayakaleaf-pro.mintlify.site/cs/on-premises/configuration/overleaf-toolkit/integrations/mcp-server.md).

## Novinky ve v6.3.3

Od v6.3.3 může klient pracovat i s historií projektu: vypisovat změny, porovnávat dvě verze, číst soubor v dřívější podobě, ukládat a mazat verze a obnovit soubor nebo celý projekt. Může vypsat sledované změny a přijmout nebo odmítnout je a na vaši žádost dělat vlastní úpravy jako sledované změny. Může komentovat úsek textu a upravovat nebo mazat zprávy komentářů, číst a posílat zprávy v chatu projektu, přesouvat a přejmenovávat soubory a složky, vytvářet složky a měnit jazyk kontroly pravopisu. Kdo smí co dělat, se řídí vaší rolí v projektu, stejně jako v editoru, protože klient pracuje s vaším tokenem: viz [Kdo smí co](#who-may-do-what).

Server MCP byl představen ve v6.3.1. Verze v6.3.1 a v6.3.2 mají stejných 17 nástrojů; v6.3.3 jich má 33.

| Nástroje | v6.3.1 a v6.3.2 | v6.3.3 |
| - | - | - |
| `get_clone_info`, `get_settings`, `list_files`, `delete_file`, `compile`, `get_compile_log`, `get_output_file_link`, `word_count`, `reply_to_comment`, `resolve_comment`, `reopen_comment` | Ano | Ano, beze změny |
| `read_file` | Nejnovější obsah | Také soubor v podobě k dané `version` |
| `edit_file`, `write_file` | Řídí se nastavením sledování změn projektu | Také `trackChanges`, aby úprava byla sledovanou změnou |
| `update_settings` | Kompilátor, obraz TeX Live a hlavní dokument | Také jazyk kontroly pravopisu |
| `list_versions` | Verze, komentář a datum | Také `id`, které přijímá `delete_version`, a kdo verzi uložil |
| `list_comments` | Zprávy bez id | Také `id` každé zprávy, které přijímají `edit_comment_message` a `delete_comment_message` |
| `list_changes`, `diff`, `create_version`, `delete_version`, `restore_file`, `restore_project`, `list_tracked_changes`, `accept_tracked_changes`, `reject_tracked_changes`, `add_comment`, `edit_comment_message`, `delete_comment_message`, `list_chat_messages`, `send_chat_message`, `move_file`, `create_folder` | Ne | Ano |

## Připojení klienta

**1. Otevřete dialog**

Otevřete projekt. Na levém panelu klikněte na **Integrations** a potom na **MCP server**.

![Panel Integrations s kartou MCP server](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/mcp-server-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=c38ad3def0079dc27b1774c7e0487482)

Panel Integrations

Dialog zobrazuje adresu serveru tohoto projektu a kartu pro každého klienta: **Claude Code**, **Codex**, **Cursor**, **VS Code** a **Gemini CLI**.

![Dialog MCP server s adresou, kartou pro každého klienta a příkazem pro Claude Code](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/mcp-server-dialog.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e8554732779d9c6c7fb0cf0240364ce5)

Dialog MCP server

**2. Vytvořte token**

Klikněte na **Go to settings**. Nastavení účtu se otevře na nové kartě. V části **Git integration** klikněte na **Generate token**, nebo na **Add another token**, pokud už token máte. Klikněte na **Copy** a token si bezpečně uložte, protože ho uvidíte jen jednou. Pak klikněte na **Close**.

![Dialog Git authentication token s tlačítkem Copy](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/mcp-server-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f4661b468dd1d409ef19967216955ae4)

Váš nový token

Funguje i token, který už používáte pro [integraci s Gitem](https://ayakaleaf-pro.mintlify.site/cs/on-premises/user-guide/users/git-integration.md), a jeden token můžete použít pro všechny své projekty.

**3. Přidejte server do klienta**

Vraťte se do dialogu, klikněte na kartu svého klienta a pak na **Copy** vedle konfigurace.

| Karta | Kam patří | Token |
| - | - | - |
| **Claude Code** | Spusťte příkaz v terminálu | Nahraďte `<token>` v příkazu |
| **Codex** | `~/.codex/config.toml` | Vložte ho do proměnné prostředí `OVERLEAF_TOKEN` |
| **Cursor** | `~/.cursor/mcp.json` | Vložte ho do proměnné prostředí `OVERLEAF_TOKEN` |
| **VS Code** | `.vscode/mcp.json` | Soubor místo tokenu obsahuje výzvu k zadání hesla s názvem `overleaf-token` |
| **Gemini CLI** | Spusťte příkaz v terminálu | Nahraďte `<token>` v příkazu |

Adresa patří k jednomu projektu. Chcete-li připojit další projekt, přidejte ho pod jiným názvem, protože `overleaf` je už obsazený. Například v Claude Code změňte v příkazu `overleaf` na `overleaf-lab`.

## Ověření připojení

### Pomocí Claude Code

```bash theme={null}
claude mcp list
```

Server je uveden jako připojený:

```text theme={null}
overleaf: https://<your-site>/project/<project-id>/mcp (HTTP) - ✔ Connected
```

### Pomocí curl

Funguje to bez ohledu na klienta. Nahraďte adresu a token a odešlete požadavek `initialize` protokolu MCP:

```bash theme={null}
curl -X POST https://<your-site>/project/<project-id>/mcp \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'
```

Odpověď uvádí název serveru a za ním jeho pokyny pro klienty:

```json theme={null}
{"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{"listChanged":true}},"serverInfo":{"name":"overleaf","version":"1.0.0"},"instructions":"This server works on one Overleaf project. ..."},"jsonrpc":"2.0","id":1}
```

Chcete-li vidět nástroje, pošlete stejným příkazem `tools/list`. Odpověď obsahuje 33 nástrojů, nebo 31, pokud má váš web chat projektu vypnutý. Před v6.3.3 jich obsahuje 17.

```bash theme={null}
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
```

Chcete-li některý zavolat, pošlete `tools/call`:

```bash theme={null}
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_files","arguments":{}}}'
```

```json theme={null}
{"result":{"content":[{"type":"text","text":"[\n  {\n    \"path\": \"main.tex\",\n    \"type\": \"doc\"\n  }\n]"}]},"jsonrpc":"2.0","id":3}
```

### V nastavení účtu

V části **Git integration** ukazuje **Last used** datum u tokenu, který server přijal.

![Seznam tokenů s datem v Last used u prvního tokenu a N/A u druhého](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/mcp-server-last-used.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=2abe32cb469d17b8b8c5eb18f1c0c2d3)

První token byl použit

### Pokud se nepřipojí

| Co vidíte | Co to znamená |
| - | - |
| Stav `401`, nebo v Claude Code `✘ Failed to connect` s `HTTP 401` | Token chybí, je chybný nebo smazaný |
| Stav `404` | Žádný projekt nemá toto ID |
| Stav `405` | Požadavek nebyl `POST` |
| Stav `406` s `Not Acceptable` | Chybí hlavička `Accept`: klient musí přijímat `application/json` i `text/event-stream` |

## Co vidíte, když klient pracuje

Úpravy se zobrazují v otevřeném editoru průběžně, jak je klient provádí, stejně jako úpravy spolupracovníka, bez opětovného načtení. Nové soubory a složky, přesuny a přejmenování se objeví ve stromu souborů.

![Editor zobrazuje řádek, který přidal edit\_file, bez dialogu a bez opětovného načtení](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/mcp-server-live-edit.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=51163f1de5bec88d50bd96089bd1a9a2)

Řádek přidaný pomocí edit\_file

`edit_file` mění jen text, který se vyskytuje právě jednou. Jinak klient dostane chybu, například `oldString not found in main.tex, read_file again` nebo `oldString appears 2 times in main.tex, add context`, a nic se nezmění.

Od v6.3.3 `move_file` přesune nebo přejmenuje soubor či složku a podle potřeby vytvoří složky nové cesty, a `create_folder` vytvoří složku. Pokud soubor nebyl nalezen nebo nová cesta už existuje, klient dostane chybu a nic se nezmění. `update_settings` může také změnit jazyk kontroly pravopisu, například na `de`, nebo kontrolu vypnout.

Odpovědi na komentáře se v panelu revizí zobrazují pod vaším jménem, protože token je váš. Komentář vyřešený přes server z panelu zmizí a jeho znovuotevření ho vrátí.

![Komentář v panelu revizí s odpovědí odeslanou pomocí reply\_to\_comment](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/mcp-server-comment.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=7b5cd74110b014b389bae7209b1330f0)

Odpověď odeslaná pomocí reply\_to\_comment

Od v6.3.3 `add_comment` komentuje úsek textu. Text se musí v souboru vyskytovat právě jednou; když se vyskytuje vícekrát, klient uvede i delší okolní úsek, který se vyskytuje jednou, a okomentován je jen samotný text. Komentář se v panelu revizí zobrazí pod vaším jménem a zůstává u svého textu, i když se soubor mění. `edit_comment_message` změní jednu z vašich vlastních zpráv. `delete_comment_message` smaže zprávu a smazání první zprávy smaže celý komentář, stejně jako v panelu revizí.

`compile` zkompiluje projekt a vrátí seznam výstupních souborů. `get_output_file_link` pak poskytne odkaz ke stažení PDF nebo jiného výstupního souboru. Odkaz nepotřebuje token a po 5 minutách přestane fungovat.

Úplný seznam nástrojů najdete v části [Tools](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/integrations/mcp-server.md#tools).

## Sledované změny

Od v6.3.3 můžete klienta požádat, aby své úpravy dělal jako sledované změny, například *Rewrite the abstract as a tracked change*. `edit_file` a `write_file` pak udělají ze změny existujícího souboru sledovanou změnu pod vaším jménem, i když je sledování změn v projektu vypnuté, a vy ji v panelu revizí přijmete nebo odmítnete. Nový soubor nikdy není sledovanou změnou. Pokud o to nepožádáte, úpravy se řídí nastavením sledování změn projektu, stejně jako vaše v editoru: sledují se, když je sledování zapnuté pro vás nebo pro všechny.

Pokud účet vlastníka projektu nemá sledování změn, klient dostane `Track changes is off for this project` a nic se nezmění.

Chcete-li kontrolovat každou úpravu klienta, zapněte sledování změn pro sebe. Chcete-li jeho úpravy v panelu revizí odlišit od svých, dejte klientovi token jiného účtu, se kterým projekt sdílíte.

`list_tracked_changes` vypíše sledované změny s jejich souborem, vloženým nebo smazaným textem, autorem a časem. `accept_tracked_changes` a `reject_tracked_changes` přijímají id změn a fungují jako panel revizí: přijatá změna zůstane v textu, odmítnuté vložení se odstraní a odmítnuté smazání se vrátí. Otevřený editor zobrazí výsledek bez opětovného načtení. Nástroje klientovi říkají, aby přijímal nebo odmítal jen ty změny, o které požádáte.

## Historie

Od v6.3.3 vidí klient historii projektu tak, jak ji zobrazuje panel historie.

| Nástroj | Co dělá |
| - | - |
| `list_changes` | Vypíše změny od nejnovějších: kdo, kdy a které soubory změnil, s verzemi před každou změnou a po ní. Starší změny přicházejí v dalších dávkách. |
| `diff` | Porovná dvě verze: jeden soubor jako unified diff, jako `git diff`, nebo soubory, které byly přidány, odstraněny, upraveny nebo přejmenovány |
| `read_file` s `version` | Přečte soubor v podobě k dané verzi |
| `list_versions` | Vypíše uložené verze s komentářem a tím, kdo je uložil |
| `create_version` | Uloží nejnovější nebo dřívější verzi s komentářem, jako **Label this version** |
| `delete_version` | Smaže uloženou verzi; její změny zůstanou |
| `restore_file` | Obnoví soubor do podoby k dané verzi, jako **Restore this version** |
| `restore_project` | Obnoví celý projekt do podoby k dané verzi, jako **Restore project to this version** |

Obnovení je samo o sobě novou změnou, takže ho můžete vrátit stejným způsobem. Nástroje klientovi říkají, aby obnovoval jen na vaši žádost.

Pokud vlastník projektu nemá úplnou historii projektu, klient vidí jen změny za posledních 24 hodin, nebo nejnovější změnu, pokud jsou všechny starší, stejně jako v panelu historie. Starší verze nemůže porovnávat, číst ani obnovovat.

## Chat projektu

Od v6.3.3 `list_chat_messages` čte chat projektu od nejnovějších zpráv, po 50 zprávách. `send_chat_message` pošle zprávu pod vaším jménem a ta se hned objeví v otevřeném chatu. Pokud má váš web chat projektu vypnutý, klient nemá ani jeden z těchto nástrojů.

## Kdo smí co

Klient smí dělat to, co dovoluje vaše role v projektu.

| Co klient dělá | Vlastník | Editor | Recenzent | Čtenář (jmenovaný spolupracovník) | Čtenář (sdílení odkazem) |
| - | -: | -: | -: | -: | -: |
| Číst soubory a nastavení, kompilovat, číst log, stahovat PDF | Ano | Ano | Ano | Ano | Ano |
| Zapisovat, upravovat, přesouvat a mazat soubory, vytvářet složky, měnit nastavení | Ano | Ano | Ne | Ne | Ne |
| Vidět historii, komentáře a sledované změny | Ano | Ano | Ano | Ano | Ne |
| Číst a posílat zprávy v chatu | Ano | Ano | Ano | Ano | Ne |
| Přidávat komentáře a odpovídat na ně | Ano | Ano | Ano | Ne | Ne |
| Vyřešit, znovu otevřít nebo smazat komentář | Ano | Ano | Ty, které sám založil | Ne | Ne |
| Upravit zprávu komentáře | Vlastní | Vlastní | Vlastní | Ne | Ne |
| Smazat zprávu komentáře | Ano | Ano | Vlastní | Ne | Ne |
| Přijmout nebo odmítnout sledované změny | Ano | Ano | Ne | Ne | Ne |
| Uložit verzi | Ano | Ano | Ano | Ne | Ne |
| Smazat uloženou verzi | Ano | Ty, které sám uložil | Ty, které sám uložil | Ne | Ne |
| Obnovit soubor nebo projekt | Ano | Ano | Ne | Ne | Ne |

Editoři, kteří se připojili přes odkaz, se počítají jako editoři. Recenzenti nemohou upravovat soubory přes MCP, a to ani jako sledované změny.

## Odpojení klienta

Smažte token: viz [Smazání tokenu](https://ayakaleaf-pro.mintlify.site/cs/on-premises/user-guide/users/git-integration.md#delete-a-token). Od té chvíle server na tento token odpovídá `401`. Pokud ho používáte i pro Git, přestane ho přijímat i Git.


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