Vai al contenuto principale
Ogni progetto ha il proprio server MCP, così un client di IA sul tuo computer può leggere e modificare il progetto, compilarlo e rispondere ai suoi commenti. Il client accede con un token di autenticazione Git.
Se non vedi la scheda MCP server, indica al tuo amministratore la pagina Server MCP.

Novità della v6.3.3

Dalla v6.3.3, il client può lavorare anche con la cronologia del progetto: elencare le modifiche, confrontare due versioni, leggere un file com’era, salvare ed eliminare versioni e ripristinare un file o l’intero progetto. Può elencare le modifiche tracciate e accettarle o rifiutarle, e rendere le proprie modifiche tracciate quando glielo chiedi. Può commentare un passaggio di testo e modificare o eliminare i messaggi dei commenti, leggere e inviare messaggi nella chat del progetto, spostare e rinominare file e cartelle, creare cartelle e cambiare la lingua del controllo ortografico. Chi può fare cosa segue il tuo ruolo nel progetto, come nell’editor, perché il client lavora con il tuo token: vedi Chi può fare cosa. Il server MCP è stato introdotto nella v6.3.1. La v6.3.1 e la v6.3.2 hanno gli stessi 17 strumenti; la v6.3.3 ne ha 33.

Collega un client

1

Apri la finestra

Apri il progetto. Nella barra a sinistra, fai clic su Integrations, poi su MCP server.
Il pannello Integrations con la scheda MCP server

Il pannello Integrations

La finestra mostra l’indirizzo del server di questo progetto e una scheda per ogni client: Claude Code, Codex, Cursor, VS Code e Gemini CLI.
La finestra MCP server con l'indirizzo, una scheda per ogni client e il comando per Claude Code

La finestra MCP server

2

Crea un token

Fai clic su Go to settings. Le impostazioni del tuo account si aprono in una nuova scheda. In Git integration, fai clic su Generate token, oppure su Add another token se ne hai già uno. Fai clic su Copy e conserva il token in un posto sicuro, perché lo vedi una sola volta. Poi fai clic su Close.
La finestra Git authentication token con un pulsante Copy

Il tuo nuovo token

Funziona anche un token che usi già per l’integrazione Git, così come un unico token per tutti i tuoi progetti.
3

Aggiungi il server al client

Tornato nella finestra, fai clic sulla scheda del tuo client e poi su Copy accanto alla configurazione.L’indirizzo appartiene a un solo progetto. Per collegare un altro progetto, aggiungilo con un altro nome, perché overleaf è già in uso. Per Claude Code, ad esempio, cambia overleaf nel comando in overleaf-lab.

Verifica la connessione

Con Claude Code

Il server risulta connesso:

Con curl

Funziona qualunque sia il tuo client. Sostituisci l’indirizzo e il token e invia la richiesta initialize del protocollo MCP:
La risposta indica il nome del server, seguito dalle sue istruzioni per i client:
Per vedere gli strumenti, invia tools/list con lo stesso comando. La risposta elenca 33 strumenti, o 31 se nel tuo sito la chat del progetto è disattivata. Prima della v6.3.3 ne elenca 17.
Per chiamarne uno, invia tools/call:

Nelle impostazioni del tuo account

In Git integration, Last used mostra la data per un token che il server ha ricevuto.
L'elenco dei token, con una data in Last used per il primo token e N/A per il secondo

Il primo token è stato usato

Se non si connette

Cosa vedi quando un client lavora

Le modifiche compaiono in un editor aperto mentre il client le fa, come quelle di un collaboratore, senza ricaricare. Nuovi file e cartelle, spostamenti e rinomine compaiono nell’albero dei file.
L'editor mostra una riga aggiunta da edit_file, senza finestre e senza ricaricare

Una riga aggiunta da edit_file

