# github-mcp-server: cho AI đọc code, quản lý issue và PR trên GitHub — hướng dẫn cài đặt và dùng

> github-mcp-server là MCP server chính thức do GitHub phát hành. Nó nối các công cụ AI (VS Code Copilot, Claude, Cursor…) với GitHub để đọc code, quản lý issue, pull request và xem kết quả CI. Dùng bản remote do GitHub host thì chỉ cần dán vài dòng cấu hình; chạy local thì cần Docker hoặc tự build bằng Go.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-09 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/github-mcp-server-ket-noi-ai-voi-github-huong-dan-cai-dat-2

GitHub MCP Server là cầu nối chính thức do GitHub làm, giúp các công cụ AI đọc và thao tác trên GitHub bằng câu chữ bình thường. Bạn gõ yêu cầu như «liệt kê các issue đang mở trong repo này», AI sẽ gọi GitHub thay bạn rồi trả kết quả. Repo viết bằng Go, dùng giấy phép MIT và hiện có khoảng 34.400 sao, khoảng 5.300 fork.

Bạn nên đọc bài này nếu đang dùng một trợ lý AI có hỗ trợ MCP (VS Code với Copilot, Claude Desktop, Claude Code, Cursor, Windsurf, Zed…) và muốn nó làm việc với repo của mình. Chủ dự án nhỏ, lập trình viên mới hay người làm văn phòng có theo dõi một repo đều dùng được. Không cần biết Go.

Điểm đáng giá nhất là có sẵn bản remote do GitHub tự chạy. Bạn không phải cài gì lên máy, chỉ thêm một đoạn cấu hình trỏ tới địa chỉ của GitHub rồi đăng nhập. Nếu công cụ của bạn không hỗ trợ remote, còn cách chạy local bằng Docker hoặc tự build từ mã nguồn.

```repo
- repo | github/github-mcp-server
- kind | MCP server
- desc | MCP server chính thức của GitHub, cho AI đọc repo, quản lý issue, pull request và theo dõi GitHub Actions bằng ngôn ngữ tự nhiên.
- stars | 34k
- lang | Go
- license | MIT
```

## GitHub MCP Server làm được gì

Theo README, server này cho AI đọc và thao tác trên nền tảng GitHub. Mình gom lại thành năm nhóm việc chính:

- **Duyệt và hỏi về code.** AI có thể xem repo, tìm file, phân tích commit và hiểu cấu trúc dự án, ở bất kỳ repo nào bạn có quyền truy cập. Bạn không phải tự mở từng file rồi dán vào khung chat.
- **Tự động hoá issue và pull request.** Tạo, cập nhật, quản lý issue và PR. AI có thể giúp phân loại lỗi, xem xét thay đổi code và chăm sóc bảng dự án. Việc lặp đi lặp lại như gắn nhãn hay tóm tắt sẽ nhẹ hơn nhiều.
- **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. Thay vì đọc log dài, bạn hỏi thẳng «build này hỏng vì đâu».
- **Phân tích bảo mật.** Xem các phát hiện bảo mật, cảnh báo Dependabot và các mẫu code trong dự án.
- **Làm việc nhóm.** Truy cập thảo luận (discussions), quản lý thông báo, xem hoạt động của nhóm.

Ngoài ra, bản remote có khái niệm toolset (bộ công cụ). Khi bạn không chọn toolset nào, server dùng bộ mặc định. README cũng nhắc tới chế độ Insiders để dùng thử tính năng mới sớm, và hỗ trợ GitHub Enterprise Cloud có data residency (ghe.com). Chi tiết các mục này nằm trong thư mục docs của repo.

## Cần chuẩn bị gì

Tuỳ cách chạy, bạn cần khác nhau. Chỉ những mục dưới đây là README có nói:

**Nếu dùng bản remote:**

- Một công cụ AI (MCP host) hỗ trợ remote MCP server. README nêu ví dụ VS Code từ bản 1.101 trở lên, Claude Desktop, Cursor, Windsurf.
- Các chính sách (policies) liên quan đã được bật. README dẫn tới tài liệu riêng trong `docs/policies-and-governance.md`.
- Một tài khoản GitHub. Đăng nhập bằng OAuth hoặc bằng Personal Access Token (PAT).

**Nếu chạy local bằng Docker:**

- Đã cài Docker và Docker đang chạy. Ảnh nằm ở `ghcr.io/github/github-mcp-server` và là ảnh công khai.
- Đăng nhập: trên github.com, README nói bạn không cần tạo gì trước, lần đầu dùng sẽ có luồng đăng nhập OAuth qua trình duyệt, token chỉ giữ trong bộ nhớ. Hoặc dùng PAT qua biến môi trường `GITHUB_PERSONAL_ACCESS_TOKEN` (biến này được ưu tiên hơn OAuth).

