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

Mỗi dự án có một MCP server, nhờ đó các AI client như Claude Code, Codex, Cursor, VS Code hoặc Gemini CLI có thể làm việc trên dự án: đọc và chỉnh sửa tệp, biên dịch, đọc log LaTeX, tải xuống PDF và trả lời bình luận.

<Info>
  Tính năng này được phát triển bởi [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro). Tính năng được giới thiệu từ v6.4.0 trở đi.
</Info>

<Frame caption="Integrations → MCP server">
  <img src="https://mintcdn.com/ayakaleaf-pro/B2Wnor6d9VjuXpLy/images/on-premises/mcp-server-modal.png?fit=max&auto=format&n=B2Wnor6d9VjuXpLy&q=85&s=6551a9117957ff789f4d2180936e6edb" alt="Hộp thoại MCP server trong trình soạn thảo" width="563" data-path="images/on-premises/mcp-server-modal.png" />
</Frame>

### Thiết lập

MCP server đi kèm với tích hợp Git: hãy bật [git-bridge](/vi/on-premises/configuration/overleaf-toolkit/git-integration), và MCP server cũng sẽ khả dụng. Không cần cấu hình gì thêm.

### Kết nối một AI client

1. Trong **Account Settings**, tạo một Git authentication token. Cùng một token được dùng cho MCP server và cho Git.
2. Trong trình soạn thảo, mở **Integrations** và nhấp **MCP server**. Hộp thoại hiển thị địa chỉ MCP server của dự án, `https://<your-overleaf>/project/<project_id>/mcp`, và cách thêm nó vào từng AI client: sao chép lệnh và thay `<token>` bằng token của bạn.

### Sử dụng

Sau khi kết nối, hãy yêu cầu AI client bằng ngôn ngữ thông thường. Ví dụ:

| Bạn yêu cầu | AI client sử dụng |
| - | - |
| *Sửa lỗi chính tả trong phần giới thiệu.* | `read_file`, `edit_file`: các chỉnh sửa hiển thị trực tiếp trong trình soạn thảo |
| *Biên dịch dự án và sửa các lỗi LaTeX.* | `compile`, `get_compile_log`, `edit_file` |
| *Trả lời các bình luận đang mở, sau đó đánh dấu đã giải quyết.* | `list_comments`, `reply_to_comment`, `resolve_comment` |
| *Chuyển sang XeLaTeX và tải xuống PDF.* | `update_settings`, `compile`, `get_output_file_link` |

### Công cụ

| Nhóm | Công cụ |
| - | - |
| Dự án | `get_clone_info`, `get_settings`, `update_settings`, `list_versions` |
| Tệp | `list_files`, `read_file`, `edit_file`, `write_file`, `delete_file` |
| Biên dịch | `compile`, `get_compile_log`, `get_output_file_link`, `word_count` |
| Bình luận | `list_comments`, `reply_to_comment`, `resolve_comment`, `reopen_comment` |

Các chỉnh sửa thực hiện bằng `edit_file` và `write_file` hiển thị trực tiếp trong trình soạn thảo và được hợp nhất với chỉnh sửa của các cộng tác viên. Đối với nhiều tệp cùng lúc, tệp nhị phân hoặc đổi tên, AI client cũng có thể clone dự án bằng Git và push.

### Quyền

MCP server tuân theo cài đặt chia sẻ của dự án, giống như Git:

* Mọi người có thể xem dự án đều có thể đọc, biên dịch và tải xuống đầu ra của dự án.
* Chỉ chủ sở hữu và người chỉnh sửa mới có thể thay đổi tệp và cài đặt của dự án.
* Người review cũng có thể trả lời bình luận, và đánh dấu đã giải quyết hoặc mở lại các bình luận do họ bắt đầu.
* Người xem tham gia qua liên kết không thể thấy các bình luận, giống như trong trình soạn thảo.


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