edit_file modifica solo testo che compare esattamente una volta. Altrimenti il client riceve un errore, come oldString not found in main.tex, read_file again o oldString appears 2 times in main.tex, add context, e non cambia nulla. Dalla v6.3.3, move_file sposta o rinomina un file o una cartella, creando se necessario le cartelle del nuovo percorso, e create_folder crea una cartella. Se il file non viene trovato o il nuovo percorso esiste già, il client riceve un errore e non cambia nulla. update_settings può anche cambiare la lingua del controllo ortografico, ad esempio in de, oppure disattivarlo. Le risposte ai commenti compaiono nel pannello di revisione con il tuo nome, perché il token è tuo. Un commento risolto tramite il server esce dal pannello, e riaprirlo lo fa tornare.
Un commento nel pannello di revisione con una risposta inviata da reply_to_comment

Una risposta inviata da reply_to_comment

Dalla v6.3.3, add_comment commenta un passaggio di testo. Il testo deve comparire esattamente una volta nel file; quando compare più volte, il client fornisce anche un passaggio più lungo che lo contiene e compare una sola volta, e viene commentato solo il testo. Il commento compare nel pannello di revisione con il tuo nome e resta sul suo testo quando il file cambia. edit_comment_message modifica uno dei tuoi messaggi. delete_comment_message elimina un messaggio, ed eliminare il primo elimina l’intero commento, come nel pannello di revisione. compile compila il progetto e restituisce l’elenco dei file di output. get_output_file_link fornisce poi un link per scaricare il PDF o un altro file di output. Il link non richiede un token e smette di funzionare dopo 5 minuti. Per l’elenco completo degli strumenti, vedi Tools.

Modifiche tracciate

Dalla v6.3.3, puoi chiedere al client di rendere le sue modifiche modifiche tracciate, ad esempio Rewrite the abstract as a tracked change. edit_file e write_file rendono allora la modifica a un file esistente una modifica tracciata a tuo nome, anche quando il tracciamento delle modifiche è disattivato nel progetto, e tu la accetti o la rifiuti nel pannello di revisione. Un nuovo file non è mai una modifica tracciata. Se non lo chiedi, le modifiche seguono l’impostazione del progetto, come le tue nell’editor: vengono tracciate quando il tracciamento è attivo per te o per tutti. Se l’account del proprietario del progetto non dispone delle modifiche tracciate, il client riceve Track changes is off for this project e non cambia nulla. Per rivedere ogni modifica del client, attiva il tracciamento delle modifiche per te. Per distinguere le sue modifiche dalle tue nel pannello di revisione, dai al client il token di un altro account con cui condividi il progetto. list_tracked_changes elenca le modifiche tracciate con il loro file, il testo inserito o eliminato, l’autore e l’ora. accept_tracked_changes e reject_tracked_changes accettano gli id delle modifiche e funzionano come il pannello di revisione: una modifica accettata resta nel testo, un inserimento rifiutato viene rimosso e un’eliminazione rifiutata torna. Un editor aperto mostra il risultato senza ricaricare. Gli strumenti dicono al client di accettare o rifiutare solo le modifiche che chiedi.

Cronologia

Dalla v6.3.3, il client vede la cronologia del progetto come la mostra il pannello della cronologia. Un ripristino è a sua volta una nuova modifica, quindi puoi annullarlo allo stesso modo. Gli strumenti dicono al client di ripristinare solo quando lo chiedi. Se il proprietario del progetto non dispone della cronologia completa del progetto, il client vede solo le modifiche delle ultime 24 ore, o la più recente se sono tutte più vecchie, come nel pannello della cronologia. Non può confrontare, leggere o ripristinare versioni più vecchie.

Chat del progetto

Dalla v6.3.3, list_chat_messages legge la chat del progetto, dai più recenti, 50 messaggi alla volta. send_chat_message invia un messaggio a tuo nome, che compare subito in una chat aperta. Se nel tuo sito la chat del progetto è disattivata, il client non ha nessuno dei due strumenti.

Chi può fare cosa

Il client può fare ciò che il tuo ruolo nel progetto consente. Gli editor che si sono uniti tramite link contano come editor. I revisori non possono modificare file tramite MCP, nemmeno come modifiche tracciate.

Scollega un client

Elimina il token: vedi Eliminare un token. Da quel momento il server risponde 401 a quel token. Se lo usi anche per Git, anche Git smette di accettarlo.
Ultima modifica il 21 novembre 2026