# Agent của Warp sống trong terminal. Hãy đưa nó bản đồ repo.

Canonical source: https://maguyva.ai/vi/for-warp

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

Agent của Warp chạy lệnh và đọc những gì lệnh in ra. Maguyva lập chỉ mục toàn bộ repo và trả về qua MCP, nên agent hỏi code nằm ở đâu thay vì chạy grep và cat cho tới khi có gì đó khớp.

> Một mục mcpServers trong ~/.warp/.mcp.json: một URL và một header Authorization.

## Những điều Warp cần biết

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

### ~/.warp/.mcp.json

Warp tự khởi động các máy chủ trong tệp toàn cục này. Bạn cũng có thể dán cùng JSON đó vào Settings → Agents → MCP servers → + Add.

### Từ xa, qua URL

Một mục `url` kết nối bằng Streamable HTTP hoặc SSE. Không có gì chạy cục bộ và không cần Node.js.

### Một header nguyên văn

Khóa đặt thẳng vào header `Authorization`. Giữ nó trong tệp toàn cục, không đặt trong `.warp/.mcp.json` của dự án mà bạn commit.

### Không bao giờ tự khởi động

Warp phát hiện `.warp/.mcp.json` trong repo đã clone nhưng đợi bạn tự khởi động từng máy chủ. Khi bạn bật tùy chọn, Warp cũng đọc được máy chủ từ cấu hình của Claude Code và Codex.

## Rules dự án là thỏa thuận làm việc. Hãy dùng chúng.

```text
# AGENTS.md
- Chạy make test trước khi coi một thay đổi là xong.
- Dùng script trong bin/, không dùng lệnh tùy hứng.
```

Warp đọc rules dự án từ `AGENTS.md` (hoặc `WARP.md`, được ưu tiên nếu có cả hai) và áp dụng Global Rules ở mọi nơi. Dùng chúng cho:

- Lệnh build, test và deploy.
- Quy ước mà agent cứ làm sai.
- Lệnh agent không bao giờ được chạy.

Rules cho agent biết cách làm việc. Chúng không thể cho biết dịch vụ nào vẫn đang đọc biến môi trường bạn sắp xóa.

## Nơi grep trong terminal kết thúc

Ba điều một phiên shell không học được với giá rẻ.

### // output trôi qua

Mỗi lệnh grep và cat agent chạy đều đổ vào cuộc trò chuyện. Một lần tìm in ra hai trăm dòng đã tiêu ngữ cảnh trước khi việc thật bắt đầu.

### // khớp không phải là hàm gọi

grep không phân biệt được lời gọi thật với comment, fixture hay phương thức trùng tên ở lớp khác.

### // shell khởi đầu từ con số không

Phiên mới không biết gì về repo. Chỉ mục của Maguyva đã dựng sẵn, nên câu hỏi đầu tiên đã có câu trả lời được xếp hạng.

## Maguyva làm máy chủ MCP trong Warp

Một mục mcpServers cho agent của Warp:

- **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ữ, đủ ngắn để đọc trong một khung terminal.
- **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 hay chạy lệnh.

> Warp cho agent *một terminal*.
> Maguyva cho agent *bản đồ của mã*.

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

Hỏi bản đồ trước, rồi mới chạy lệnh.

### 01. Lần theo một script lỗi tới tận nguồn

```text
warp agent> deploy.sh lỗi: BUILD_ID chưa được đặt. nó được đặt ở đâu?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← văn bản

→ Agent nạp ci/env.sh và chạy lại deploy.
[exit 0]
```

Một lần tìm có chỉ mục thay cho một lệnh grep đệ quy qua cả repo cùng toàn bộ output của nó.

### 02. Kiểm tra hàm gọi trước khi đổi một bước khởi động

```text
warp agent> mình có thể thôi chạy migration lúc khởi động không?

dependency_search("runMigrations", dependents)
  3 hàm gọi: server.ts, worker.ts, scripts/seed.ts

→ Agent chuyển cả ba sang bước release.
[exit 0]
```

Danh sách hàm gọi có trước thay đổi, nên worker không khởi động với schema cũ.

## Cài đặt trong Warp

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

`~/.warp/.mcp.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}
```

### 03. Thay placeholder và đặt một câu hỏi

Thay `mgv_xxxx` bằng khóa API của bạn rồi lưu. Kiểm tra trong Settings → Agents → MCP servers rằng máy chủ đang chạy, rồi hỏi một câu mà bạn đã biết câu trả lời.

[Tài liệu MCP](https://docs.warp.dev/agents/capabilities/mcp/) của Warp nói về máy chủ khai báo bằng tệp, chia sẻ và xác thực.

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

Kết nối Warp qua MCP, rồi hỏi một câu bạn có thể kiểm chứng.