# 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 của GitHub, giúp các công cụ AI như VS Code Copilot, Claude, Cursor đọc code, quản lý issue, pull request và xem workflow ngay trên GitHub. Bạn có thể dùng bản remote do GitHub host sẵn hoặc chạy bản local bằng Docker. Cài không khó: chủ yếu là dán một đoạn JSON cấu hình rồi đăng nhập.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-07 · 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

GitHub MCP Server là phần mềm chính thức của GitHub, dùng để nối các công cụ AI với nền tảng GitHub. Nhờ nó, trợ lý AI của bạn có thể đọc repo và file code, tạo hoặc cập nhật issue và pull request, xem kết quả GitHub Actions, rồi trả lời bằng ngôn ngữ thường ngày. Repo hiện có khoảng 34.421 sao và 5.340 fork, viết bằng Go, giấy phép MIT.

Nếu bạn đang dùng một công cụ AI hỗ trợ MCP (VS Code, Claude Desktop, Cursor, Windsurf...) và hay phải chuyển qua lại giữa khung chat với trang GitHub, repo này dành cho bạn. Lập trình viên mới sẽ thấy rõ nhất: thay vì tự lục từng file, bạn hỏi AI "repo này cấu trúc thế nào" hoặc "issue nào đang mở" là có câu trả lời.

Điểm đáng giá nhất: GitHub cung cấp sẵn bản remote chạy trên máy chủ của họ. Bạn gần như không phải cài gì, chỉ dán cấu hình và đăng nhập. Nếu muốn chạy trên máy mình, có bản local qua 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 trợ lý AI đọc repo, quản lý issue, pull request và theo dõi 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 gom các khả năng của GitHub vào cho AI dùng. Các nhóm chính:

- **Quản lý repo:** duyệt và tìm code, tìm file, xem commit, hiểu cấu trúc dự án trên bất kỳ repo nào bạn có quyền truy cập. Bạn không cần clone về máy chỉ để hỏi "hàm này nằm ở đâu".
- **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 xét thay đổi code, theo dõi bảng dự án.
- **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ý release. Bạn đỡ phải đọc log dài dằng dặc.
- **Phân tích code:** xem các cảnh báo 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 team.

Ngoài ra, bản remote cho phép chọn nhóm công cụ (toolset). Khi bạn không chỉ định, hệ thống dùng nhóm mặc định. Có cả chế độ Insiders để thử tính năng mới sớm, và hỗ trợ GitHub Enterprise Cloud (ghe.com).

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

Tuỳ cách chạy, bạn cần khác nhau.

**Bản remote (dễ nhất):**

- Một MCP host hỗ trợ remote server, 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, nếu tổ chức của bạn có áp dụng. README có trỏ tới trang policies and governance trong thư mục docs.
- Đăng nhập bằng OAuth hoặc dùng GitHub Personal Access Token (PAT).

**Bản local:**

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

README phần mình có không nêu yêu cầu hệ điều hành hay phần cứng cụ thể. Bạn không cần GPU vì đây chỉ là cầu nối tới GitHub.

```note
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 cần, không dán token vào chỗ công khai, không commit file chứa token lên repo.
```

## 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
- Mở file cấu hình MCP | Dán đoạn JSON vào cấu hình của VS Code hoặc host bạn dùng
- Đăng nhập | OAuth trên trình duyệt, hoặc nhập PAT khi được hỏi
- Bật Agent mode | Để host khởi động server
- Hỏi thử AI | Nhờ AI liệt kê issue hoặc đọc một repo
```

### Chọn cách chạy

Nếu host của bạn hỗ trợ remote server, chọn bản remote: không cần Docker, không cần build. Nếu host không hỗ trợ, README bảo dùng bản local. Với VS Code, README còn có nút cài một chạm; sau khi xong bạn chỉ cần bật Agent mode ở khung Copilot Chat.

### Cấu hình bản remote trong VS Code (OAuth)

Mở file cấu hình MCP của VS Code (bản 1.101 trở lên) và thêm khối sau. Cách này đăng nhập bằng OAuth, không cần tạo token:

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

Địa chỉ `https://api.githubcopilot.com/mcp/` là máy chủ remote của GitHub. Bạn không cần chạy gì trên máy mình.

### Cấu hình bản remote bằng PAT

