# Claude Desktop không nhìn thấy repo của bạn. Hãy cho nó một repo.

Canonical source: https://maguyva.ai/vi/for-claude-desktop

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Claude Desktop là nơi nhiều người hỏi về mã mà họ không đang sửa: review, onboarding, cuộc gọi xử lý sự cố. Maguyva lập chỉ mục repo và phục vụ qua MCP, nên câu trả lời dẫn chiếu tệp và dòng thay vì trí nhớ.

> Không cần checkout. Hãy hỏi chỉ mục.

## Những điều cần biết về Claude Desktop

Bốn điều riêng của Claude Desktop.

### claude_desktop_config.json

Mở bằng Settings → Developer → Edit Config. Trên macOS tệp nằm trong `~/Library/Application Support/Claude/`; trên Windows, trong `%APPDATA%\Claude\`.

### Cầu nối cục bộ

Tệp này khởi chạy tiến trình cục bộ, nên hướng dẫn này chạy `@maguyva/mcp` qua `npx`. Cần cài Node.js.

### Một mục env

Cầu nối đọc `MAGUYVA_API_KEY` từ khối `env` của server trong cùng tệp.

### Thoát, rồi mở lại

Claude Desktop đọc tệp khi khởi động. Thoát hẳn ứng dụng sau khi sửa; server sẽ chạy ở lần mở tiếp theo.

## Chỉ dẫn dự án đặt khung cho cuộc trò chuyện. Cứ dùng nó.

Claude Projects lưu chỉ dẫn và tệp mà mọi cuộc chat trong dự án đều bắt đầu cùng. Đây là nơi phù hợp cho:

- Câu trả lời dành cho ai: người review, nhân viên mới, kỹ sư trực sự cố.
- Văn phong nội bộ cho phần giải thích và tóm tắt.
- Một vài tài liệu bạn muốn được trích dẫn, như bản tổng quan kiến trúc.

Tệp đã tải lên là một bản chụp. Một ngày sau khi bạn tải lên, repo đã thay đổi.

## Khi mã dán vào không còn đủ

Ba cách một cuộc trò chuyện về mã đi sai hướng khi không có mã.

### // đoạn mã dán vào bị cũ

Một tệp được dán vào chat tuần trước mô tả mã của tuần trước. Claude tự tin trả lời dựa trên phiên bản được đưa cho nó.

### // đoạn mã không phải là cả hệ thống

Một tệp hiếm khi trả lời được “chuyện gì xảy ra khi cái này lỗi?” Handler, retry và cảnh báo thường nằm ở ba package khác nhau.

### // không checkout, không grep

Claude Desktop không có bản làm việc của repo. Không có công cụ, mọi câu trả lời về cấu trúc phụ thuộc vào những gì bạn nhớ để dán vào.

## Maguyva làm MCP server trong Claude Desktop

Một mục mcpServers mang lại cho Claude:

- **11 công cụ trên repo đã lập chỉ mục của bạn**: tìm kiếm ngữ nghĩa, cấu trúc (AST), đồ thị và văn bản, cùng tra cứu ký hiệu, thành phần phụ thuộc và truy xuất tệp.
- **Câu trả lời kèm đường dẫn tệp và số dòng**: trên 285+ ngôn ngữ, nên bạn có thể kiểm tra mọi khẳng định.
- **Kết quả nhận biết nhánh**: để Claude trả lời về nhánh bạn chỉ định, không phải một tệp ai đó tải lên tháng trước.

> Chỉ dẫn dự án cho Claude biết *cách trả lời*.
> Maguyva cho Claude *mã để dựa vào khi trả lời*.

## Hai quy trình làm việc

Những câu hỏi mà bình thường bạn phải mở IDE mới trả lời được.

### 01. Giải thích một luồng mã khi review

```text
claude> chuyện gì xảy ra sau khi webhook thanh toán không qua bước kiểm tra chữ ký?

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Claude trả lời và trích dẫn cả hai dòng.
[exit 0]
```

Mỗi bước của câu trả lời trỏ tới một tệp và một dòng bạn mở được.

### 02. Ước lượng quy mô thay đổi trước khi lên kế hoạch

```text
claude> có bao nhiêu chỗ đọc trường cũ plan_code?

text_pattern_search("plan_code")
  14 kết quả trong 9 tệp
dependency_search("getPlanCode", dependents)
  6 nơi gọi

→ Ước lượng bắt đầu từ một con số, không phải phỏng đoán.
[exit 0]
```

Hữu ích trong buổi họp lập kế hoạch, khi không ai mở repo.

## Cài đặt trong Claude Desktop

Ba bước. Gói Free: 3 repository, Tối đa 50K dòng repo đã index, không cần thẻ tín dụng.

### 01. Lập chỉ mục một repo tại maguyva.ai

Chọn một repo bạn đã biết, để bạn có thể đánh giá các câu trả lời.

### 02. Thêm Maguyva vào claude_desktop_config.json

`claude_desktop_config.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}
```

### 03. Thay placeholder, khởi động lại và đặt một câu hỏi

Thay `mgv_xxxx` bằng khóa API của bạn, thoát hẳn Claude Desktop rồi mở lại. Nếu server không xuất hiện, hãy đọc `mcp-server-maguyva.log` trong thư mục log của Claude (`~/Library/Logs/Claude` trên macOS).

[Hướng dẫn MCP về server cục bộ](https://modelcontextprotocol.io/docs/develop/connect-local-servers) trình bày chi tiết hơn về tệp cấu hình và log của nó.

## Lập chỉ mục một repo mà bạn đã biết rõ.

Kết nối Claude Desktop qua MCP, rồi đặt một câu hỏi bạn có thể kiểm tra.