Dành cho người dùng Claude Desktop

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

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ớ.

Bắt đầu miễn phí Đọc hướng dẫn cài đặt Claude Desktop

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

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.

// tệp cấu hình

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\.

// giao thức truyền tải

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.

// khóa

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.

// khởi động lại

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.

// workflow 01

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

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.

// workflow 02

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

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.

// step 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.

// step 02

Thêm Maguyva vào claude_desktop_config.json

claude_desktop_config.json

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

// step 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).