# Maguyva

Các hướng dẫn ngắn cho quy trình Maguyva MCP phổ biến: cài đặt client, tìm kiếm trước khi chỉnh sửa, xử lý kết quả trống và làm việc trên nhiều repository.

[llms-full.txt — English documentation and MCP schemas](/llms-full.txt)

Markdown representation of any docs page or blog post: append `.md` to its URL (https://maguyva.ai/vi/docs/quickstart.md) or send `Accept: text/markdown`.

Release feeds: [RSS](https://maguyva.ai/vi/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/vi/changelog.json).

## Khả năng theo ngôn ngữ

Dưới đây là số liệu khả năng chi phối tìm kiếm cấu trúc, tra cứu ký hiệu, phân tích có nhận biết đồ thị, và lập chỉ mục cơ bản.

Các dấu chỉ báo này cho biết những khả năng được bật trong cấu hình ngôn ngữ hiện tại, không phải điểm đánh giá chất lượng từ đầu đến cuối. Để dùng được đồ thị, phải bật trình phân tích cú pháp, trích xuất ký hiệu và trích xuất đồ thị. Các loại quan hệ được hỗ trợ và độ sâu trích xuất khác nhau tùy ngôn ngữ.

- Phạm vi lập chỉ mục: **284**. Mọi ngôn ngữ được liệt kê đều được lập chỉ mục cho ngữ cảnh tệp, văn bản, và repository.
- Tìm kiếm cấu trúc AST: **247**. Các ngôn ngữ có cấu trúc dựa trên parser cho quy trình AST và tìm kiếm cấu trúc.
- Trích xuất ký hiệu: **282**. Các ngôn ngữ có siêu dữ liệu ký hiệu phục vụ định nghĩa và tra cứu.
- Quan hệ đồ thị: **151**. Các ngôn ngữ hỗ trợ trích xuất quan hệ ở mức vận hành cho tìm kiếm có nhận biết đồ thị. Độ sâu đồ thị thay đổi theo ngôn ngữ và loại quan hệ.

- `ast_structural=false`: Index ưu tiên văn bản với khả năng nhận biết cấu trúc hạn chế hơn.
- `symbol_extraction=false`: Trích xuất symbol bị giới hạn, nên việc điều hướng dựa nhiều hơn vào context file và cấu trúc.
- `relationship_extraction=false`: Ngôn ngữ này được index để tìm kiếm, nhưng hiện chưa được lưu bền vững vào code graph.

[Tìm ngôn ngữ bạn dùng](/llms-full.txt)

## Sổ tay công thức

Các hướng dẫn thực hành cho công việc Maguyva MCP hằng ngày. Mỗi hướng dẫn nêu rõ công cụ và trình tự sử dụng — không phải tài liệu tham chiếu đầy đủ về tham số. Xem tham số công cụ trong [Tham khảo MCP API](https://maguyva.ai/vi/docs/mcp-api). Nếu thiết lập lần đầu, hãy xem [Bắt đầu nhanh](https://maguyva.ai/vi/docs/quickstart).

### Chọn đúng công cụ

Hầu hết câu hỏi bắt đầu bằng một lần gọi công cụ. Chỉ chuyển sang bước chuyên sâu hơn khi câu trả lời đầu tiên quá rộng hoặc thiếu thông tin.

- `intelligent_search` — bắt đầu tại đây với câu hỏi về mã nguồn bằng ngôn ngữ tự nhiên. Chế độ mặc định auto/balanced chuyển các truy vấn được nhận diện chắc chắn là hỏi về định nghĩa sang tìm kiếm cấu trúc, truy vấn về tham chiếu hoặc tác động sang đồ thị, và truy vấn cần khớp chính xác sang tìm kiếm văn bản. Các truy vấn khác dùng ngữ nghĩa và văn bản đã lập chỉ mục. Dùng mode=hybrid hoặc auto với quality=thorough để yêu cầu cả bốn phương thức tìm kiếm; chế độ được chỉ định rõ có ưu tiên cao hơn quality.
- `find_symbol` - bạn đã biết hàm, lớp hoặc tên biến.
- `dependency_search` — phạm vi ảnh hưởng: các hàm gọi, thành phần phụ thuộc vào đoạn code này hoặc tác động trước (và sau) khi chỉnh sửa.
- `get_task_context` — khu vực chưa quen thuộc; một gói có giới hạn gồm tệp, symbol và quan hệ phụ thuộc ứng với mô tả nhiệm vụ.
- `repository_context` — liệt kê các repository có thể truy cập hoặc kiểm tra cách phân giải tên repository.
- `ask_maguyva` với `operation="guidance"` — trợ giúp cục bộ về lựa chọn công cụ và cách sử dụng Maguyva (không thay đổi repo).

## Tools -- Search

- [intelligent_search](https://maguyva.ai/vi/docs/mcp-api#intelligent-search): Start here for any codebase question. Default auto/balanced routes confident definition queries to structural search, reference/impact queries to graph, and exact-match queries to text; other queries use semantic plus text.
- [semantic_search](https://maguyva.ai/vi/docs/mcp-api#semantic-search): Find code by meaning, not exact text. Use for conceptual queries like "retry logic" or "user onboarding flow" when you don't know the keyword or symbol name.
- [text_pattern_search](https://maguyva.ai/vi/docs/mcp-api#text-pattern-search): Search indexed content. Exact and regex modes grep the full file/blob corpus; fuzzy content mode searches the bounded semantic chunk corpus.

## Tools -- Structural & Graph

- [structural_search](https://maguyva.ai/vi/docs/mcp-api#structural-search): Prefer preset=functions|classes|methods|imports|variables (or free pattern=). Find code by AST shape (not text).
- [dependency_search](https://maguyva.ai/vi/docs/mcp-api#dependency-search): Primary blast-radius / graph surface. Answer "what calls this?" / "what does this use?" via the real call/import graph.

## Tools -- Code Analysis

- [find_symbol](https://maguyva.ai/vi/docs/mcp-api#find-symbol): Jump to where a function, class, or variable is defined and used. Use when you know the name (e.g. "getCurrentUser") — faster and more precise than Grep, and it spans the whole indexed repo.
- [analyze_dependencies](https://maguyva.ai/vi/docs/mcp-api#analyze-dependencies): Analyze blast radius using the same traversal as dependency_search (dependents/incoming). Prefer dependency_search with analysis_type="dependents" or "impact" for impact analysis.
- [get_task_context](https://maguyva.ai/vi/docs/mcp-api#get-task-context): Starting work in an unfamiliar area? Describe the task (e.g. "add SSO support", "fix the billing webhook") and get a bounded one-call bundle of relevant files, code, symbols, and dependencies.
- [get_file](https://maguyva.ai/vi/docs/mcp-api#get-file): Read a file from the indexed repo by path. Prefer local file tools for files on disk; use this for remote indexed snapshots.

## Tools -- Utility

- [repository_context](https://maguyva.ai/vi/docs/mcp-api#repository-context): List the repositories you can search, or get identity info on one (namespace/branch, indexed_commit_sha / index freshness). Use action:"list" when the repo slug is unknown; searches accept a known slug directly or default to your key's single repo.
- [ask_maguyva](https://maguyva.ai/vi/docs/mcp-api#ask-maguyva): Get Maguyva tool guidance, or submit a bug report / feature request stored for Maguyva's maintainers. Never include secrets or sensitive personal data in feedback.

## Các bước tiếp theo

- [Bắt đầu nhanh](https://maguyva.ai/vi/docs/quickstart)
- [Hướng dẫn cài đặt](https://maguyva.ai/vi/docs/installation)
- [Tham khảo MCP API](https://maguyva.ai/vi/docs/mcp-api)
- [Khắc phục sự cố](https://maguyva.ai/vi/docs/troubleshooting)
- [Nó hoạt động như thế nào](https://maguyva.ai/vi/docs/how-it-works)
- [Khả năng tương thích & Thông số kỹ thuật](https://maguyva.ai/vi/docs/compatibility)

## Agent integrations

- [Maguyva cho Cursor: ngữ cảnh codebase qua MCP](https://maguyva.ai/vi/for-cursor): Cursor chỉnh sửa tệp đang mở; Maguyva lập chỉ mục toàn bộ monorepo và trả về qua MCP — tìm kiếm ngữ nghĩa, AST, đồ thị, và văn bản kèm file:line, để tác nhân tìm ra những tệp mà bạn chưa ghim.
- [Maguyva cho Windsurf: ngữ cảnh codebase qua MCP](https://maguyva.ai/vi/for-windsurf): Windsurf và Cascade chỉnh sửa tệp đang mở; Maguyva lập chỉ mục toàn bộ monorepo và trả về qua MCP — ngữ nghĩa, AST, đồ thị, và văn bản kèm file:line, để Cascade tìm ra những tệp mà bạn chưa nhắc tới.
- [Maguyva cho Antigravity: ngữ cảnh codebase qua MCP](https://maguyva.ai/vi/for-antigravity): Antigravity chạy các tác nhân tự động trên trình soạn thảo, terminal, và trình duyệt; Maguyva cho chúng một bản đồ có thể truy vấn của monorepo qua MCP — biết trước phạm vi ảnh hưởng, không phải sau khi CI báo đỏ.
- [Maguyva cho Codex: ngữ cảnh codebase qua MCP](https://maguyva.ai/vi/for-codex): AGENTS.md là thỏa thuận làm việc. Maguyva là máy chủ MCP cung cấp cho Codex CLI một bản đồ kho mã có thể truy vấn, để bản chỉnh sửa đầu tiên không phải là phỏng đoán.
- [Maguyva cho mọi MCP client: ngữ cảnh codebase qua MCP](https://maguyva.ai/vi/for-anything): MCP là một giao thức mở. Maguyva là một MCP server chuẩn, nên các client hỗ trợ MCP như Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity đều nhận được cùng một loại ngữ cảnh codebase có căn cứ thật.
- [Maguyva cho Gemini CLI: ngữ cảnh codebase qua MCP](https://maguyva.ai/vi/for-gemini): GEMINI.md thiết lập ngữ cảnh làm việc; MCP là kênh truyền tải. Maguyva là MCP server cho Gemini CLI một bản đồ có thể truy vấn của repo bạn — tìm kiếm ngữ nghĩa, AST, và đồ thị để lần chỉnh sửa đầu tiên không phải là một phỏng đoán.
- [Maguyva cho Claude Code: ngữ cảnh codebase qua MCP](https://maguyva.ai/vi/for-claude-code): CLAUDE.md cho Claude biết cách hành xử. Maguyva lập chỉ mục kho mã và cung cấp qua MCP để Claude Code chỉnh sửa dựa trên bản đồ có thể truy vấn.
- [Maguyva cho GitHub Copilot CLI: ngữ cảnh mã nguồn qua MCP](https://maguyva.ai/vi/for-copilot): Hướng dẫn tùy chỉnh cho Copilot biết cách hành xử. Maguyva lập chỉ mục kho mã và cung cấp qua MCP để GitHub Copilot CLI chỉnh sửa dựa trên bản đồ.

## Company

- [Giới thiệu về Maguyva: Trí tuệ mã nguồn qua MCP](https://maguyva.ai/vi/about): Trí tuệ mã nguồn cho các tác nhân lập trình: tìm kiếm ngữ nghĩa, AST, đồ thị và toàn văn, tra cứu ký hiệu, phân tích phụ thuộc, và ngữ cảnh tác vụ trong một lần gọi trên hơn 284 ngôn ngữ.
- [Gặp gỡ đội ngũ: 2 con người + bầy agent AI](https://maguyva.ai/vi/team)
- [Cách chúng tôi làm việc: Không VC, không tính giá theo seat, không khóa tính năng](https://maguyva.ai/vi/how): Không vốn bên ngoài. Không tính giá theo seat. Dữ liệu của bạn không phải là sản phẩm. Cách Maguyva được xây dựng và lý do vì sao nó được định giá như vậy.
- [Ngăn xếp công nghệ: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/vi/stack): Ngăn xếp kỹ thuật vận hành Maguyva. PostgreSQL, embedding Voyage AI, tìm kiếm vector lượng tử hóa, AST của tree-sitter, và giao thức MCP.
- [Nhật ký thay đổi](https://maguyva.ai/vi/changelog): Những gì đã được phát hành trong Maguyva: thay đổi sản phẩm, cập nhật chỉ mục và công cụ MCP, cùng ghi chú từ quá trình xây dựng. Mới nhất trước.
- [Live: Maguyva tự xây dựng chính mình, theo thời gian thực](https://maguyva.ai/vi/live): Không phải bản demo dàn dựng. Đây là nhật ký dispatch thực — từng lệnh gọi công cụ, sự cố và commit từ đội agent AI đang xây dựng Maguyva, trực tiếp.

## Guides

- [Không phải full-text search khoác áo choàng giả danh. Năm chế độ truy xuất hợp nhất.](https://maguyva.ai/vi/beyond-rag): Code cần nhiều hơn những chunk semantic đơn thuần. Maguyva hợp nhất năm chế độ truy xuất thành một câu trả lời được xếp hạng, neo vào repo thực qua MCP, trên 284 ngôn ngữ. Gói Free, không cần thẻ tín dụng.
- [File hướng dẫn không phải là bản đồ code của bạn. Maguyva mới là.](https://maguyva.ai/vi/beyond-rules-files): CLAUDE.md và AGENTS.md cho agent biết cách cư xử. Chúng không cho agent biết codebase có gì. Maguyva là lớp context codebase qua MCP, trên 284 ngôn ngữ. Gói Free, không cần thẻ tín dụng.
- [Sửa code thì dễ. Biết được điều gì sẽ hỏng mới khó. Maguyva vẽ bản đồ đó.](https://maguyva.ai/vi/know-what-breaks): Trước khi refactor, agent của bạn nên biết mọi hàm gọi, module import và thành phần phụ thuộc vào đoạn code đó. Maguyva trả lời từ call graph thật qua MCP, không phải từ một lượt grep. Gói Free, không cần thẻ tín dụng.
- [Bắt đầu miễn phí: lớp context codebase cho các agent lập trình AI](https://maguyva.ai/vi/map-then-change): Vẽ bản đồ trước. Sửa code sau. Maguyva cho agent lập trình AI của bạn một bản đồ codebase có thể truy vấn qua MCP, trước khi có bất kỳ chỉnh sửa nào. 11 công cụ, trên 284 ngôn ngữ. Gói Free, không cần thẻ tín dụng.
- [Agent của bạn bắt đầu mù thông tin trên repo của bạn. Maguyva cho nó một bản đồ.](https://maguyva.ai/vi/stop-flying-blind): Các agent lập trình quét nhầm file và chỉnh sửa trước khi hiểu được code. Maguyva cho agent của bạn một bản đồ codebase có thể truy vấn qua MCP, trên 284 ngôn ngữ. Gói Free, không cần thẻ tín dụng.