MCP servers và Knowledge Base: mở rộng agent Antigravity

TL;DR: MCP (Model Context Protocol) là chuẩn mở giúp agent kết nối an toàn tới tool local, database và API ngoài. Trong Antigravity, bạn thêm mcp servers antigravity qua Settings → Installed MCP Servers → Add MCP (nối vào MCP Store), hoặc khai báo file mcp_config.json trong ~/.gemini/config để IDE và CLI dùng chung. Cộng thêm Knowledge Base — bộ nhớ dài hạn của agent — bạn có một trợ lý càng dùng càng "hiểu ý". Đây là bài 9 trong series 10 phần.

Ở bài 8 về Rules, Workflows và Skills, mình đã dạy agent cách làm việc theo chuẩn của mình. Nhưng dạy cách làm thôi chưa đủ — agent còn cần thông tin đúng và quyền hành động. Nó cần đọc schema database thật thay vì đoán, cần bám tài liệu SDK bản mới thay vì kiến thức cũ trong model. Đó chính là chỗ của mcp servers antigravity: cắm thêm "tay chân" và "giác quan" cho agent. Bài này mình đi qua khái niệm MCP, hai cách cấu hình trong Antigravity, các use case đáng dùng ngay, và vai trò của Knowledge Base.

MCP là gì và vì sao agent cần nó

MCP — viết đầy đủ là Model Context Protocol — là một chuẩn mở cho phép agent và editor AI kết nối an toàn tới công cụ local của lập trình viên, database, trình phân tích file và API từ xa. Thay vì mỗi công cụ AI tự chế một kiểu tích hợp riêng, MCP chuẩn hoá cách agent "nói chuyện" với thế giới bên ngoài: server cung cấp tool và dữ liệu, agent gọi qua giao thức thống nhất.

Với Antigravity, MCP giải quyết hai việc cụ thể:

• Lấy ngữ cảnh có cấu trúc: agent đọc trực tiếp schema database, tài liệu API, nội dung ticket… thay vì bắt bạn copy-paste vào prompt.
• Thực thi hành động an toàn thay bạn: chạy truy vấn, tạo issue, gọi API nội bộ — trong phạm vi quyền mà server cho phép.

Không có MCP, agent giống người mới vào công ty bị ngắt mạng: thông minh nhưng mù thông tin. Có MCP, nó bắt đầu làm việc với dữ liệu thật của bạn. Tài liệu chính thức về phần này nằm tại antigravity.google/docs/mcp.

Hai cách cấu hình MCP servers Antigravity

Theo tài liệu công bố, có hai đường để cấu hình — một cho người thích bấm nút, một cho người thích file config. Cả hai cho kết quả như nhau: agent nhìn thấy danh sách tool mà server cung cấp và tự quyết định gọi tool nào khi task cần. Bạn không phải "dạy" agent cách gọi — chỉ cần cắm server đúng chỗ.

Cách 1: qua Settings và MCP Store

Đây là đường nhanh nhất cho người mới:

1. Mở Settings trong Antigravity (biểu tượng bánh răng — với cấu hình theo project, bạn đã gặp nó ở bài làm quen giao diện Editor và Agent Manager).
2. Tìm mục Installed MCP Servers.
3. Bấm Add MCP — Antigravity nối bạn tới MCP Store, nơi liệt kê các server có sẵn.
4. Chọn server cần dùng, cấp thông tin xác thực nếu server yêu cầu (API key, đường dẫn…).

Ưu điểm là không phải viết JSON, và store giúp bạn khám phá server phổ biến. Nhược điểm là cấu hình gắn với thao tác tay từng máy.

Cách 2: file mcp_config.json dùng chung IDE và CLI

Nếu bạn dùng cả Antigravity IDE lẫn Antigravity CLI (agy) như mình, khai báo bằng file sẽ sạch hơn: tạo file mcp_config.json đặt trong thư mục ~/.gemini/config. Cấu hình đặt ở đây được chia sẻ giữa các công cụ Antigravity trên máy — viết một lần, IDE và CLI cùng đọc.

Dạng khai báo quen thuộc của một MCP server trong file config nhìn kiểu như sau (tên server và lệnh chạy tuỳ server bạn chọn):

{
  "mcpServers": {
    "my-docs": {
      "command": "npx",
      "args": ["-y", "ten-mcp-server-tai-lieu"]
    }
  }
}

Mẹo của mình: coi file này như dotfile — đưa vào bộ backup cấu hình cá nhân, còn cấu hình đặc thù dự án (và nhạy cảm) thì khai báo ở phạm vi project qua Settings của từng project thay vì file global.

Use case đáng cắm ngay: docs, database và hơn thế

Danh sách MCP server ngoài kia rất dài, nhưng theo tìm hiểu của mình, hai nhóm dưới đây đáng dùng sớm nhất:

