Trải nghiệm khi dùng GitHub MCP Server
Cách dễ nhất là dùng bản remote do GitHub chạy sẵn: trong VS Code (từ phiên bản 1.101 trở lên), bạn dùng nút cài một chạm trong README hoặc dán khối cấu hình với địa chỉ https://api.githubcopilot.com/mcp/. Lần đầu dùng, trình duyệt mở ra để bạn đăng nhập GitHub qua OAuth, không phải tự tạo token.
Sau khi bật chế độ agent trong khung chat Copilot, bạn hỏi bằng tiếng thường: liệt kê các issue đang mở có nhãn bug, tóm tắt pull request này, hay vì sao workflow build lại fail. AI gọi công cụ của máy chủ MCP để đọc dữ liệu thật rồi trả lời, và nếu bạn cho phép thì có thể tạo issue hoặc bình luận.
Nếu ứng dụng của bạn chưa hỗ trợ máy chủ từ xa, hoặc dùng GitHub Enterprise Server, bạn chạy bản cục bộ bằng Docker (image ghcr.io/github/github-mcp-server) và đăng nhập bằng OAuth hay token cá nhân (PAT). Bạn cũng có thể bật chỉ một số nhóm công cụ để AI không bị rối và không có quyền thừa.
Tính năng nổi bật
Quản lý repo và mã nguồn
Duyệt repo, đọc file, tìm kiếm mã, xem commit để AI hiểu cấu trúc dự án bạn có quyền truy cập.
Issue và pull request
Tạo, cập nhật, phân loại issue và pull request, hỗ trợ xem xét thay đổi mã.
Theo dõi CI/CD
Xem các lần chạy GitHub Actions, phân tích vì sao build lỗi, quản lý bản phát hành.
Phân tích bảo mật
Xem kết quả quét bảo mật và cảnh báo Dependabot để biết dự án có lỗ hổng nào.
Chọn nhóm công cụ, chế độ chỉ đọc
Dùng cờ toolsets để bật đúng nhóm cần thiết; cờ read-only chặn mọi công cụ ghi.
Hai kiểu chạy
Bản remote do GitHub lo hạ tầng và bản cục bộ chạy bằng Docker hoặc chương trình riêng khi cần kiểm soát hơn.
Tận dụng GitHub MCP Server vào việc gì?
Quản lý dự án, trưởng nhóm
Hỏi nhanh về tình trạng dự án
Nhờ AI liệt kê issue, pull request đang chờ, ai đang làm gì thay vì lục từng trang.
Lập trình viên
Trợ giúp review và hiểu mã
Nhờ AI tóm tắt thay đổi của một pull request hoặc tìm chỗ dùng một hàm trong repo.
Lập trình viên, DevOps
Điều tra build bị đỏ
Cho AI xem log GitHub Actions và gợi ý nguyên nhân.
Người duy trì dự án mã nguồn mở
Phân loại issue từ cộng đồng
AI đề xuất nhãn và trả lời mẫu cho issue mới; bạn xem và duyệt trước khi đăng.
Cần chuẩn bị gì?
- Tài khoản GitHub; muốn truy cập repo riêng tư thì phải có quyền tương ứng.
- Ứng dụng hỗ trợ MCP: VS Code 1.101 trở lên cho bản remote với OAuth, hoặc Claude Desktop, Claude Code, Cursor, Windsurf...
- Docker đang chạy nếu dùng bản cục bộ bằng image ghcr.io/github/github-mcp-server.
- Personal Access Token nếu bạn chọn đăng nhập bằng token thay vì OAuth.
Hướng dẫn cài đặt chi tiết
Cài trên Remote (VS Code)
Cách nhanh nhất: dùng nút Install Server trong README của dự án, hoặc thêm cấu hình sau vào file cấu hình MCP của VS Code (phiên bản 1.101 trở lên). Dùng OAuth nên không cần tạo token.
{ "servers": { "github": { "type": "http", "url": "https://api.githubcopilot.com/mcp/" } } }Bật chế độ Agent trong Copilot Chat để máy chủ khởi động, rồi làm theo cửa sổ đăng nhập GitHub.
Nếu ứng dụng khác như Claude, Cursor, Windsurf, xem các hướng dẫn riêng trong thư mục docs/installation-guides của repo.
Cài trên Docker (cục bộ)
Cài Docker và bật lên. Thêm cấu hình sau vào ứng dụng MCP của bạn. Lệnh dùng OAuth và công khai cổng gọi lại cục bộ 8085 để quá trình đăng nhập hoạt động.
{ "mcp": { "servers": { "github": { "command": "docker", "args": [ "run", "-i", "--rm", "-p", "127.0.0.1:8085:8085", "-e", "GITHUB_OAUTH_CALLBACK_PORT", "ghcr.io/github/github-mcp-server" ], "env": { "GITHUB_OAUTH_CALLBACK_PORT": "8085" } } } } }Nếu pull image báo lỗi, README gợi ý chạy docker logout ghcr.io để bỏ token hết hạn.
docker logout ghcr.io
Cài trên Claude Code (token)
Tạo Personal Access Token trên GitHub với quyền tối thiểu cần thiết, lưu vào biến môi trường GITHUB_PAT trên máy, rồi thêm máy chủ vào Claude Code bằng lệnh theo README.
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-serverLệnh trên viết cho bash; trên Windows chạy trong Git Bash hoặc WSL, hoặc xem hướng dẫn riêng cho Claude trong repo.
Dùng thử lần đầu
Cài bằng một trong các cách trên và đăng nhập GitHub khi được hỏi.
Bắt đầu bằng yêu cầu chỉ đọc, ví dụ nhờ AI liệt kê repo hoặc issue đang mở của một dự án bạn có quyền xem.
Hỏi AI tóm tắt một pull request cụ thể hoặc giải thích vì sao một lần chạy GitHub Actions bị lỗi.
Chỉ sau khi tin tưởng, mới cho AI tạo issue hoặc bình luận, và luôn đọc lại trước khi chấp nhận.
Mẹo dùng hay
- Bật chế độ chỉ đọc (cờ --read-only) khi bạn chỉ cần tra cứu; README ghi chế độ này ưu tiên cao hơn cả khi bạn bật riêng từng công cụ.
- Chỉ bật các toolsets cần thiết như repos, issues, pull_requests để AI chọn công cụ chính xác và tiết kiệm ngữ cảnh.
- Với token, cấp quyền tối thiểu, dùng token riêng cho từng dự án và đổi định kỳ; đừng commit token vào repo.
- Dùng GitHub Enterprise Server thì phải chạy bản cục bộ và đặt GITHUB_HOST theo README.
Lưu ý và hạn chế
- AI có thể tạo issue, bình luận hay thay đổi dữ liệu thật trên GitHub nếu bạn cho quyền ghi; cẩn thận với repo của tổ chức và công ty.
- Máy chủ có thể đọc những gì tài khoản hoặc token của bạn xem được, kể cả repo riêng tư; đừng cho AI chạm tới dữ liệu bạn không muốn gửi cho dịch vụ AI.
- Một số chính sách của tổ chức hoặc Copilot có thể cần bật thì bản remote mới dùng được.
Câu hỏi thường gặp
Có miễn phí không?
Máy chủ mã nguồn mở theo giấy phép MIT và miễn phí. Chi phí nếu có đến từ ứng dụng AI hoặc gói Copilot bạn dùng cùng.
Bản remote và bản cục bộ khác gì?
Bản remote do GitHub lo hạ tầng nên cài nhanh nhất; bản cục bộ chạy bằng Docker trên máy bạn, dùng khi ứng dụng chưa hỗ trợ máy chủ từ xa hoặc khi dùng GitHub Enterprise Server.
Tôi có cần tạo token không?
Với OAuth thì không. README nói trên github.com bạn có thể đăng nhập bằng trình duyệt, còn token cá nhân là lựa chọn thay thế.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/github/github-mcp-server.gitRepo tương tự nên xem
MCP Reference Servers
modelcontextprotocol / servers
Bộ máy chủ MCP mẫu chính thức: đọc file, lấy nội dung web, Git, bộ nhớ, giờ giấc cho Claude và các AI khác
Awesome MCP Servers
punkpeye / awesome-mcp-servers
Danh sách tuyển chọn hàng nghìn máy chủ MCP để cho AI dùng file, trình duyệt, cơ sở dữ liệu, ứng dụng...
Claude Code
anthropics / claude-code
Trợ lý AI viết code của Anthropic chạy trong Terminal, đọc hiểu dự án, sửa file và xử lý Git bằng lời thường