MCP Server

Kết nối các AI client như Claude Code hoặc Codex với một dự án thông qua MCP server của dự án.

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.

Tính năng này được phát triển bởi ayaka-notes/ayakaleaf-pro. Tính năng được giới thiệu từ v6.3.1 trở đi.

​

Thiết lập

MCP server đi kèm với tích hợp Git: hãy bật git-bridge, 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.

Token được gửi dưới dạng HTTP header Authorization: Bearer <token>. Ví dụ, lệnh cho Claude Code là:

claude mcp add --transport http overleaf \
  https://<your-overleaf>/project/<project_id>/mcp \
  --header "Authorization: Bearer <token>"

​

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.

​

Hỏi & Đáp

Tôi không thấy Integrations hoặc MCP server trong trình soạn thảo

Trả lời: MCP server không có biến môi trường riêng. Nó được bật bằng GIT_BRIDGE_ENABLED=true trong config/overleaf.rc, xem Tích hợp Git. Sau khi thay đổi, hãy chạy bin/up -d. Khi không có git-bridge, trình soạn thảo sẽ không hiển thị tab Integrations ở thanh bên trái.