Nếu host của bạn không hỗ trợ OAuth, dùng PAT. Bạn tạo token tại trang Personal Access Tokens của GitHub, rồi dùng khối này. VS Code sẽ hiện ô hỏi token, và vì có `"password": true` nên chữ được ẩn đi:

```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: README ghi mỗi host cần tự cấu hình GitHub App hoặc OAuth App để hỗ trợ OAuth từ xa, mức hỗ trợ khác nhau. Nếu OAuth không chạy ở host của bạn, hãy chuyển sang PAT.

### Chạy bản local bằng Docker

Đảm bảo Docker đang chạy. Ảnh công khai, nên nếu kéo ảnh bị lỗi, README gợi ý token cũ đã hết hạn và bạn cần đăng xuất:

```bash
docker logout ghcr.io
```

Sau đó thêm cấu hình vào phần MCP của IDE. Bản dùng PAT như sau (khối này viết cho VS Code, dán vào file cấu hình MCP của host):

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

Muốn dùng OAuth thay vì token, README đưa cấu hình có thêm cổng callback cố định `127.0.0.1:8085`, để cửa sổ đăng nhập gọi ngược về được container:

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

Bạn cũng có thể đặt cấu hình (bỏ khóa `mcp`) vào file `.vscode/mcp.json` trong thư mục dự án để chia sẻ với các host khác cùng định dạng.

### Dùng với Claude Code

README có sẵn một lệnh mẫu cho Claude Code, dùng token lưu trong biến môi trường. Trước tiên lưu token (Mac/Linux):

```bash
export GITHUB_PAT=your_token_here
```

Rồi thêm server:

```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ệnh này nói với Claude Code: tên server là `github`, khi cần thì chạy Docker và truyền token vào. Lưu ý: `export` là cú pháp của bash. Trên Windows PowerShell cách đặt biến khác; README không hướng dẫn riêng cho PowerShell, nên bạn xem tài liệu của host nếu cần.