**Nếu tự build:** cần Go, vì README bảo dùng `go build`. Phiên bản Go cụ thể mình không thấy ghi trong phần README được cung cấp, bạn xem file `go.mod` trong repo.

**Về hệ điều hành và phần cứng:** README phần mình đọc được không nêu yêu cầu cụ thể. Repo có file giấy phép bên thứ ba cho darwin, linux và windows, nên chắc chắn có bản cho cả ba hệ. Không thấy yêu cầu GPU hay cấu hình máy.

```note
PAT giống mật khẩu. Chỉ cấp những quyền bạn thấy yên tâm giao cho AI, vì server dùng được nhiều API của GitHub. Không dán token trực tiếp vào file bạn có thể đẩy lên GitHub.
```

## Cài đặt từng bước

```steps
- Chọn cách chạy | Remote do GitHub host (dễ nhất) hoặc local bằng Docker / build từ mã nguồn
- Chọn cách đăng nhập | OAuth qua trình duyệt, hoặc tạo Personal Access Token
- Thêm cấu hình | Dán đoạn JSON vào cấu hình MCP của công cụ AI
- Khởi động | Bật Agent mode (VS Code) hoặc khởi động lại công cụ để server chạy
- Thử hỏi | Hỏi AI một việc nhỏ trên GitHub để xác nhận
```

### Chọn cách chạy: remote hay local

Nếu công cụ của bạn hỗ trợ remote MCP server, chọn remote: GitHub tự chạy server, bạn chỉ cần một địa chỉ. Nếu không hỗ trợ, chọn local bằng Docker. Không có Docker thì build từ mã nguồn bằng Go. GitHub Enterprise Server không hỗ trợ remote, bạn phải dùng bản local.

### Cài bản remote trong VS Code

Cách nhanh nhất theo README: dùng nút cài một chạm trên trang repo, xong thì bật **Agent mode** (ở cạnh ô nhập của Copilot Chat) và server sẽ chạy. Bạn cần VS Code 1.101 trở lên để có remote MCP và OAuth.

Muốn tự cấu hình, thêm đoạn sau vào cấu hình MCP của VS Code. Đây là cách dùng OAuth, không cần tạo token:

```json
{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}
```

Nếu muốn dùng PAT thay cho OAuth, dùng đoạn này. VS Code sẽ hỏi token khi khởi động, và ô nhập được ẩn nên token không nằm lộ trong file:

