Saltar para o conteúdo principal
Cada projeto tem seu próprio servidor MCP, para que um cliente de IA no seu computador possa ler e editar o projeto, compilá-lo e responder aos seus comentários. O cliente faz login com um token de autenticação do Git.
Se você não vê o cartão MCP server, indique ao seu administrador a página Servidor MCP.

Novidades da v6.3.3

A partir da v6.3.3, o cliente também pode trabalhar com o histórico do projeto: listar as alterações, comparar duas versões, ler um arquivo como ele era, salvar e excluir versões e restaurar um arquivo ou o projeto inteiro. Ele pode listar as alterações rastreadas e aceitá-las ou rejeitá-las, e transformar as próprias edições em alterações rastreadas quando você pedir. Pode comentar um trecho de texto e editar ou excluir mensagens de comentários, ler e enviar mensagens no chat do projeto, mover e renomear arquivos e pastas, criar pastas e mudar o idioma da verificação ortográfica. Quem pode fazer o quê segue o seu papel no projeto, como no editor, porque o cliente trabalha com o seu token: veja Quem pode fazer o quê. O servidor MCP foi introduzido na v6.3.1. A v6.3.1 e a v6.3.2 têm as mesmas 17 ferramentas; a v6.3.3 tem 33.

Conectar um cliente

1

Abrir a caixa de diálogo

Abra o projeto. Na barra à esquerda, clique em Integrations e depois em MCP server.
O painel Integrations com o cartão MCP server

O painel Integrations

A caixa de diálogo mostra o endereço do servidor deste projeto e uma aba para cada cliente: Claude Code, Codex, Cursor, VS Code e Gemini CLI.
A caixa de diálogo MCP server com o endereço, uma aba para cada cliente e o comando para o Claude Code

A caixa de diálogo MCP server

2

Criar um token

Clique em Go to settings. As configurações da sua conta abrem em uma nova aba. Em Git integration, clique em Generate token, ou em Add another token se você já tiver um. Clique em Copy e guarde o token em um lugar seguro, porque você só o vê uma vez. Depois clique em Close.
A caixa de diálogo Git authentication token com um botão Copy

Seu novo token

Um token que você já usa para a integração com Git também funciona, assim como um único token para todos os seus projetos.
3

Adicionar o servidor ao seu cliente

De volta à caixa de diálogo, clique na aba do seu cliente e em Copy ao lado da configuração.O endereço pertence a um único projeto. Para conectar outro projeto, adicione-o com outro nome, porque overleaf já está em uso. No Claude Code, por exemplo, troque overleaf no comando por overleaf-lab.

Verificar a conexão

Com o Claude Code

O servidor aparece como conectado:

Com curl

Isso funciona seja qual for o seu cliente. Substitua o endereço e o token e envie a requisição initialize do protocolo MCP:
A resposta traz o nome do servidor, seguido das instruções dele para os clientes:
Para ver as ferramentas, envie tools/list com o mesmo comando. A resposta lista 33 ferramentas, ou 31 se o seu site tiver o chat do projeto desativado. Antes da v6.3.3, lista 17.
Para chamar uma, envie tools/call:

Nas configurações da sua conta

Em Git integration, Last used mostra a data de um token que o servidor recebeu.
A lista de tokens, com uma data em Last used para o primeiro token e N/A para o segundo

O primeiro token foi usado

Se não conectar

O que você vê quando um cliente trabalha

As edições aparecem em um editor aberto à medida que o cliente as faz, como as de um colaborador, sem recarregar. Novos arquivos e pastas, movimentações e renomeações aparecem na árvore de arquivos.
O editor mostrando uma linha que edit_file adicionou, sem caixa de diálogo e sem recarregar

Uma linha adicionada por edit_file

