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

> Forbind en AI-klient som Claude Code til et projekt via MCP, kontrollér at forbindelsen virker, og se hvad klienten kan gøre.

Hvert projekt har sin egen MCP-server, så en AI-klient på din computer kan læse og redigere projektet, kompilere det og svare på dets kommentarer. Klienten logger ind med et Git-godkendelsestoken.

> [!NOTE]
>
> Hvis du ikke kan se et **MCP server**-kort, så henvis din administrator til [MCP-server](https://ayakaleaf-pro.mintlify.site/da/on-premises/configuration/overleaf-toolkit/integrations/mcp-server.md).

## Nyt i v6.3.3

Fra v6.3.3 kan klienten også arbejde med projekthistorikken: vise ændringerne, sammenligne to versioner, læse en fil, som den var, gemme og slette versioner og gendanne en fil eller hele projektet. Den kan vise sporede ændringer og acceptere eller afvise dem, og gøre sine egne redigeringer til sporede ændringer, når du beder om det. Den kan kommentere et tekstudsnit og redigere eller slette kommentarbeskeder, læse og sende beskeder i projektchatten, flytte og omdøbe filer og mapper, oprette mapper og ændre sproget for stavekontrol. Hvem der må hvad, følger din rolle i projektet, som i editoren, fordi klienten arbejder med dit token: se [Hvem må hvad](#who-may-do-what).

MCP-serveren blev introduceret i v6.3.1. v6.3.1 og v6.3.2 har de samme 17 værktøjer; v6.3.3 har 33.

| Værktøjer | 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, uændret |
| `read_file` | Det nyeste indhold | Også en fil, som den var ved en `version` |
| `edit_file`, `write_file` | Følger projektets indstilling for sporede ændringer | Også `trackChanges`, så redigeringen bliver en sporet ændring |
| `update_settings` | Compiler, TeX Live-image og hoveddokument | Også sproget for stavekontrol |
| `list_versions` | Version, kommentar og dato | Også det `id`, som `delete_version` tager imod, og hvem der gemte den |
| `list_comments` | Beskeder uden id | Også `id` for hver besked, som `edit_comment_message` og `delete_comment_message` tager imod |
| `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` | Nej | Ja |

## Forbind en klient

**1. Åbn dialogen**

Åbn projektet. Klik på **Integrations** i venstre bjælke og derefter 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 på projektets 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 til 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. Opret et token**

Klik på **Go to settings**. Dine kontoindstillinger åbnes i en ny fane. Under **Git integration** klikker du på **Generate token**, eller på **Add another token**, hvis du allerede har et. Klik på **Copy**, og opbevar tokenet et sikkert sted, fordi du kun ser det én gang. Klik derefter på **Close**.

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

Dit nye token

Et token, du allerede bruger til [Git-integration](https://ayakaleaf-pro.mintlify.site/da/on-premises/user-guide/users/git-integration.md), virker også, og det gør ét token til alle dine projekter også.

**3. Tilføj serveren til din klient**

Tilbage i dialogen klikker du på fanen for din klient og derefter på **Copy** ved siden af konfigurationen.

| Fane | Hvor den skal hen | Tokenet |
| - | - | - |
| **Claude Code** | Kør kommandoen i en terminal | Erstat `<token>` i kommandoen |
| **Codex** | `~/.codex/config.toml` | Læg det i miljøvariablen `OVERLEAF_TOKEN` |
| **Cursor** | `~/.cursor/mcp.json` | Læg det i miljøvariablen `OVERLEAF_TOKEN` |
| **VS Code** | `.vscode/mcp.json` | Filen har en adgangskodeprompt kaldet `overleaf-token` i stedet for tokenet |
| **Gemini CLI** | Kør kommandoen i en terminal | Erstat `<token>` i kommandoen |

Adressen hører til ét projekt. For at forbinde et andet projekt tilføjer du det under et andet navn, fordi `overleaf` allerede er optaget. I Claude Code ændrer du for eksempel `overleaf` i kommandoen til `overleaf-lab`.

## Kontrollér forbindelsen

### Med Claude Code

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

Serveren vises som forbundet:

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

### Med curl

Dette virker uanset klient. Erstat adressen og tokenet, og send MCP-protokollens `initialize`-anmodning:

```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 angiver serverens navn efterfulgt af dens instruktioner til 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 at se værktøjerne sender du `tools/list` med samme kommando. Svaret viser 33 værktøjer, eller 31 hvis dit website har slået projektchatten fra. Før v6.3.3 vises 17.

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

For at kalde et værktøj 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 dine kontoindstillinger

Under **Git integration** viser **Last used** datoen for et token, som serveren har modtaget.

![Tokenlisten med en dato under Last used for det første token og N/A for det andet](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 token er blevet brugt

### Hvis den ikke forbinder

| Hvad du ser | Hvad det betyder |
| - | - |
| Status `401`, eller i Claude Code `✘ Failed to connect` med `HTTP 401` | Tokenet mangler, er forkert eller slettet |
| Status `404` | Intet projekt har dette ID |
| Status `405` | Anmodningen var ikke en `POST` |
| Status `406` med `Not Acceptable` | Headeren `Accept` mangler: klienten skal acceptere både `application/json` og `text/event-stream` |

## Hvad du ser, når en klient arbejder

Redigeringer vises i en åben editor, efterhånden som klienten laver dem, ligesom en samarbejdspartners, uden genindlæsning. Nye filer og mapper, flytninger og omdøbninger vises i filtræet.

![Editoren viser en linje, som edit\_file tilføjede, uden dialog og uden genindlæsning](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 tilføjet af edit\_file

`edit_file` ændrer kun tekst, der forekommer præcis én gang. Ellers får klienten en fejl, f.eks. `oldString not found in main.tex, read_file again` eller `oldString appears 2 times in main.tex, add context`, og intet ændres.

Fra v6.3.3 flytter eller omdøber `move_file` en fil eller mappe og opretter om nødvendigt mapperne i den nye sti, og `create_folder` opretter en mappe. Hvis filen ikke findes, eller den nye sti allerede findes, får klienten en fejl, og intet ændres. `update_settings` kan også ændre sproget for stavekontrol, f.eks. til `de`, eller slå stavekontrollen fra.

Svar på kommentarer vises i gennemgangspanelet under dit navn, fordi tokenet er dit. En kommentar, der løses via serveren, forsvinder fra panelet, og hvis den genåbnes, kommer den tilbage.

![En kommentar i gennemgangspanelet med et svar sendt af 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 af reply\_to\_comment

Fra v6.3.3 kommenterer `add_comment` et tekstudsnit. Teksten skal forekomme præcis én gang i filen; når den forekommer flere gange, angiver klienten også et længere udsnit omkring den, der forekommer én gang, og kun teksten kommenteres. Kommentaren vises i gennemgangspanelet under dit navn og bliver ved sin tekst, når filen ændres. `edit_comment_message` ændrer en af dine egne beskeder. `delete_comment_message` sletter en besked, og sletning af den første sletter hele kommentaren, som i gennemgangspanelet.

`compile` kompilerer projektet og returnerer listen over outputfiler. `get_output_file_link` giver derefter et link til at downloade PDF'en eller en anden outputfil. Linket kræver intet token og holder op med at virke efter 5 minutter.

Den fulde liste over værktøjer finder du under [Tools](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/integrations/mcp-server.md#tools).

## Sporede ændringer

Fra v6.3.3 kan du bede klienten om at gøre sine redigeringer til sporede ændringer, f.eks. *Rewrite the abstract as a tracked change*. `edit_file` og `write_file` gør så ændringen i en eksisterende fil til en sporet ændring i dit navn, selv når sporing af ændringer er slået fra i projektet, og du accepterer eller afviser den i gennemgangspanelet. En ny fil er aldrig en sporet ændring. Hvis du ikke beder om det, følger redigeringerne projektets indstilling for sporede ændringer, ligesom dine i editoren: de spores, når sporingen er slået til for dig eller for alle.

Hvis projektejerens konto ikke har sporede ændringer, får klienten `Track changes is off for this project`, og intet ændres.

For at gennemgå hver redigering, klienten laver, slår du sporede ændringer til for dig selv. For at skelne dens redigeringer fra dine i gennemgangspanelet giver du klienten tokenet til en anden konto, som du deler projektet med.

`list_tracked_changes` viser de sporede ændringer med fil, indsat eller slettet tekst, forfatter og tidspunkt. `accept_tracked_changes` og `reject_tracked_changes` tager imod ændringernes id'er og virker som gennemgangspanelet: en accepteret ændring bliver i teksten, en afvist indsættelse fjernes, og en afvist sletning kommer tilbage. En åben editor viser resultatet uden genindlæsning. Værktøjerne beder klienten om kun at acceptere eller afvise de ændringer, du beder om.

## Historik

Fra v6.3.3 ser klienten projekthistorikken, som historikpanelet viser den.

| Værktøj | Hvad det gør |
| - | - |
| `list_changes` | Viser ændringerne, nyeste først: hvem der ændrede hvilke filer og hvornår, med versionerne før og efter hver ændring. Ældre ændringer kommer i flere omgange. |
| `diff` | Sammenligner to versioner: én fil som en unified diff, som `git diff`, eller de filer, der blev tilføjet, fjernet, redigeret eller omdøbt |
| `read_file` med `version` | Læser en fil, som den var ved en version |
| `list_versions` | Viser de gemte versioner med kommentar og hvem der gemte dem |
| `create_version` | Gemmer den nyeste version, eller en tidligere, med en kommentar, som **Label this version** |
| `delete_version` | Sletter en gemt version; dens ændringer bliver |
| `restore_file` | Gendanner en fil, som den var ved en version, som **Restore this version** |
| `restore_project` | Gendanner hele projektet, som det var ved en version, som **Restore project to this version** |

En gendannelse er i sig selv en ny ændring, så du kan fortryde den på samme måde. Værktøjerne beder klienten om kun at gendanne, når du beder om det.

Hvis projektejeren ikke har fuld projekthistorik, ser klienten kun ændringerne fra de seneste 24 timer, eller den nyeste ændring, hvis de alle er ældre, som i historikpanelet. Den kan ikke sammenligne, læse eller gendanne ældre versioner.

## Projektchat

Fra v6.3.3 læser `list_chat_messages` projektchatten, nyeste først, 50 beskeder ad gangen. `send_chat_message` sender en besked i dit navn, og den vises med det samme i en åben chat. Hvis dit website har slået projektchatten fra, har klienten ingen af værktøjerne.

## Hvem må hvad

Klienten må gøre det, din rolle i projektet tillader.

| Hvad klienten gør | Ejer | Redaktør | Korrekturlæser | Læser (navngiven samarbejdspartner) | Læser (linkdeling) |
| - | -: | -: | -: | -: | -: |
| Læse filer og indstillinger, kompilere, læse loggen, downloade PDF'en | Ja | Ja | Ja | Ja | Ja |
| Skrive, redigere, flytte og slette filer, oprette mapper, ændre indstillingerne | Ja | Ja | Nej | Nej | Nej |
| Se historikken, kommentarerne og de sporede ændringer | Ja | Ja | Ja | Ja | Nej |
| Læse og sende chatbeskeder | Ja | Ja | Ja | Ja | Nej |
| Tilføje kommentarer og svare på dem | Ja | Ja | Ja | Nej | Nej |
| Løse, genåbne eller slette en kommentar | Ja | Ja | Dem, de selv startede | Nej | Nej |
| Redigere en kommentarbesked | Egne | Egne | Egne | Nej | Nej |
| Slette en kommentarbesked | Ja | Ja | Egne | Nej | Nej |
| Acceptere eller afvise sporede ændringer | Ja | Ja | Nej | Nej | Nej |
| Gemme en version | Ja | Ja | Ja | Nej | Nej |
| Slette en gemt version | Ja | Dem, de selv gemte | Dem, de selv gemte | Nej | Nej |
| Gendanne en fil eller projektet | Ja | Ja | Nej | Nej | Nej |

Redaktører, der er kommet med via et link, tæller som redaktører. Korrekturlæsere kan ikke redigere filer via MCP, heller ikke som sporede ændringer.

## Afbryd en klient

Slet tokenet: se [Slet et token](https://ayakaleaf-pro.mintlify.site/da/on-premises/user-guide/users/git-integration.md#delete-a-token). Fra da af svarer serveren `401` på det token. Hvis du også bruger det til Git, holder Git også op med at acceptere det.


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