1. MCP server tài liệu SDK/framework. Model nào cũng có ngày cắt kiến thức; framework thì cập nhật hằng tháng. Server tài liệu giúp agent tra cứu docs bản mới trước khi sinh code, giảm hẳn cảnh agent tự tin viết API đã bị deprecated. Với người viết code bằng tiếng Việt và hay làm việc với thư viện mới, đây là nâng cấp cảm nhận được ngay.

2. MCP server database. Cho phép agent đọc schema thật: bảng nào có cột gì, kiểu dữ liệu ra sao. Khi mình nhờ agent viết migration hay truy vấn tổng hợp, nó không còn "đoán" tên cột nữa — nó nhìn schema rồi viết. Đi kèm nguyên tắc: cấp quyền read-only cho server database trừ khi bạn thật sự cần agent ghi dữ liệu.

Ngoài ra còn server cho hệ thống ticket, search nội bộ, trình đọc PDF… Nguyên tắc chọn: bắt đầu từ nỗi đau lặp lại nhiều nhất của bạn (phải copy-paste thứ gì vào prompt thường xuyên nhất thì cắm server cho thứ đó trước).

Knowledge Base: bộ nhớ dài hạn giúp agent càng dùng càng hiểu ý

MCP mở rộng không gian, còn Knowledge Base mở rộng thời gian. Theo tài liệu công bố, agent trong Antigravity duy trì một Knowledge Base bền vững: ghi nhớ snippet đã chạy tốt, pattern kiến trúc, và sở thích của bạn từ các task trước.

Trên thực tế điều đó nghĩa là gì? Vài ví dụ dễ thấy:

• Bạn từng chốt "dự án này dùng kiến trúc ba lớp, đặt validation ở tầng service" — task sau agent tự áp pattern đó mà không cần nhắc.
• Snippet xử lý ngày giờ theo múi giờ Việt Nam từng được duyệt — lần sau gặp bài toán tương tự, agent ưu tiên dùng lại thay vì sáng tác mới.
• Bạn hay từ chối code dùng thư viện X — agent dần tránh đề xuất nó.

Knowledge Base khác Skills (bài 8) ở chỗ: Skills do bạn viết chủ động, Knowledge Base do agent tích luỹ từ quá trình làm việc. Hai thứ bổ trợ nhau — quy ước quan trọng vẫn nên chốt thành skill/rule cho chắc, còn Knowledge Base lo phần "kinh nghiệm mềm" khó viết ra hết.

Mẹo nhỏ: thỉnh thoảng review lại những gì agent đã "học". Nếu nó nhớ một quyết định đã lỗi thời (ví dụ pattern cũ trước khi bạn refactor), hãy nói rõ để nó cập nhật — bộ nhớ sai còn phiền hơn không có bộ nhớ.

Bảo mật khi bật MCP: quyền lực đi kèm trách nhiệm

Phần này mình viết kỹ vì nó dễ bị bỏ qua. MCP server không phải plugin hiển thị giao diện — nó là cánh tay nối dài của agent, đọc được dữ liệu và thực thi được hành động. Vài nguyên tắc mình tự đặt:

• Chỉ cài server tin cậy. Ưu tiên server chính chủ (từ nhà cung cấp dịch vụ đó) hoặc mã nguồn mở xem được code. Server lạ trên internet thì đọc code trước khi cắm.
• Review quyền nó yêu cầu. Server database chỉ cần đọc thì đừng cấp tài khoản ghi; server nào đòi token quyền rộng bất thường là dấu hiệu nên dừng.
• Tách cấu hình theo project. Dữ liệu nhạy cảm (production, tài chính) nên gói trong cấu hình project riêng với security preset chặt, đừng thả vào config global mọi agent đều với tới.
• Đừng dán secret vào prompt. Thông tin xác thực đi qua cấu hình server (biến môi trường, trường config), không đi qua hội thoại.
• Nhớ mình chịu trách nhiệm cuối. Agent gọi tool thay bạn, nhưng hành động phát sinh vẫn là của bạn — giữ thói quen review trước khi cho agent chạy thao tác ghi/xoá, giống tinh thần review Artifacts mình nói ở bài 5.

Nghe hơi "cảnh sát" nhưng chỉ cần vài phút cân nhắc lúc cài, đổi lại bạn dùng MCP thoải mái về sau.

Kết: agent có tay chân, có trí nhớ

Tới đây, bức tranh đã khá đầy: Rules/Workflows/Skills dạy agent cách làm, mcp servers antigravity cho agent kết nối dữ liệu và công cụ thật, Knowledge Base giúp nó nhớ những gì hai bạn đã thống nhất. Một agent như vậy không còn là hộp chat sinh code nữa — nó là đồng nghiệp có ngữ cảnh, có trí nhớ và có quyền hạn được kiểm soát. Bạn có thể xem thêm các bài cùng chủ đề tại chuyên mục Công nghệ và trang tổng hợp series của blog.

Bài cuối của series: ghép tất cả lại thành quy trình làm việc thật — nhiều agent chạy song song, chọn model, hiểu quota và bộ best practices đúc kết. Đọc tiếp bài 10: Làm chủ Antigravity — multi-agent, quota và best practices.