> ## 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 clientes de IA como Claude Code ou Codex a um projeto por meio do servidor MCP dele.

Cada projeto tem um servidor MCP, para que clientes de IA como Claude Code, Codex, Cursor, VS Code ou Gemini CLI possam trabalhar nele: ler e editar seus arquivos, compilá-lo, ler o log do LaTeX, baixar o PDF e responder a comentários.

> [!NOTE]
>
> Este recurso foi desenvolvido por [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro). Ele foi introduzido na v6.3.1 e posteriores.

![](https://mintcdn.com/ayakaleaf-pro/75JEUzv4DcYJF7Z-/images/on-premises/8b4eca630b3083da54177b4e7a431571.png?fit=max\&auto=format\&n=75JEUzv4DcYJF7Z-\&q=85\&s=73546d80edf492bf43df53303023ca29)

![](https://mintcdn.com/ayakaleaf-pro/z0f8sws6lnhMSWO4/images/on-premises/img-c48f4f64.png?fit=max\&auto=format\&n=z0f8sws6lnhMSWO4\&q=85\&s=b6f33a465bae9952ce7be3bcb15c57c5)

### Configuração

O servidor MCP vem com a integração com Git: habilite o [git-bridge](https://ayakaleaf-pro.mintlify.site/pt/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md), e o servidor MCP também ficará disponível. Não há mais nada a configurar.

### Conectar um cliente de IA

1. Em **Account Settings**, gere um token de autenticação do Git. O mesmo token é usado para o servidor MCP e para o Git.
2. No editor, abra **Integrations** e clique em **MCP server**. São exibidos o endereço do servidor MCP do projeto, `https://<your-overleaf>/project/<project_id>/mcp`, e como adicioná-lo a cada cliente de IA: copie o comando e substitua `<token>` pelo seu token.

O token é enviado no cabeçalho HTTP `Authorization: Bearer <token>`. Por exemplo, o comando para o Claude Code é:

```bash theme={null}
claude mcp add --transport http overleaf \
  https://<your-overleaf>/project/<project_id>/mcp \
  --header "Authorization: Bearer <token>"
```

### Uso

Depois de conectado, faça pedidos ao cliente de IA em linguagem natural. Por exemplo:

| Você pede | O cliente de IA usa |
| - | - |
| *Corrija os erros de digitação na introdução.* | `read_file`, `edit_file`: as edições aparecem em tempo real no editor |
| *Compile o projeto e corrija os erros de LaTeX.* | `compile`, `get_compile_log`, `edit_file` |
| *Responda aos comentários abertos e depois resolva-os.* | `list_comments`, `reply_to_comment`, `resolve_comment` |
| *Mude para XeLaTeX e baixe o PDF.* | `update_settings`, `compile`, `get_output_file_link` |

### Ferramentas

| Grupo | Ferramentas |
| - | - |
| Projeto | `get_clone_info`, `get_settings`, `update_settings`, `list_versions` |
| Arquivos | `list_files`, `read_file`, `edit_file`, `write_file`, `delete_file` |
| Compilação | `compile`, `get_compile_log`, `get_output_file_link`, `word_count` |
| Comentários | `list_comments`, `reply_to_comment`, `resolve_comment`, `reopen_comment` |

As edições feitas com `edit_file` e `write_file` aparecem em tempo real no editor e são mescladas com as dos colaboradores. Para muitos arquivos de uma vez, arquivos binários ou renomeações, o cliente de IA também pode clonar o projeto com Git e fazer push.

### Permissões

O servidor MCP segue as configurações de compartilhamento do projeto, assim como o Git:

* Todos que podem visualizar o projeto podem lê-lo, compilá-lo e baixar seus resultados.
* Apenas o proprietário e os editores podem alterar seus arquivos e configurações.
* Os revisores também podem responder a comentários e resolver ou reabrir os comentários que eles iniciaram.
* Os visualizadores que entraram por meio de um link não podem ver os comentários, assim como no editor.

### Q\&A

> [accordion] Não vejo Integrations nem MCP server no editor
>
> **Resposta:** O MCP server não tem uma variável de ambiente própria. Ele é habilitado com `GIT_BRIDGE_ENABLED=true` em `config/overleaf.rc`; consulte [Integração com Git](https://ayakaleaf-pro.mintlify.site/pt/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md). Depois de alterá-la, execute `bin/up -d`. Sem o git-bridge, o editor não mostra a aba **Integrations** na barra lateral esquerda.


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