Dành cho người dùng VS Code

Copilot thấy workspace của bạn. Maguyva vẽ bản đồ repo.

Agent trong VS Code đọc các tệp bạn đính kèm và các tệp nó tự tìm được. Maguyva lập chỉ mục toàn bộ repo và trả về qua MCP, nên trước khi sửa, agent hỏi một symbol nằm ở đâu và ai gọi nó.

Bắt đầu miễn phí Xem cách thiết lập VS Code

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

Một mục servers trong .vscode/mcp.json: một URL và một header Authorization.

Những điều VS Code cần biết

Bốn điều riêng của VS Code.

// tệp cấu hình

.vscode/mcp.json

Máy chủ nằm dưới servers, không phải mcpServers. Để dùng cho mọi workspace, chạy MCP: Open User Configuration và thêm cùng mục đó vào mcp.json của profile.

// kênh truyền tải

type: http

VS Code kết nối tới endpoint của Maguyva bằng Streamable HTTP và chỉ chuyển sang SSE khi máy chủ không hỗ trợ. Không có gì chạy cục bộ.

// khóa

Tham chiếu biến môi trường

Header là Bearer ${env:MAGUYVA_API_KEY}, được VS Code lấy từ môi trường lúc nó khởi động, nên khóa không nằm trong tệp bạn commit. Muốn được hỏi thay vào đó? Một biến nhập (input variable) sẽ hỏi một lần và lưu khóa lại.

// tin cậy

Workspace Trust

Máy chủ trong .vscode/mcp.json khởi động mà không cần hỏi riêng khi bạn đã tin cậy workspace, và không bao giờ chạy ở chế độ hạn chế. Configure Tools trong ô nhập chat bật hoặc tắt từng công cụ.

Hướng dẫn tùy chỉnh là một thỏa thuận làm việc. Hãy sử dụng chúng.

# .github/copilot-instructions.md
- Chạy npm test trước khi coi một thay đổi là xong.
- Không bao giờ sửa tệp được sinh ra trong src/gen/.

VS Code đọc chỉ dẫn cho cả dự án từ .github/copilot-instructions.md hoặc AGENTS.md, và chỉ dẫn có phạm vi từ các tệp .github/instructions/*.instructions.md có mẫu applyTo. Dùng chúng cho:

Lệnh build, test và lint.
Quy ước mà agent cứ làm sai.
Thư mục agent không được động vào.

Chỉ dẫn cho agent biết cách làm việc. Chúng không thể cho biết tệp nào trong bốn nghìn tệp đang import kiểu dữ liệu nó sắp đổi tên.

Nơi tầm nhìn của workspace kết thúc

Ba điều agent không học được từ các tệp đang mở.

// đính kèm không phải là tất cả

Agent làm việc với những gì bạn đính kèm và những gì kết quả tìm kiếm trả về. Hàm gọi ở package khác bị hỏng sau thay đổi không nằm trong danh sách nào cả.

// khớp chuỗi không phải là tham chiếu

Tìm kiếm workspace tìm thấy chuỗi. Nó không phân biệt được lời gọi thật với comment, mock hay phương thức trùng tên ở lớp khác.

// mỗi lần đọc tốn ngữ cảnh

Mỗi tệp agent mở để định hướng đều ngốn ngữ cảnh nó cần cho thay đổi. Một câu trả lời đã xếp hạng kèm file:line rẻ hơn mười lần đọc thăm dò.

Maguyva làm máy chủ MCP trong VS Code

Một mục servers cho agent:

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 agent mở đúng tệp ngay từ đầu.
Công cụ chỉ đọc Công cụ của Maguyva chỉ truy vấn chỉ mục. Không công cụ nào sửa tệp của bạn, nên mỗi lần phê duyệt là cho việc đọc, không phải ghi.

VS Code cho agent workspace của bạn.
Maguyva cho agent bản đồ của repo.

Hai quy trình làm việc

Hỏi bản đồ trước, rồi mới sửa.

// workflow 01

Tìm test trước khi sửa parser

vscode agent> test nào chạy qua parseConfig?

dependency_search("parseConfig", dependents)
  tests/config/parse.test.ts:12
  tests/cli/flags.test.ts:88

→ Sau khi sửa, agent chạy hai tệp này chứ không chạy cả bộ test.
[exit 0]

Câu trả lời chỉ ra hai tệp test chạm tới parser, nên agent kiểm tra thay đổi ở đúng chỗ nó có thể hỏng.

// workflow 02

Ước lượng việc đổi tên trước lần sửa đầu tiên

vscode agent> đổi tên OrderStatus.PENDING thành OrderStatus.QUEUED

find_symbol("OrderStatus", references)
  23 tham chiếu trong 9 tệp

→ Agent lên kế hoạch một lượt qua chín tệp.
[exit 0]

Số tham chiếu có trước khi sửa, không phải sau khi trình kiểm tra kiểu báo lỗi.

Cài đặt trong VS Code

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 .vscode/mcp.json

.vscode/mcp.json

{
  "servers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

// step 03

Đặt khóa và khởi động máy chủ

Đặt MAGUYVA_API_KEY trong môi trường bạn dùng để mở VS Code, rồi khởi động máy chủ từ code lens phía trên mục của nó. Hỏi agent một câu mà bạn đã biết câu trả lời.