GitHub MCP Server: cho AI đọc code, quản lý issue và PR — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về github/github-mcp-server — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: github-mcp-server: Kết nối AI với GitHub — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
GitHub MCP Server là máy chủ MCP chính thức do GitHub phát hành. Nó nối các công cụ AI như VS Code, Claude, Cursor với GitHub để đọc code, quản lý issue, pull request và workflow. Cách dùng bản remote khá dễ, chỉ cần dán vài dòng cấu hình. Bản chạy local cần thêm Docker hoặc tự build bằng Go.
GitHub MCP Server là máy chủ MCP chính thức do GitHub phát hành, giúp các công cụ AI nói chuyện trực tiếp với GitHub. Sau khi nối, trợ lý AI của bạn có thể đọc code trong repo, tạo và cập nhật issue, xử lý pull request, xem kết quả GitHub Actions, tất cả qua câu lệnh tiếng thường như khi bạn chat.
Nếu bạn từng phải copy code từ GitHub dán vào khung chat AI, hoặc tự mở từng issue để tóm tắt, repo này sinh ra để bỏ những bước đó. Người nên dùng là lập trình viên, người quản lý dự án phần mềm, hoặc bất kỳ ai làm việc hằng ngày với GitHub và đã dùng một công cụ AI hỗ trợ MCP (VS Code, Claude Desktop, Cursor, Windsurf…).
Điểm đáng giá nhất: đây là bản do chính GitHub làm, hiện có khoảng 34.400 sao và 5.300 fork, giấy phép MIT. Bạn có hai lựa chọn: dùng bản remote do GitHub lưu trữ sẵn (dễ nhất, không cần cài gì), hoặc chạy bản local bằng Docker hay tự build.
github/github-mcp-server
MCP server chính thức của GitHub, cho trợ lý AI đọc repo, quản lý issue, pull request và theo dõi GitHub Actions bằng ngôn ngữ tự nhiên.
I.GitHub MCP Server làm được gì
Theo README, repo gom khả năng vào năm nhóm việc chính. Mỗi nhóm đều tiết kiệm thời gian thật:
- Quản lý repo: duyệt và hỏi đáp về code, tìm file, phân tích commit, hiểu cấu trúc dự án trên mọi repo bạn có quyền truy cập. Bạn không cần clone về máy chỉ để hỏi "file này làm gì".
- Tự động hoá issue và PR: tạo, cập nhật, quản lý issue và pull request. AI có thể giúp phân loại lỗi, xem lại thay đổi code, giữ bảng dự án gọn gàng.
- Theo dõi CI/CD: xem các lần chạy GitHub Actions, phân tích vì sao build hỏng, quản lý bản phát hành. Bạn đỡ phải đọc log dài.
- Phân tích code: xem các phát hiện bảo mật, cảnh báo Dependabot, hiểu các mẫu code trong dự án.
- Làm việc nhóm: truy cập discussions, quản lý thông báo, xem hoạt động của nhóm.
Ngoài ra, server có cấu hình theo nhóm công cụ (toolset). Khi bạn không chỉ định, nó dùng các toolset mặc định. Chi tiết toolset nằm trong tài liệu Remote Server của repo. Bản remote còn có chế độ Insiders để dùng thử tính năng mới sớm.
II.Cần chuẩn bị gì
Tuỳ cách chạy, bạn cần khác nhau.
Nếu dùng bản remote (dễ nhất):
- Một công cụ AI hỗ trợ MCP server từ xa, ví dụ VS Code từ phiên bản 1.101 trở lên, Claude Desktop, Cursor, Windsurf.
- Các chính sách (policies) liên quan đã được bật nếu tổ chức của bạn có áp dụng. README dẫn tới trang docs/policies-and-governance.md trong repo.
- Đăng nhập bằng OAuth hoặc một GitHub Personal Access Token (PAT).
Nếu chạy bản local bằng Docker:
- Cài Docker và nhớ bật Docker lên (đang chạy).
- Image nằm ở
ghcr.io/github/github-mcp-servervà là image công khai. - Xác thực: trên github.com, README nói bạn không cần tạo gì trước, nút cài một chạm sẽ đăng nhập OAuth qua trình duyệt ở lần dùng đầu. Hoặc bạn tự tạo PAT và đặt vào biến
GITHUB_PERSONAL_ACCESS_TOKEN(biến này được ưu tiên hơn OAuth).
Nếu tự build từ mã nguồn: cần có Go (ngôn ngữ chính của repo). README chưa nêu cụ thể phiên bản Go ở đoạn mình có, bạn xem file go.mod trong repo để biết.
Về hệ điều hành và phần cứng, tư liệu mình có không nói yêu cầu riêng. Repo có sẵn file giấy phép bên thứ ba cho darwin, linux và windows, nên có thể hiểu là cả ba nền tảng đều được tính tới.
PAT là chìa khoá vào tài khoản GitHub của bạn. Chỉ cấp những quyền thật sự cần, không dán token vào file code, không đưa lên repo công khai. Nếu lỡ lộ, hãy thu hồi token ngay trong phần cài đặt GitHub.
III.Cài đặt từng bước
- Chọn cách chạyQuyết định dùng bản remote (GitHub lưu trữ) hay local (Docker hoặc tự build)
- Chuẩn bị công cụCó công cụ AI hỗ trợ MCP; nếu chạy local thì cài và bật Docker
- Thêm cấu hìnhDán khối JSON (hoặc chạy lệnh claude mcp add) vào công cụ của bạn
- Đăng nhậpDùng OAuth hoặc điền GitHub PAT
- Thử một câu hỏiBật Agent mode hoặc mở chat và nhờ AI đọc một repo
A.Chọn cách chạy
Nếu công cụ của bạn hỗ trợ MCP từ xa, hãy chọn bản remote. README gọi đây là cách "dễ nhất để bắt đầu". Nếu công cụ chỉ hỗ trợ MCP chạy trên máy (local), hoặc bạn dùng GitHub Enterprise Server (bản này không hỗ trợ remote), hãy chọn bản local.
B.Cài bản remote vào VS Code
Cách nhanh nhất: dùng nút cài một chạm trong README của repo. Xong, bật Agent mode (nằm cạnh ô nhập của Copilot Chat) là server tự khởi động. Nhớ dùng VS Code 1.101 trở lên để có hỗ trợ MCP từ xa và OAuth.
Nếu muốn cấu hình tay, thêm một trong hai khối sau vào cấu hình MCP của bạn.
Đăng nhập bằng OAuth:
{
"servers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
}
}
}Hoặc dùng PAT, VS Code sẽ hỏi token khi cần và ẩn khi gõ:
{
"servers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/",
"headers": {
"Authorization": "Bearer ${input:github_mcp_pat}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "github_mcp_pat",
"description": "GitHub Personal Access Token",
"password": true
}
]
}Chỗ người mới hay vấp: README lưu ý mỗi ứng dụng MCP phải tự cấu hình GitHub App hoặc OAuth App thì mới đăng nhập OAuth được. Nếu ứng dụng của bạn không hỗ trợ OAuth, hãy dùng cách PAT. Cách cấu hình cho Claude, Cursor, Windsurf, Zed, Codex… có hướng dẫn riêng trong thư mục docs của repo.
C.Chạy bản local bằng Docker (dùng PAT)
Tạo PAT tại trang GitHub dành cho token cá nhân (README dẫn link github.com/settings/personal-access-tokens/new). Sau đó thêm khối này vào cấu hình MCP của IDE:
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "github_token",
"description": "GitHub Personal Access Token",
"password": true
}
],
"servers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
}
}
}
}
}Nếu muốn chia sẻ cấu hình giữa các ứng dụng, bạn có thể đặt phiên bản không có khoá mcp vào file .vscode/mcp.json trong thư mục dự án. Docker phải đang chạy thì khối trên mới hoạt động.
D.Hoặc đăng nhập OAuth với Docker
Không muốn tạo token? Trên github.com, image chính thức đã có sẵn thông tin ứng dụng OAuth. Lần dùng đầu nó mở đăng nhập trên trình duyệt, token chỉ giữ trong bộ nhớ. Với Docker, cần mở một cổng cố định cho phần gọi lại (callback):
{
"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 cổng 8085 đang bị chương trình khác chiếm, phần đăng nhập sẽ không nhận được kết quả. Cách dùng không có giao diện (headless) và dùng OAuth App riêng được mô tả ở tài liệu Local Server OAuth Login trong repo.
E.Thêm vào Claude Code bằng một lệnh
README có sẵn ví dụ cho Claude Code CLI. Trước hết lưu token vào biến môi trường để khỏi gõ lại:
export GITHUB_PAT=your_token_hereSau đó thêm server:
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 này nói với Claude Code: tạo một server tên github, truyền token vào, và khởi động nó bằng Docker. Thay your_token_here bằng token thật của bạn. Lệnh export dùng cho macOS/Linux; trên Windows PowerShell, cách đặt biến môi trường khác, README chưa ghi riêng cho PowerShell.
F.Tự build từ mã nguồn (khi không có Docker)
README nói: nếu không có Docker, dùng go build để build file chạy trong thư mục cmd/github-mcp-server. Có thể dùng cờ -o để chọn nơi lưu file. Sau đó cấu hình server dùng file đó làm command, chạy với lệnh con stdio và biến GITHUB_PERSONAL_ACCESS_TOKEN.
git clone https://github.com/github/github-mcp-server.git
cd github-mcp-server/cmd/github-mcp-server
go buildBa lệnh này tải mã nguồn, vào đúng thư mục và build. Khi cấu hình trong công cụ AI, bạn trỏ command tới file vừa tạo và thêm tham số stdio. README ở đoạn mình có không kèm ví dụ JSON đầy đủ cho cách này, bạn xem phần Build from source trong README gốc.
G.Dùng với GitHub Enterprise
Cờ --gh-host hoặc biến GITHUB_HOST đặt tên máy chủ cho GitHub Enterprise Server hay Enterprise Cloud (ghe.com). Với Enterprise Server, địa chỉ phải bắt đầu bằng https://. Server từ chối địa chỉ không dùng HTTPS để token không bị gửi dạng thô (riêng localhost để phát triển thì được). Ví dụ của README:
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"-e",
"GITHUB_HOST",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
"GITHUB_HOST": "https://<your GHES or ghe.com domain name>"
}
}IV.Kiểm tra đã chạy được chưa
Cách kiểm tra theo README với VS Code: bật Agent mode cạnh ô nhập của Copilot Chat thì server sẽ khởi động. Bạn mở danh sách công cụ của chat, nếu thấy các công cụ của server github là đã nối được.
Với các ứng dụng khác, giao diện mỗi nơi một kiểu. README không mô tả màn hình cụ thể, nên mình khuyên bạn thử bằng một câu hỏi đơn giản, chỉ đọc, không sửa gì:
Hãy liệt kê 5 issue đang mở gần đây nhất trong repo github/github-mcp-server và tóm tắt mỗi issue một dòng.Nếu AI trả về danh sách issue thật, bạn đã nối thành công. Nếu nó trả lời kiểu "tôi không có công cụ nào", xem phần lỗi thường gặp bên dưới.
V.Dùng vào việc thật
Các ví dụ dưới đây bám đúng nhóm khả năng README nêu. Câu lệnh mẫu chỉ là gợi ý, bạn đổi tên repo cho phù hợp.
A.Tóm tắt dự án cho người mới vào nhóm
Bạn là lập trình viên mới vào một công ty, được giao một repo lạ, chưa biết bắt đầu đọc từ đâu. Thay vì mở từng thư mục, bạn hỏi AI:
Đọc repo cong-ty/ten-repo, cho mình biết cấu trúc thư mục chính, file nào là điểm bắt đầu, và 5 commit gần đây thay đổi những gì.Kết quả là một bản tóm tắt cấu trúc dự án và các thay đổi mới nhất. Bạn tiết kiệm được cả buổi làm quen.
Hỏi thẳng AI về repo, đỡ phải mở từng file để đoán.
Ông T
B.Phân loại issue cho quản lý dự án
Bạn quản lý một dự án nhỏ, cuối tuần có hàng chục issue mới. Bạn nhờ:
Xem các issue đang mở của repo cong-ty/ten-repo, nhóm theo mức độ khẩn cấp và gợi ý nhãn cho từng issue.AI đọc issue và trả về bảng phân loại. Nếu bạn cho phép, nó có thể tạo hoặc cập nhật issue theo kết quả. Với việc có sửa dữ liệu, hãy yêu cầu nó hỏi bạn xác nhận trước khi thực hiện.
C.Tìm hiểu vì sao build bị hỏng
Bạn đẩy code lên và GitHub Actions báo đỏ. Thay vì lần mò log:
Xem lần chạy workflow gần nhất của repo cong-ty/ten-repo bị lỗi, giải thích nguyên nhân và gợi ý cách sửa.AI đọc kết quả workflow, chỉ ra bước nào hỏng và lý do khả dĩ. Đây là nhóm CI/CD mà README nêu rõ.
D.Rà cảnh báo bảo mật
Nếu bạn phụ trách an toàn cho dự án, có thể hỏi:
Có cảnh báo Dependabot nào đang mở trong repo cong-ty/ten-repo không? Liệt kê theo mức độ nghiêm trọng.Bạn nhận danh sách cảnh báo để xử lý theo thứ tự ưu tiên. Điều kiện là token hoặc tài khoản của bạn phải có quyền xem các cảnh báo đó.
VI.Lỗi hay gặp và cách xử lý
A.Docker kéo image bị lỗi
README nói image là công khai. Nếu bị lỗi khi tải, có thể bạn đang giữ một token đã hết hạn. Cách xử lý theo README: chạy docker logout ghcr.io rồi thử lại.
docker logout ghcr.ioB.Công cụ AI không thấy server github
Thường do Docker chưa chạy, cấu hình dán sai chỗ hoặc sai cú pháp JSON (thiếu dấu phẩy, dấu ngoặc). Hãy kiểm tra Docker đã bật, rồi so khối JSON với bản trong README. Mỗi ứng dụng có cú pháp riêng, README cũng nói điều này, nên đọc hướng dẫn của đúng ứng dụng bạn dùng trong thư mục docs của repo.
C.Đăng nhập OAuth không hoàn tất
Với Docker, cổng callback 8085 phải được mở và không bị chương trình khác chiếm. Nếu máy không có trình duyệt (máy chủ, môi trường headless), README nhắc có cách dự phòng dùng device-code, xem tài liệu Local Server OAuth Login. Hoặc đổi sang dùng PAT cho nhanh.
D.AI báo không có quyền truy cập
Nếu dùng PAT, token có thể thiếu quyền. README gợi ý các quyền như repo, read:packages, read:org. Hãy cấp đúng mức cần thiết, đừng cấp thừa. Nếu repo thuộc tổ chức, tổ chức đó có thể có chính sách chặn, kiểm tra trang policies and governance trong repo.
E.Cấu hình trong ứng dụng không hỗ trợ biến môi trường
README lưu ý hỗ trợ biến môi trường khác nhau giữa các ứng dụng, và một số như Windsurf yêu cầu ghi token cứng trong file cấu hình. Nếu buộc phải làm vậy, hãy giới hạn quyền token ở mức nhỏ nhất và hạn chế quyền đọc file cấu hình. README có ví dụ chmod 600 cho macOS/Linux.
VII.Có nên dùng không
Điểm mạnh:
- Do chính GitHub phát hành, giấy phép MIT, repo vẫn được cập nhật trong vài tháng gần đây.
- Có hai cách chạy: remote (cài nhanh) và local (tự kiểm soát hơn).
- Hỗ trợ nhiều công cụ: VS Code, Claude, Cursor, Windsurf, Zed, Codex, Gemini CLI và nhiều nơi khác.
- Có thể đăng nhập bằng OAuth, không bắt buộc tạo token.
- Hỗ trợ GitHub Enterprise Cloud và Enterprise Server (qua bản local).
Giới hạn:
- Bạn cần một công cụ AI hỗ trợ MCP. Không có công cụ đó thì repo này chưa dùng được.
- Cấu hình và độ ổn định khác nhau theo từng ứng dụng, chính README cũng cảnh báo điều này.
- Bản remote không hỗ trợ GitHub Enterprise Server.
- Việc cấp quyền cho AI sửa issue, PR là việc nhạy cảm. Hãy cấp quyền tối thiểu và đọc kỹ những gì AI định làm trước khi đồng ý.
- Chi phí của mô hình AI bạn dùng là chuyện riêng, tư liệu mình có không nói gì về giá.
Khi nào chọn cách khác: nếu bạn chỉ thỉnh thoảng cần xem GitHub, giao diện web hoặc GitHub CLI có thể đủ. Nếu bạn không dùng công cụ AI hỗ trợ MCP, repo này chưa mang lại gì. Còn nếu bạn đã dùng AI để viết code mỗi ngày và muốn nó hiểu luôn issue, PR, workflow của dự án, thì đây là một mắt xích đáng thử.
Câu hỏi thường gặp
GitHub MCP Server có miễn phí không?
Repo dùng giấy phép MIT, bạn tải và dùng mã nguồn tự do. Tư liệu mình có không nói gì về phí của bản remote hay phí của công cụ AI bạn nối vào. Với những khoản đó, bạn nên xem điều khoản của GitHub và của công cụ AI.
Cài có cần Docker không?
Không bắt buộc. Bản remote do GitHub lưu trữ nên không cần Docker. Bản local thì dùng Docker hoặc tự build bằng lệnh go build trong thư mục cmd/github-mcp-server.
Có cần GitHub token (PAT) không?
Không nhất thiết. Bạn có thể đăng nhập bằng OAuth qua trình duyệt, cả với bản remote lẫn bản local trên github.com. Nếu muốn dùng token, đặt vào biến GITHUB_PERSONAL_ACCESS_TOKEN, biến này được ưu tiên hơn OAuth.
Có chạy được trên Windows không?
Repo có sẵn file giấy phép bên thứ ba cho darwin, linux và windows, và chạy bằng Docker hoặc file build bằng Go. Tuy nhiên README ở phần mình có không nói rõ yêu cầu hệ điều hành, nên bạn nên xem hướng dẫn riêng cho ứng dụng của bạn trong thư mục docs.
Dữ liệu và token của tôi có an toàn không?
Với OAuth, README nói token chỉ giữ trong bộ nhớ. README cũng khuyên cấp quyền tối thiểu, dùng token riêng cho từng dự án, đổi token định kỳ và không đưa token vào hệ thống quản lý phiên bản. Ngoài các khuyến nghị đó, tư liệu mình có chưa nói thêm về cách xử lý dữ liệu.
Dùng được với GitHub Enterprise không?
Có. GitHub Enterprise Cloud với data residency (ghe.com) dùng được bản remote. GitHub Enterprise Server không hỗ trợ bản remote, bạn dùng bản local với cờ --gh-host hoặc biến GITHUB_HOST, và địa chỉ phải bắt đầu bằng https://.
Toolset là gì, có cần cấu hình không?
Toolset là các nhóm công cụ mà server cung cấp cho AI. Nếu bạn không chỉ định gì thì server dùng các toolset mặc định. Danh sách đầy đủ và cách tuỳ chỉnh nằm trong tài liệu Remote Server của repo.