### Tự build nếu 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 lệnh `github-mcp-server stdio` với biến `GITHUB_PERSONAL_ACCESS_TOKEN` đã đặt. Có thể dùng cờ `-o` để chọn nơi lưu file. Sau đó cấu hình host 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
```

Bạn cần cài Go trước. README phần mình có không nêu phiên bản Go cụ thể; xem file `go.mod` trong repo để biết.

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

Với VS Code, README nói sau khi cài xong, bạn bật Agent mode (nằm cạnh ô nhập của Copilot Chat) thì server sẽ khởi động. Bạn nên mở danh sách công cụ của chat để xem có các công cụ GitHub xuất hiện không. Chi tiết cách hiển thị tuỳ host, README không mô tả màn hình cụ thể.

Cách thử nhanh nhất là hỏi thẳng AI một câu đọc được dữ liệu thật, ví dụ:

```
Liệt kê các issue đang mở trong repo của tôi
```

Nếu AI trả về danh sách thật từ GitHub, bạn đã cài thành công. Nếu trình duyệt bật lên để đăng nhập, cứ đăng nhập rồi hỏi lại.

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

Các tình huống dưới đây bám vào những gì README mô tả. Câu lệnh mẫu chỉ là gợi ý, bạn tự chỉnh theo repo của mình.

### Chủ shop có website do thuê dev làm

Bạn có một repo chứa website bán hàng, nhưng không đọc code. Hỏi AI:

```
Tóm tắt cấu trúc repo này và cho tôi biết các thay đổi gần đây nhất là gì
```

AI sẽ đọc repo và commit rồi trả lời bằng tiếng thường. Bạn nắm được dev đã làm gì mà không cần mở GitHub.

### Dev mới triage lỗi

Bạn vào team và phải xử lý đống issue tồn đọng. Nhờ AI:

```
Xem các issue đang mở, nhóm theo mức độ khẩn cấp và gợi ý issue nào nên làm trước
```

Kết quả là danh sách đã nhóm, bạn có thể bảo AI tạo hoặc cập nhật issue tiếp. Vì AI có quyền ghi, hãy đọc kỹ trước khi đồng ý các thao tác thay đổi.

> Thay vì lục từng tab GitHub, bạn chỉ cần hỏi và AI đi tìm giúp.
>
> — Ông T

### Tìm hiểu vì sao build hỏng

CI báo đỏ. Bạn hỏi:

```
Lần chạy workflow gần nhất bị lỗi, phân tích nguyên nhân giúp tôi
```

AI xem lần chạy GitHub Actions và đọc kết quả để chỉ ra bước nào hỏng. Bạn tiết kiệm thời gian cuộn qua log dài.

### Rà soát cảnh báo bảo mật

Người phụ trách kỹ thuật muốn nắm tình hình an toàn của dự án:

```
Cho tôi xem các cảnh báo Dependabot và cảnh báo bảo mật của repo này
```

AI lấy các cảnh báo về và tóm tắt. Bạn quyết định xử lý cái nào trước. Tính năng này tuỳ thuộc quyền token của bạn trên repo đó.

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

**Kéo ảnh Docker bị lỗi.** README nói ảnh là công khai, nên lỗi thường do token cũ hết hạn. Chạy `docker logout ghcr.io` rồi thử lại.

**Server không khởi động.** Với bản local, kiểm tra Docker đã bật chưa. Với VS Code, kiểm tra phiên bản từ 1.101 trở lên và đã bật Agent mode.

**OAuth không đăng nhập được ở host của bạn.** README nói mỗi host phải tự cấu hình app OAuth, mức hỗ trợ khác nhau. Cách an toàn là chuyển sang PAT với quyền tối thiểu.

**AI báo không đủ quyền hoặc không thấy repo.** Thường do token thiếu phạm vi quyền. README liệt kê ví dụ: `repo` cho thao tác repo, `read:packages` cho ảnh Docker, `read:org` cho team trong tổ chức. Cấp thêm đúng quyền thiếu, đừng cấp thừa.

**Dùng GitHub Enterprise Server không được với bản remote.** README nói bản remote không hỗ trợ GitHub Enterprise Server. Hãy dùng bản local với `GITHUB_HOST` trỏ tới domain của bạn (bắt buộc HTTPS).

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

**Điểm mạnh:** do chính GitHub làm, giấy phép MIT, repo còn được cập nhật trong vài tháng gần đây. Có bản remote cài rất nhanh, và cũng có bản local nếu bạn muốn tự kiểm soát. Hỗ trợ nhiều host phổ biến.

**Giới hạn:** bạn cần một host AI có hỗ trợ MCP. Cấu hình và độ ổn định khác nhau theo từng host, chính README cũng nói vậy. Bản remote không dùng cho GitHub Enterprise Server. Vì server có thể ghi (tạo issue, PR), bạn nên cấp token quyền tối thiểu và dùng token riêng cho từng dự án.

**Khi nào chọn cách khác:** nếu chỉ thỉnh thoảng cần xem code, mở thẳng GitHub trên trình duyệt là đủ. Nếu bạn không dùng công cụ AI nào hỗ trợ MCP, repo này chưa có ích cho bạn.

## 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 và có thể dùng tự do. Tuy nhiên README không nói gì về chi phí của host AI bạn dùng cùng (ví dụ gói Copilot hay Claude), nên phần đó chưa có thông tin trong tư liệu.

### Cần GPU không?

Tư liệu không nêu yêu cầu GPU. Server chỉ là cầu nối tới GitHub, nên bạn không cần phần cứng đặc biệt.

### Chạy được trên Windows không?

Repo có file giấy phép bên thứ ba riêng cho Windows, và bản Docker chạy được ở nơi có Docker. Còn lệnh export trong README là cú pháp bash, nên trên Windows bạn cần đặt biến môi trường theo cách của PowerShell; README chưa hướng dẫn riêng.

### Dùng bản remote hay bản local?

README nói bản remote do GitHub host là cách dễ nhất để bắt đầu. Nếu host của bạn không hỗ trợ remote server, hoặc bạn dùng GitHub Enterprise Server, hãy dùng bản local.

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

README khuyên cấp quyền tối thiểu, dùng token riêng cho từng dự án, đổi định kỳ và không commit token lên repo. Với OAuth ở bản local, token chỉ được giữ trong bộ nhớ.

### Dùng được với những công cụ AI nào?

README nêu VS Code, Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Zed, OpenCode, Copilot CLI, Gemini CLI và các IDE JetBrains, Visual Studio, Eclipse, Xcode có Copilot. Mức hỗ trợ khác nhau tuỳ host.

### Có dùng được với GitHub của công ty không?

Có. GitHub Enterprise Cloud (ghe.com) dùng được cả bản remote lẫn local. GitHub Enterprise Server chỉ dùng được bản local với GITHUB_HOST hoặc cờ --gh-host.
