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

> Koble en AI-klient som Claude Code til et prosjekt via MCP, kontroller at tilkoblingen fungerer, og se hva klienten kan gjøre.

Hvert prosjekt har sin egen MCP-server, slik at en AI-klient på datamaskinen din kan lese og redigere prosjektet, kompilere det og svare på kommentarene. Klienten logger inn med et Git-autentiseringstoken.

> [!NOTE]
>
> Hvis du ikke ser noe **MCP server**-kort, viser du administratoren til [MCP-server](https://ayakaleaf-pro.mintlify.site/no/on-premises/configuration/overleaf-toolkit/integrations/mcp-server.md).

## Nytt i v6.3.3

Fra v6.3.3 kan klienten også arbeide med prosjekthistorikken: liste opp endringene, sammenligne to versjoner, lese en fil slik den var, lagre og slette versjoner og gjenopprette en fil eller hele prosjektet. Den kan liste opp sporede endringer og godta eller avvise dem, og gjøre sine egne redigeringer til sporede endringer når du ber om det. Den kan kommentere et tekstavsnitt og redigere eller slette kommentarmeldinger, lese og sende meldinger i prosjektchatten, flytte og gi nytt navn til filer og mapper, opprette mapper og endre språket for stavekontroll. Hvem som kan gjøre hva, følger rollen din i prosjektet, som i redigeringsprogrammet, fordi klienten arbeider med tokenet ditt: se [Hvem kan gjøre hva](#who-may-do-what).

MCP-serveren ble introdusert i v6.3.1. v6.3.1 og v6.3.2 har de samme 17 verktøyene; v6.3.3 har 33.

| Verktøy | v6.3.1 og 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` | Ja | Ja, uendret |
| `read_file` | Det nyeste innholdet | Også en fil slik den var ved en `version` |
| `edit_file`, `write_file` | Følger prosjektets innstilling for sporede endringer | Også `trackChanges`, for å gjøre redigeringen til en sporet endring |
| `update_settings` | Kompilator, TeX Live-avbildning og hoveddokument | Også språket for stavekontroll |
| `list_versions` | Versjon, kommentar og dato | Også `id` som `delete_version` tar imot, og hvem som lagret den |
| `list_comments` | Meldinger uten id | Også `id` for hver melding, som `edit_comment_message` og `delete_comment_message` tar imot |
| `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` | Nei | Ja |

## Koble til en klient

**1. Åpne dialogen**

Åpne prosjektet. Klikk på **Integrations** i venstre felt, og deretter på **MCP server**.

![Panelet Integrations med kortet 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)

Panelet Integrations

Dialogen viser adressen til prosjektets server og en fane for hver klient: **Claude Code**, **Codex**, **Cursor**, **VS Code** og **Gemini CLI**.

![Dialogen MCP server med adressen, en fane for hver klient og kommandoen for 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)

Dialogen MCP server

**2. Opprett et token**

Klikk på **Go to settings**. Kontoinnstillingene dine åpnes i en ny fane. Under **Git integration** klikker du på **Generate token**, eller på **Add another token** hvis du allerede har ett. Klikk på **Copy** og oppbevar tokenet på et trygt sted, fordi du bare ser det én gang. Klikk deretter på **Close**.

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

Det nye tokenet ditt

Et token du allerede bruker til [Git-integrasjon](https://ayakaleaf-pro.mintlify.site/no/on-premises/user-guide/users/git-integration.md), fungerer også, og det gjør ett token for alle prosjektene dine også.

**3. Legg serveren til i klienten**

Tilbake i dialogen klikker du på fanen for klienten din og deretter på **Copy** ved siden av konfigurasjonen.

| Fane | Hvor den skal | Tokenet |
| - | - | - |
| **Claude Code** | Kjør kommandoen i en terminal | Erstatt `<token>` i kommandoen |
| **Codex** | `~/.codex/config.toml` | Legg det i miljøvariabelen `OVERLEAF_TOKEN` |
| **Cursor** | `~/.cursor/mcp.json` | Legg det i miljøvariabelen `OVERLEAF_TOKEN` |
| **VS Code** | `.vscode/mcp.json` | Filen har en passordforespørsel kalt `overleaf-token` i stedet for tokenet |
| **Gemini CLI** | Kjør kommandoen i en terminal | Erstatt `<token>` i kommandoen |

Adressen tilhører ett prosjekt. For å koble til et annet prosjekt legger du det til under et annet navn, fordi `overleaf` allerede er tatt. For Claude Code endrer du for eksempel `overleaf` i kommandoen til `overleaf-lab`.

## Kontroller tilkoblingen

### Med Claude Code

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

Serveren vises som tilkoblet:

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

### Med curl

Dette fungerer uansett klient. Erstatt adressen og tokenet, og send `initialize`-forespørselen i MCP-protokollen:

```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"}}}'
```

Svaret oppgir navnet på serveren, etterfulgt av instruksjonene for klienter:

```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}
```

For å se verktøyene sender du `tools/list` med samme kommando. Svaret viser 33 verktøy, eller 31 hvis nettstedet ditt har slått av prosjektchatten. Før v6.3.3 vises 17.

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

For å kalle et verktøy sender du `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}
```

### I kontoinnstillingene dine

Under **Git integration** viser **Last used** datoen for et token serveren har mottatt.

![Tokenlisten, med en dato under Last used for det første tokenet og N/A for det andre](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/mcp-server-last-used.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=2abe32cb469d17b8b8c5eb18f1c0c2d3)

Det første tokenet er brukt

### Hvis den ikke kobler til

| Hva du ser | Hva det betyr |
| - | - |
| Status `401`, eller i Claude Code `✘ Failed to connect` med `HTTP 401` | Tokenet mangler, er feil eller er slettet |
| Status `404` | Ingen prosjekter har denne ID-en |
| Status `405` | Forespørselen var ikke en `POST` |
| Status `406` med `Not Acceptable` | Overskriften `Accept` mangler: klienten må godta både `application/json` og `text/event-stream` |

## Hva du ser når en klient arbeider

Redigeringer vises i et åpent redigeringsprogram etter hvert som klienten gjør dem, som en samarbeidspartners, uten ny innlasting. Nye filer og mapper, flyttinger og navneendringer vises i filtreet.

![Redigeringsprogrammet viser en linje som edit\_file la til, uten dialog og uten ny innlasting](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/mcp-server-live-edit.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=51163f1de5bec88d50bd96089bd1a9a2)

En linje lagt til av edit\_file

`edit_file` endrer bare tekst som forekommer nøyaktig én gang. Ellers får klienten en feil, for eksempel `oldString not found in main.tex, read_file again` eller `oldString appears 2 times in main.tex, add context`, og ingenting endres.

Fra v6.3.3 flytter eller gir `move_file` nytt navn til en fil eller mappe og oppretter mappene i den nye stien ved behov, og `create_folder` oppretter en mappe. Hvis filen ikke finnes eller den nye stien allerede finnes, får klienten en feil og ingenting endres. `update_settings` kan også endre språket for stavekontroll, for eksempel til `de`, eller slå av stavekontrollen.

Svar på kommentarer vises i gjennomgangspanelet under navnet ditt, fordi tokenet er ditt. En kommentar som løses via serveren, forsvinner fra panelet, og hvis den åpnes igjen, kommer den tilbake.

![En kommentar i gjennomgangspanelet med et svar sendt av 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)

Et svar sendt av reply\_to\_comment

Fra v6.3.3 kommenterer `add_comment` et tekstavsnitt. Teksten må forekomme nøyaktig én gang i filen; når den forekommer flere ganger, oppgir klienten også et lengre avsnitt rundt den som forekommer én gang, og bare teksten kommenteres. Kommentaren vises i gjennomgangspanelet under navnet ditt og blir værende ved teksten sin når filen endres. `edit_comment_message` endrer en av dine egne meldinger. `delete_comment_message` sletter en melding, og sletting av den første sletter hele kommentaren, som i gjennomgangspanelet.

`compile` kompilerer prosjektet og returnerer listen over utdatafiler. `get_output_file_link` gir deretter en lenke for å laste ned PDF-en eller en annen utdatafil. Lenken trenger ikke token og slutter å virke etter 5 minutter.

Den fullstendige listen over verktøy finner du under [Tools](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/integrations/mcp-server.md#tools).

## Sporede endringer

Fra v6.3.3 kan du be klienten om å gjøre redigeringene sine til sporede endringer, for eksempel *Rewrite the abstract as a tracked change*. `edit_file` og `write_file` gjør da endringen i en eksisterende fil til en sporet endring i ditt navn, selv når sporing av endringer er slått av i prosjektet, og du godtar eller avviser den i gjennomgangspanelet. En ny fil er aldri en sporet endring. Hvis du ikke ber om det, følger redigeringene prosjektets innstilling for sporede endringer, som dine i redigeringsprogrammet: de spores når sporingen er på for deg eller for alle.

Hvis kontoen til prosjekteieren ikke har sporede endringer, får klienten `Track changes is off for this project`, og ingenting endres.

For å gå gjennom hver redigering klienten gjør, slår du på sporede endringer for deg selv. For å skille redigeringene dens fra dine i gjennomgangspanelet gir du klienten tokenet til en annen konto som du deler prosjektet med.

`list_tracked_changes` viser de sporede endringene med fil, innsatt eller slettet tekst, forfatter og tidspunkt. `accept_tracked_changes` og `reject_tracked_changes` tar imot ID-ene til endringene og fungerer som gjennomgangspanelet: en godtatt endring blir værende i teksten, en avvist innsetting fjernes, og en avvist sletting kommer tilbake. Et åpent redigeringsprogram viser resultatet uten ny innlasting. Verktøyene ber klienten om bare å godta eller avvise endringene du ber om.

## Historikk

Fra v6.3.3 ser klienten prosjekthistorikken slik historikkpanelet viser den.

| Verktøy | Hva det gjør |
| - | - |
| `list_changes` | Viser endringene, nyeste først: hvem som endret hvilke filer og når, med versjonene før og etter hver endring. Eldre endringer kommer i flere omganger. |
| `diff` | Sammenligner to versjoner: én fil som en unified diff, som `git diff`, eller filene som ble lagt til, fjernet, redigert eller fikk nytt navn |
| `read_file` med `version` | Leser en fil slik den var ved en versjon |
| `list_versions` | Viser de lagrede versjonene, med kommentar og hvem som lagret dem |
| `create_version` | Lagrer den nyeste versjonen, eller en tidligere, med en kommentar, som **Label this version** |
| `delete_version` | Sletter en lagret versjon; endringene blir værende |
| `restore_file` | Gjenoppretter en fil slik den var ved en versjon, som **Restore this version** |
| `restore_project` | Gjenoppretter hele prosjektet slik det var ved en versjon, som **Restore project to this version** |

En gjenoppretting er selv en ny endring, så du kan angre den på samme måte. Verktøyene ber klienten om bare å gjenopprette når du ber om det.

Hvis prosjekteieren ikke har full prosjekthistorikk, ser klienten bare endringene fra de siste 24 timene, eller den nyeste endringen hvis alle er eldre, som i historikkpanelet. Den kan ikke sammenligne, lese eller gjenopprette eldre versjoner.

## Prosjektchat

Fra v6.3.3 leser `list_chat_messages` prosjektchatten, nyeste først, 50 meldinger om gangen. `send_chat_message` sender en melding i ditt navn, og den vises umiddelbart i en åpen chat. Hvis nettstedet ditt har slått av prosjektchatten, har klienten ingen av verktøyene.

## Hvem kan gjøre hva

Klienten kan gjøre det rollen din i prosjektet tillater.

| Hva klienten gjør | Eier | Redaktør | Gjennomgåer | Leser (navngitt samarbeidspartner) | Leser (lenkedeling) |
| - | -: | -: | -: | -: | -: |
| Lese filer og innstillinger, kompilere, lese loggen, laste ned PDF-en | Ja | Ja | Ja | Ja | Ja |
| Skrive, redigere, flytte og slette filer, opprette mapper, endre innstillingene | Ja | Ja | Nei | Nei | Nei |
| Se historikken, kommentarene og de sporede endringene | Ja | Ja | Ja | Ja | Nei |
| Lese og sende chatmeldinger | Ja | Ja | Ja | Ja | Nei |
| Legge til kommentarer og svare på dem | Ja | Ja | Ja | Nei | Nei |
| Løse, åpne igjen eller slette en kommentar | Ja | Ja | De de selv startet | Nei | Nei |
| Redigere en kommentarmelding | Egne | Egne | Egne | Nei | Nei |
| Slette en kommentarmelding | Ja | Ja | Egne | Nei | Nei |
| Godta eller avvise sporede endringer | Ja | Ja | Nei | Nei | Nei |
| Lagre en versjon | Ja | Ja | Ja | Nei | Nei |
| Slette en lagret versjon | Ja | De de selv lagret | De de selv lagret | Nei | Nei |
| Gjenopprette en fil eller prosjektet | Ja | Ja | Nei | Nei | Nei |

Redaktører som ble med via en lenke, regnes som redaktører. Gjennomgåere kan ikke redigere filer via MCP, heller ikke som sporede endringer.

## Koble fra en klient

Slett tokenet: se [Slette et token](https://ayakaleaf-pro.mintlify.site/no/on-premises/user-guide/users/git-integration.md#delete-a-token). Fra da av svarer serveren `401` på det tokenet. Hvis du også bruker det til Git, slutter også Git å godta det.


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