// tệp cấu hình
~/.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.
Dành cho người dùng Warp
Agent của Warp sống trong terminal. Hãy đưa nó bản đồ repo.
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.
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 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.
// kênh truyền tải
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.
// khóa
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.
// tệp dự án
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.
# 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.
// workflow 01
Lần theo một script lỗi tới tận nguồn
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ó.
// workflow 02
Kiểm tra hàm gọi trước khi đổi một bước khởi động
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.
-
// 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 ~/.warp/.mcp.json
~/.warp/.mcp.json{ "mcpServers": { "maguyva": { "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer mgv_xxxx" } } } } -
// step 03
Thay placeholder và đặt một câu hỏi
Thay
mgv_xxxxbằ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.