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

# Servidor MCP

> Conecte un cliente de IA como Claude Code a un proyecto mediante MCP, compruebe que la conexión funciona y vea qué puede hacer el cliente.

Cada proyecto tiene su propio servidor MCP, de modo que un cliente de IA en su ordenador puede leer y editar el proyecto, compilarlo y responder a sus comentarios. El cliente inicia sesión con un token de autenticación de Git.

> [!NOTE]
>
> Si no ve ninguna tarjeta **MCP server**, consulte [Servidor MCP](https://ayakaleaf-pro.mintlify.site/es/on-premises/configuration/overleaf-toolkit/integrations/mcp-server.md) para su administrador.

## Novedades de la v6.3.3

A partir de la v6.3.3, el cliente también puede trabajar con el historial del proyecto: listar los cambios, comparar dos versiones, leer un archivo tal como era, guardar y eliminar versiones y restaurar un archivo o el proyecto completo. Puede listar los cambios con seguimiento y aceptarlos o rechazarlos, y convertir sus propias ediciones en cambios con seguimiento cuando usted se lo pida. Puede comentar un fragmento de texto y editar o eliminar mensajes de comentarios, leer y enviar mensajes en el chat del proyecto, mover y renombrar archivos y carpetas, crear carpetas y cambiar el idioma del corrector ortográfico. Quién puede hacer qué depende de su rol en el proyecto, como en el editor, porque el cliente trabaja con su token: consulte [Quién puede hacer qué](#who-may-do-what).

El servidor MCP se introdujo en la v6.3.1. La v6.3.1 y la v6.3.2 tienen las mismas 17 herramientas; la v6.3.3 tiene 33.

| Herramientas | v6.3.1 y 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` | Sí | Sí, sin cambios |
| `read_file` | El contenido más reciente | También un archivo tal como era en una `version` |
| `edit_file`, `write_file` | Siguen el ajuste de control de cambios del proyecto | También `trackChanges`, para que la edición sea un cambio con seguimiento |
| `update_settings` | Compilador, imagen de TeX Live y documento principal | También el idioma del corrector ortográfico |
| `list_versions` | Versión, comentario y fecha | También el `id` que acepta `delete_version`, y quién la guardó |
| `list_comments` | Mensajes sin id | También el `id` de cada mensaje, que aceptan `edit_comment_message` y `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` | No | Sí |

## Conectar un cliente

**1. Abrir el cuadro de diálogo**

Abra el proyecto. En la barra izquierda, haga clic en **Integrations** y luego en **MCP server**.

![El panel Integrations con la tarjeta 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)

El panel Integrations

El cuadro de diálogo muestra la dirección del servidor de este proyecto y una pestaña para cada cliente: **Claude Code**, **Codex**, **Cursor**, **VS Code** y **Gemini CLI**.

![El cuadro de diálogo MCP server con la dirección, una pestaña por cliente y el comando para 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)

El cuadro de diálogo MCP server

**2. Crear un token**

Haga clic en **Go to settings**. La configuración de su cuenta se abre en una pestaña nueva. En **Git integration**, haga clic en **Generate token**, o en **Add another token** si ya tiene uno. Haga clic en **Copy** y guarde el token en un lugar seguro, porque solo lo verá una vez. Después haga clic en **Close**.

![El cuadro de diálogo Git authentication token con un botón Copy](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/mcp-server-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f4661b468dd1d409ef19967216955ae4)

Su nuevo token

También funciona un token que ya use para la [integración con Git](https://ayakaleaf-pro.mintlify.site/es/on-premises/user-guide/users/git-integration.md), y un mismo token sirve para todos sus proyectos.

**3. Añadir el servidor a su cliente**

De vuelta en el cuadro de diálogo, haga clic en la pestaña de su cliente y en **Copy** junto a la configuración.

| Pestaña | Dónde va | El token |
| - | - | - |
| **Claude Code** | Ejecute el comando en una terminal | Sustituya `<token>` en el comando |
| **Codex** | `~/.codex/config.toml` | Póngalo en la variable de entorno `OVERLEAF_TOKEN` |
| **Cursor** | `~/.cursor/mcp.json` | Póngalo en la variable de entorno `OVERLEAF_TOKEN` |
| **VS Code** | `.vscode/mcp.json` | El archivo tiene una solicitud de contraseña llamada `overleaf-token` en lugar del token |
| **Gemini CLI** | Ejecute el comando en una terminal | Sustituya `<token>` en el comando |

La dirección pertenece a un solo proyecto. Para conectar otro proyecto, añádalo con otro nombre, porque `overleaf` ya está en uso. En Claude Code, por ejemplo, cambie `overleaf` por `overleaf-lab` en el comando.

## Comprobar la conexión

### Con Claude Code

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

El servidor aparece como conectado:

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

### Con curl

Esto funciona sea cual sea su cliente. Sustituya la dirección y el token, y envíe la solicitud `initialize` del protocolo 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"}}}'
```

La respuesta nombra el servidor, seguido de sus instrucciones para los clientes:

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

Para ver las herramientas, envíe `tools/list` con el mismo comando. La respuesta enumera 33 herramientas, o 31 si su sitio tiene desactivado el chat del proyecto. Antes de la v6.3.3 enumera 17.

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

Para llamar a una, envíe `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}
```

### En la configuración de su cuenta

En **Git integration**, **Last used** muestra la fecha de un token que el servidor ha recibido.

![La lista de tokens, con una fecha en Last used para el primer token y N/A para el segundo](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/mcp-server-last-used.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=2abe32cb469d17b8b8c5eb18f1c0c2d3)

El primer token se ha usado

### Si no se conecta

| Lo que ve | Lo que significa |
| - | - |
| Estado `401`, o en Claude Code `✘ Failed to connect` con `HTTP 401` | El token falta, es incorrecto o se eliminó |
| Estado `404` | Ningún proyecto tiene este ID |
| Estado `405` | La solicitud no era un `POST` |
| Estado `406` con `Not Acceptable` | Falta el encabezado `Accept`: el cliente debe aceptar tanto `application/json` como `text/event-stream` |

## Lo que ve cuando un cliente trabaja

Las ediciones aparecen en un editor abierto a medida que el cliente las hace, como las de un colaborador, sin recargar. Los archivos y carpetas nuevos, los movimientos y los cambios de nombre aparecen en el árbol de archivos.

![El editor mostrando una línea que añadió edit\_file, sin cuadro de diálogo y sin recargar](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/mcp-server-live-edit.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=51163f1de5bec88d50bd96089bd1a9a2)

Una línea añadida por edit\_file

`edit_file` solo cambia texto que aparece exactamente una vez. En otro caso el cliente recibe un error, como `oldString not found in main.tex, read_file again` o `oldString appears 2 times in main.tex, add context`, y no cambia nada.

A partir de la v6.3.3, `move_file` mueve o renombra un archivo o una carpeta, creando las carpetas de la nueva ruta si hace falta, y `create_folder` crea una carpeta. Si no se encuentra el archivo o la nueva ruta ya existe, el cliente recibe un error y no cambia nada. `update_settings` también puede cambiar el idioma del corrector ortográfico, por ejemplo a `de`, o desactivarlo.

Las respuestas a los comentarios aparecen en el panel de revisión con su nombre, porque el token es suyo. Un comentario resuelto a través del servidor sale del panel, y reabrirlo lo devuelve.

![Un comentario en el panel de revisión con una respuesta enviada por 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)

Una respuesta enviada por reply\_to\_comment

A partir de la v6.3.3, `add_comment` comenta un fragmento de texto. El texto debe aparecer exactamente una vez en el archivo; cuando aparece más de una vez, el cliente indica también un fragmento más largo a su alrededor que aparece una sola vez, y solo se comenta el texto. El comentario aparece en el panel de revisión con su nombre y se mantiene sobre su texto cuando el archivo cambia. `edit_comment_message` cambia uno de sus propios mensajes. `delete_comment_message` elimina un mensaje, y eliminar el primero elimina el comentario entero, como en el panel de revisión.

`compile` compila el proyecto y devuelve la lista de archivos de salida. Después, `get_output_file_link` da un enlace para descargar el PDF u otro archivo de salida. El enlace no necesita token y deja de funcionar al cabo de 5 minutos.

Para la lista completa de herramientas, consulte [Tools](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/integrations/mcp-server.md#tools).

## Cambios con seguimiento

A partir de la v6.3.3, puede pedir al cliente que sus ediciones sean cambios con seguimiento, por ejemplo *Rewrite the abstract as a tracked change*. Entonces `edit_file` y `write_file` convierten el cambio en un archivo existente en un cambio con seguimiento a su nombre, incluso cuando el control de cambios está desactivado en el proyecto, y usted lo acepta o rechaza en el panel de revisión. Un archivo nuevo nunca es un cambio con seguimiento. Si no lo pide, las ediciones siguen el ajuste de control de cambios del proyecto, como las suyas en el editor: tienen seguimiento cuando el control de cambios está activado para usted o para todos.

Si la cuenta del propietario del proyecto no tiene control de cambios, el cliente recibe `Track changes is off for this project` y no cambia nada.

Para revisar cada edición del cliente, active el control de cambios para usted. Para distinguir sus ediciones de las suyas en el panel de revisión, dé al cliente el token de otra cuenta con la que comparta el proyecto.

`list_tracked_changes` enumera los cambios con seguimiento con su archivo, el texto insertado o eliminado, el autor y la hora. `accept_tracked_changes` y `reject_tracked_changes` aceptan los id de los cambios y funcionan como el panel de revisión: un cambio aceptado permanece en el texto, una inserción rechazada se elimina y una eliminación rechazada vuelve. Un editor abierto muestra el resultado sin recargar. Las herramientas indican al cliente que acepte o rechace solo los cambios que usted pida.

## Historial

A partir de la v6.3.3, el cliente ve el historial del proyecto tal como lo muestra el panel de historial.

| Herramienta | Qué hace |
| - | - |
| `list_changes` | Enumera los cambios, los más recientes primero: quién cambió qué archivos y cuándo, con las versiones antes y después de cada cambio. Los cambios más antiguos llegan en lotes posteriores. |
| `diff` | Compara dos versiones: un archivo como diff unificado, como `git diff`, o los archivos añadidos, eliminados, editados o renombrados |
| `read_file` con `version` | Lee un archivo tal como era en una versión |
| `list_versions` | Enumera las versiones guardadas, con su comentario y quién las guardó |
| `create_version` | Guarda la versión más reciente, o una anterior, con un comentario, como **Label this version** |
| `delete_version` | Elimina una versión guardada; sus cambios permanecen |
| `restore_file` | Restaura un archivo tal como era en una versión, como **Restore this version** |
| `restore_project` | Restaura el proyecto completo tal como era en una versión, como **Restore project to this version** |

Una restauración es en sí un cambio nuevo, así que puede deshacerla de la misma forma. Las herramientas indican al cliente que restaure solo cuando usted lo pida.

Si el propietario del proyecto no tiene el historial completo del proyecto, el cliente solo ve los cambios de las últimas 24 horas, o el más reciente si todos son anteriores, como en el panel de historial. No puede comparar, leer ni restaurar versiones más antiguas.

## Chat del proyecto

A partir de la v6.3.3, `list_chat_messages` lee el chat del proyecto, los más recientes primero, de 50 en 50 mensajes. `send_chat_message` envía un mensaje con su nombre, que aparece al instante en un chat abierto. Si su sitio tiene desactivado el chat del proyecto, el cliente no tiene ninguna de las dos herramientas.

## Quién puede hacer qué

El cliente puede hacer lo que permite su rol en el proyecto.

| Lo que hace el cliente | Propietario | Editor | Revisor | Lector (colaborador con nombre) | Lector (compartido por enlace) |
| - | -: | -: | -: | -: | -: |
| Leer archivos y ajustes, compilar, leer el registro, descargar el PDF | Sí | Sí | Sí | Sí | Sí |
| Escribir, editar, mover y eliminar archivos, crear carpetas, cambiar los ajustes | Sí | Sí | No | No | No |
| Ver el historial, los comentarios y los cambios con seguimiento | Sí | Sí | Sí | Sí | No |
| Leer y enviar mensajes de chat | Sí | Sí | Sí | Sí | No |
| Añadir comentarios y responderlos | Sí | Sí | Sí | No | No |
| Resolver, reabrir o eliminar un comentario | Sí | Sí | Los que inició | No | No |
| Editar un mensaje de comentario | Los suyos | Los suyos | Los suyos | No | No |
| Eliminar un mensaje de comentario | Sí | Sí | Los suyos | No | No |
| Aceptar o rechazar cambios con seguimiento | Sí | Sí | No | No | No |
| Guardar una versión | Sí | Sí | Sí | No | No |
| Eliminar una versión guardada | Sí | Las que guardó | Las que guardó | No | No |
| Restaurar un archivo o el proyecto | Sí | Sí | No | No | No |

Los editores que se unieron por enlace cuentan como editores. Los revisores no pueden editar archivos mediante MCP, ni siquiera como cambios con seguimiento.

## Desconectar un cliente

Elimine el token: consulte [Eliminar un token](https://ayakaleaf-pro.mintlify.site/es/on-premises/user-guide/users/git-integration.md#delete-a-token). A partir de entonces, el servidor responde `401` a ese token. Si también lo usa para Git, Git también deja de aceptarlo.


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