edit_file só altera texto que aparece exatamente uma vez. Caso contrário, o cliente recebe um erro, como oldString not found in main.tex, read_file again ou oldString appears 2 times in main.tex, add context, e nada muda. A partir da v6.3.3, move_file move ou renomeia um arquivo ou pasta, criando as pastas do novo caminho quando necessário, e create_folder cria uma pasta. Se o arquivo não for encontrado ou o novo caminho já existir, o cliente recebe um erro e nada muda. update_settings também pode mudar o idioma da verificação ortográfica, por exemplo para de, ou desativá-la. As respostas a comentários aparecem no painel de revisão com o seu nome, porque o token é seu. Um comentário resolvido pelo servidor sai do painel, e reabri-lo o traz de volta.
Um comentário no painel de revisão com uma resposta enviada por reply_to_comment

Uma resposta enviada por reply_to_comment

A partir da v6.3.3, add_comment comenta um trecho de texto. O texto precisa aparecer exatamente uma vez no arquivo; quando aparece mais de uma vez, o cliente também informa um trecho maior em volta dele que aparece uma única vez, e só o texto é comentado. O comentário aparece no painel de revisão com o seu nome e permanece no seu texto conforme o arquivo muda. edit_comment_message altera uma das suas próprias mensagens. delete_comment_message exclui uma mensagem, e excluir a primeira exclui o comentário inteiro, como no painel de revisão. compile compila o projeto e retorna a lista de arquivos de saída. Em seguida, get_output_file_link fornece um link para baixar o PDF ou outro arquivo de saída. O link não precisa de token e deixa de funcionar após 5 minutos. Para a lista completa de ferramentas, veja Tools.

Alterações rastreadas

A partir da v6.3.3, você pode pedir ao cliente que faça das suas edições alterações rastreadas, por exemplo Rewrite the abstract as a tracked change. edit_file e write_file então transformam a alteração em um arquivo existente em uma alteração rastreada no seu nome, mesmo quando o rastreamento de alterações está desativado no projeto, e você a aceita ou rejeita no painel de revisão. Um arquivo novo nunca é uma alteração rastreada. Se você não pedir, as edições seguem a configuração de rastreamento do projeto, como as suas no editor: são rastreadas quando o rastreamento está ativado para você ou para todos. Se a conta do dono do projeto não tiver rastreamento de alterações, o cliente recebe Track changes is off for this project e nada muda. Para revisar cada edição do cliente, ative o rastreamento de alterações para você. Para distinguir as edições dele das suas no painel de revisão, dê ao cliente o token de outra conta com a qual você compartilha o projeto. list_tracked_changes lista as alterações rastreadas com o arquivo, o texto inserido ou excluído, o autor e o horário. accept_tracked_changes e reject_tracked_changes recebem os ids das alterações e funcionam como o painel de revisão: uma alteração aceita permanece no texto, uma inserção rejeitada é removida e uma exclusão rejeitada volta. Um editor aberto mostra o resultado sem recarregar. As ferramentas orientam o cliente a aceitar ou rejeitar apenas as alterações que você pedir.

Histórico

A partir da v6.3.3, o cliente vê o histórico do projeto como o painel de histórico o mostra. Uma restauração é ela própria uma nova alteração, então você pode desfazê-la da mesma forma. As ferramentas orientam o cliente a restaurar apenas quando você pedir. Se o dono do projeto não tiver o histórico completo do projeto, o cliente vê apenas as alterações das últimas 24 horas, ou a mais recente se todas forem mais antigas, como no painel de histórico. Ele não pode comparar, ler ou restaurar versões mais antigas.

Chat do projeto

A partir da v6.3.3, list_chat_messages lê o chat do projeto, das mais recentes para as mais antigas, 50 mensagens por vez. send_chat_message envia uma mensagem com o seu nome, e ela aparece imediatamente em um chat aberto. Se o seu site tiver o chat do projeto desativado, o cliente não tem nenhuma das duas ferramentas.

Quem pode fazer o quê

O cliente pode fazer o que o seu papel no projeto permite. Editores que entraram por link contam como editores. Revisores não podem editar arquivos via MCP, nem mesmo como alterações rastreadas.

Desconectar um cliente

Exclua o token: veja Excluir um token. A partir daí, o servidor responde 401 a esse token. Se você também o usa para o Git, o Git também deixa de aceitá-lo.
Última modificação em 21 de novembro de 2026