```json
{
  "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: đây là nội dung file cấu hình, không phải lệnh để gõ vào terminal. Mỗi công cụ lại để file cấu hình ở chỗ khác. README chỉ sang các hướng dẫn riêng cho Claude, Cursor, Windsurf, Zed, Codex, Copilot CLI… trong thư mục `docs` của repo, bạn mở đúng hướng dẫn cho công cụ của mình.

### Chạy local bằng Docker

Đảm bảo Docker đang chạy. Dán đoạn sau vào cấu hình MCP của IDE. Đây là cách đăng nhập OAuth: ảnh Docker chính thức đã có sẵn thông tin ứng dụng cho github.com, nên bạn không điền gì. Lần đầu dùng sẽ mở đăng nhập trên trình duyệt, token chỉ giữ trong bộ nhớ. Cổng 8085 được mở ra vòng lặp nội bộ (127.0.0.1) để trang đăng nhập gọi ngược về container được:

```json
{
  "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 thích dùng PAT, dùng đoạn dưới. Biến `GITHUB_PERSONAL_ACCESS_TOKEN` được ưu tiên hơn OAuth:

```json
{
  "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}"
        }
      }
    }
  }
}
```

README còn nói: nếu có file `.vscode/mcp.json` trong workspace, bạn có thể dán cùng cấu hình (bỏ lớp `mcp` bên ngoài) để chia sẻ với các công cụ khác dùng chung định dạng.

### Cất token an toàn bằng biến môi trường

README khuyên lưu PAT trong biến môi trường thay vì ghi cứng vào cấu hình:

```bash
export GITHUB_PAT=your_token_here
```

Nếu dùng file `.env`, nhớ chặn nó khỏi bị đẩy lên GitHub:

```bash
# Add to .gitignore to prevent accidental commits
echo ".env" >> .gitignore
```

Với Claude Code CLI, README đưa sẵn lệnh thêm server. Chạy trong terminal (nơi biến `GITHUB_PAT` đã được đặt):

```bash
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-server
```

Lưu ý của README: mức hỗ trợ biến môi trường khác nhau tuỳ công cụ. Một số, như Windsurf, đòi token ghi thẳng trong file cấu hình. Khi đó hãy giới hạn quyền truy cập file đó:

```bash
chmod 600 ~/.your-app/config.json
```

### 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`, rồi chạy bằng lệnh `github-mcp-server stdio` với biến `GITHUB_PERSONAL_ACCESS_TOKEN` đã đặt. Cờ `-o` dùng để chọn nơi lưu file build ra. Sau đó bạn cấu hình công cụ AI dùng file vừa build làm `command`.

```bash
git clone https://github.com/github/github-mcp-server.git
cd github-mcp-server/cmd/github-mcp-server
go build
```

Hai lệnh đầu là lệnh git thông thường để tải mã về và vào đúng thư mục. Chạy trong terminal mở sẵn ở nơi bạn muốn lưu dự án. Tên file kết quả và cách trỏ `command` cụ thể, bạn xem phần README tiếp theo và thư mục `docs`, vì phần README mình có bị cắt giữa chừng.

### Dùng với GitHub Enterprise

Với GitHub Enterprise Server hoặc Enterprise Cloud có data residency (ghe.com), dùng cờ `--gh-host` hoặc biến `GITHUB_HOST`. Với Enterprise Server, hostname phải có `https://` ở đầu. README nói HTTPS được bắt buộc để thông tin đăng nhập không bao giờ đi qua đường không mã hoá (trừ máy nội bộ như `http://localhost` khi phát triển). Ví dụ trong README:

```json
"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>"
    }
}
```

Thay phần trong dấu `<>` bằng tên miền thật của tổ chức bạn.

## Kiểm tra đã chạy được chưa

README phần mình có không ghi một lệnh kiểm tra riêng, nên cách kiểm tra dưới đây dựa trên cách dùng bình thường:

- **VS Code:** sau khi cài, bật Agent mode cạnh ô nhập của Copilot Chat. README nói server sẽ khởi động ở bước này.
- **Bản remote bằng OAuth:** lần đầu dùng, bạn sẽ được đưa tới đăng nhập GitHub. Hoàn tất xong là xong.
- **Bản Docker bằng OAuth:** lần đầu dùng sẽ có luồng đăng nhập qua trình duyệt, token giữ trong bộ nhớ.
- **Thử một câu hỏi nhỏ:** hỏi AI «liệt kê vài issue đang mở trong repo của tôi». Nếu AI trả về dữ liệu thật từ repo của bạn thì đã nối thành công.

Nếu AI trả lời kiểu «mình không có quyền truy cập», hãy xem phần lỗi bên dưới.

## Dùng vào việc thật

### Chủ dự án nhỏ dọn issue tồn đọng

Bạn có một repo nhiều người báo lỗi, issue chất đống. Trong Agent mode, bạn gõ: «Liệt kê các issue đang mở trong repo này, nhóm theo chủ đề và cho mình biết cái nào có vẻ là lỗi nghiêm trọng». AI đọc danh sách issue qua server rồi gom nhóm. Bạn nhận được một bản tóm tắt để quyết định làm gì trước, thay vì tự đọc từng cái.

> Đừng bắt AI nhớ repo của bạn, hãy cho nó mở thẳng repo ra đọc.
>
> — Ông T

### Lập trình viên mới tìm hiểu một dự án lạ

Bạn vừa vào một dự án và chưa biết bắt đầu từ đâu. Hỏi AI: «Cho mình biết cấu trúc repo này, thư mục nào làm gì, và các commit gần đây thay đổi gì». Theo README, server cho phép duyệt code, tìm file và phân tích commit. Kết quả là một bản đồ sơ lược để bạn khỏi lạc, rồi mới đi sâu vào từng file.

### Người phụ trách kiểm tra build lỗi

Bạn thấy một lần chạy GitHub Actions báo đỏ nhưng không muốn lội log. Hỏi: «Lần chạy workflow gần nhất của repo này thất bại, phân tích giúp mình lý do». README nói server có thể theo dõi các lần chạy workflow và phân tích lỗi build. Bạn nhận được lời giải thích ngắn, từ đó biết nên sửa code hay chỉ cần chạy lại.

### Người lo bảo mật xem cảnh báo

Trong nhóm có người phải rà cảnh báo phụ thuộc. Hỏi: «Cho mình xem các cảnh báo Dependabot đang mở và xếp cái nào cần xử lý trước». README liệt kê việc xem cảnh báo Dependabot và các phát hiện bảo mật. Bạn có danh sách ưu tiên để làm tiếp, còn quyết định sửa vẫn do người làm.

## Lỗi hay gặp và cách xử lý

**Kéo ảnh Docker bị lỗi.** README nói ảnh `ghcr.io/github/github-mcp-server` là công khai. Nếu gặp lỗi khi pull, có thể bạn đang giữ token đã hết hạn. Chạy `docker logout ghcr.io` rồi thử lại.

**Server không khởi động hoặc không thấy công cụ.** Kiểm tra Docker đã chạy chưa (với cách chạy local), và VS Code đã đúng bản 1.101 trở lên chưa (với remote). Nhớ bật Agent mode. Bạn cũng nên kiểm tra JSON đã đúng cú pháp, một dấu phẩy thừa là đủ làm hỏng cấu hình.

**Đăng nhập OAuth bằng Docker không hoàn tất.** Cách Docker cần cổng 8085 được mở ra loopback. Hãy kiểm tra cấu hình có đủ phần `-p 127.0.0.1:8085:8085` và biến `GITHUB_OAUTH_CALLBACK_PORT`. Nếu máy không có trình duyệt (headless), README nhắc có phương án device-code, xem tài liệu OAuth cho local server trong `docs`.

**AI báo thiếu quyền.** Với PAT, token bạn tạo có thể chưa đủ quyền. README gợi ý các phạm vi tối thiểu như `repo`, `read:packages`, `read:org`, và khuyên chỉ cấp những gì cần. Đừng vội cấp quyền rộng để cho nhanh.

**Công cụ không đọc được biến môi trường.** README cảnh báo mức hỗ trợ khác nhau theo từng ứng dụng, một số đòi token ghi thẳng trong file cấu hình. Nếu rơi vào trường hợp đó, giới hạn quyền đọc file cấu hình và dùng một token riêng chỉ cho việc này, để lộ thì xoá nhanh.

## Có nên dùng không

**Điểm mạnh:** đây là sản phẩm chính thức của GitHub, giấy phép MIT, repo còn được cập nhật trong những tháng gần đây. Có bản remote nên cài rất nhẹ. Đăng nhập OAuth nghĩa là bạn không phải tạo và cất token. Phạm vi việc rộng: code, issue, PR, Actions, bảo mật, thảo luận.

**Giới hạn:** mỗi công cụ AI cấu hình một kiểu, README nói thẳng là cú pháp và độ ổn định tuỳ từng ứng dụng. GitHub Enterprise Server không dùng được bản remote. Server làm được nhiều việc, nên quyền bạn cấp cho nó càng cần cân nhắc. Hãy bắt đầu bằng quyền đọc và token riêng. Về chi phí chạy server thì không có gì phải trả riêng theo README phần mình có, còn chi phí của công cụ AI bạn dùng thì tuỳ gói của công cụ đó.

**Khi nào chọn cách khác:** nếu chỉ cần xem repo thỉnh thoảng, giao diện web GitHub là đủ, không cần cài gì. Nếu bạn chưa dùng công cụ AI nào hỗ trợ MCP thì chưa có lý do dùng repo này. Nếu bạn cần tự viết phần mềm Go dùng lại mã của server, README có mục dùng làm Go module với đường dẫn `github.com/github/github-mcp-server/v2`, đọc kỹ ghi chú về phiên bản trong đó.

## 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 nên mã nguồn dùng tự do. README phần mình có không nói về chi phí khác. Công cụ AI bạn dùng cùng server (ví dụ Copilot) có thể có gói riêng, bạn xem điều khoản của công cụ đó.

### Có cần cài gì lên máy không?

Với bản remote do GitHub host thì không, chỉ cần thêm cấu hình trỏ tới địa chỉ của GitHub trong công cụ AI hỗ trợ remote MCP. Với bản local, bạn cần Docker, hoặc tự build bằng Go.

### Dùng OAuth hay Personal Access Token?

Cả hai đều được. OAuth đăng nhập qua trình duyệt, không phải tạo token, và theo README token chỉ giữ trong bộ nhớ ở bản local. Nếu bạn đặt PAT qua biến GITHUB_PERSONAL_ACCESS_TOKEN thì PAT được ưu tiên hơn OAuth.

### Có chạy được trên Windows không?

Repo có file giấy phép bên thứ ba cho cả darwin, linux và windows. Chạy bằng Docker cũng không phụ thuộc hệ điều hành. README phần mình đọc không nêu yêu cầu hệ điều hành chi tiết.

### Token của tôi có an toàn không?

README khuyên dùng biến môi trường, không commit token lên git, đặt quyền tối thiểu, dùng token riêng cho từng dự án và đổi token định kỳ. Với GitHub Enterprise Server, HTTPS được bắt buộc để thông tin đăng nhập không đi qua đường không mã hoá.

### Dùng được với GitHub Enterprise không?

Có. GitHub Enterprise Cloud có data residency (ghe.com) dùng được cả bản remote lẫn local. GitHub Enterprise Server không hỗ trợ remote hosting nên phải chạy bản local, đặt hostname qua cờ --gh-host hoặc biến GITHUB_HOST.

### Có cần GPU không?

Phần README mình có không nhắc tới yêu cầu GPU hay cấu hình phần cứng. Server chỉ nối công cụ AI với GitHub, nên việc nặng do công cụ AI bạn dùng đảm nhận.
