MCP và skill trong Antigravity: nối tác tử với công cụ ngoài

MCP trong Antigravity là gì? MCP (Model Context Protocol) trong Antigravity là cách nối tác tử của Google Antigravity với công cụ ngoài như cơ sở dữ liệu, GitHub, Figma hay API riêng, để tác tử đọc dữ liệu thật và gọi hành động thay vì chờ người dán thông tin vào khung chat. Đi cùng MCP là skill (thư mục chứa SKILL.md hướng dẫn tác tử làm một việc) và plugin (gói gộp skill, MCP, tác tử con, rule và hook). Bài không hứa tiện ích nào an toàn hay hiệu quả; chúng tôi chưa kiểm tra mã của plugin nào trong Marketplace, và chỉ mô tả những gì tài liệu chính thức cùng agy --help bản 1.4.12 ghi, đọc ngày 03/11/2026. Bài đi qua cách thêm MCP server, skill, plugin, hook, rủi ro và so sánh với Claude Code, Codex. Phần giới thiệu chung có ở bài Antigravity là gì?.

Ba lớp mở rộng tác tử trong Antigravity: MCP, skill và plugin, đặt dưới lớp quyền. Sơ đồ: OPCAIOS.

MCP, skill và plugin trong Antigravity khác nhau thế nào?

MCP, skill và plugin là ba lớp mở rộng khác nhau của tác tử Antigravity, theo các trang /docs/mcp, /docs/skills và /docs/plugins (đọc ngày 03/11/2026). MCP cho tác tử thêm công cụ và dữ liệu: một MCP server là chương trình chạy cục bộ (stdio) hoặc dịch vụ từ xa, công bố các công cụ để tác tử gọi. Skill cho tác tử thêm cách làm: một thư mục có SKILL.md chứa quy trình, danh sách kiểm tra, có thể kèm script; tác tử chỉ thấy tên và mô tả cho đến khi cần mới đọc toàn bộ. Plugin là cách đóng gói và phân phối: một thư mục có plugin.json, gộp skill, MCP server, tác tử con, rule và hook, cài bằng một lệnh và bật tắt cùng nhau. Nếu mới làm quen, xem MCP là gì?.

Lớp	Thêm cho tác tử	Tệp chính
MCP server	Công cụ, dữ liệu ngoài	mcp_config.json
Skill	Quy trình, kiến thức	SKILL.md
Plugin	Gói gộp nhiều thành phần	plugin.json

Thêm MCP server trong ứng dụng Antigravity như thế nào?

Thêm MCP server trong ứng dụng Antigravity đi qua MCP Store tích hợp sẵn, theo trang /docs/mcp (đọc ngày 03/11/2026):

1. Bấm Settings ở góc dưới bên trái.
2. Chọn Customizations, xem mục Installed MCP Servers.
3. Bấm Add MCP để mở MCP Store.
4. Tìm server, bấm Add, đăng nhập nếu được hỏi.

Store chia theo nhóm như cơ sở dữ liệu (Supabase, Neon, BigQuery), công cụ phát triển (GitHub, Linear, Vercel) và thiết kế (Figma, Canva). Server không có trong Store thì sửa trực tiếp mcp_config.json; Antigravity IDE có Store tương tự.

Thêm MCP server bằng agy mcp add ra sao?

Thêm MCP server bằng Antigravity CLI có hai cách: mở trình quản lý bằng /mcp trong giao diện tương tác, hoặc dùng agy mcp từ shell, theo agy mcp add --help bản 1.4.12 (đọc ngày 03/11/2026). Cú pháp là tên server, rồi lệnh chạy (server stdio) hoặc URL (server http), rồi tham số. Cờ --env (-e) truyền biến môi trường, --header (-H) thêm header HTTP, --type (-t) chọn stdio hoặc http; URL http, https được tự nhận nên thường không cần --type. Lưu ý: cờ phải đứng trước tên server, và dùng -- trước lệnh nếu lệnh bắt đầu bằng dấu gạch. Lệnh con khác gồm list, remove, enable, disable. Theo trang /docs/mcp, CLI đọc server từ một tệp toàn cục cho mọi dự án và từ .agents/mcp_config.json của workspace; plugin đang bật cũng thêm được server. Ví dụ lấy nguyên từ phần trợ giúp:

agy mcp add fs npx -y @modelcontextprotocol/server-filesystem /work
agy mcp list

Cấu hình mcp_config.json cần chú ý gì?

Tệp mcp_config.json của Antigravity dùng chung một cấu trúc cho ứng dụng, IDE, CLI và plugin: gốc là đối tượng mcpServers, mỗi khoá là tên một server, theo trang /docs/mcp (đọc ngày 03/11/2026). Mỗi server có đúng một kiểu kết nối: command cho server stdio hoặc serverUrl cho server từ xa. Server từ xa phải dùng Streamable HTTP; kiểu HTTP+SSE cũ và khoá httpUrl không còn được hỗ trợ. Các khoá tuỳ chọn đáng dùng:

1. enabledTools, disabledTools: chỉ cho tác tử thấy một số công cụ, giảm rủi ro và giảm ngữ cảnh.
2. disabled: tạm tắt server mà không xoá cấu hình.
3. timeoutSeconds: mặc định chờ kết nối 5 phút, mỗi lần gọi công cụ 3 phút; giá trị âm tắt giới hạn.
4. headers, oauth, authProviderType: xác thực bằng header, OAuth hoặc thông tin đăng nhập Google Cloud.

Về quyền, công cụ MCP chưa cấu hình mặc định ở chế độ hỏi. Có thể cho phép theo ba mức: mcp(server/tool), mcp(server/*) và mcp(*). Cách an toàn là chỉ cho phép công cụ chỉ đọc, giữ chế độ hỏi cho công cụ ghi hoặc xoá. Khoá API trong headers nằm dạng chữ thường, nên không đưa tệp này vào kho mã công khai. Xem thêm chế độ an toàn trong Antigravity.

Skill trong Antigravity hoạt động thế nào?

Skill trong Antigravity là một thư mục chứa SKILL.md bắt buộc, có thể kèm scripts/, examples/, resources/, theo trang /docs/skills (đọc ngày 03/11/2026). Frontmatter YAML có description bắt buộc và name tuỳ chọn. Skill nạp theo kiểu tiết lộ dần: mỗi lượt, tác tử chỉ thấy tên và mô tả của mọi skill; khi một skill khớp yêu cầu, tác tử mới đọc toàn bộ SKILL.md rồi làm theo. Vì vậy mô tả cần rõ từ khoá. Skill cấp workspace đặt ở .agents/skills/, skill toàn cục dùng chung giữa ứng dụng và CLI. Trong CLI, mỗi skill tự thành một lệnh gạch chéo, ví dụ skill deploy-staging cho lệnh /deploy-staging; thêm skill khi CLI đang chạy thì gõ /skills reload. Theo trang /docs/migration/workflows-to-skills, workflow cũ ngừng hoạt động từ 19/10/2026 và lệnh /migrate-workflows giúp chuyển sang skill; Antigravity theo chuẩn Agent Skills mở từ tháng 5/2026, nên skill đúng chuẩn dùng lại được ở công cụ khác.

Plugin và Plugin Marketplace là gì?

Plugin trong Antigravity là gói có phiên bản gộp năm loại thành phần: skill, MCP server, tác tử tuỳ chỉnh và tác tử con, rule, hook, theo trang /docs/plugins (đọc ngày 03/11/2026). Plugin Marketplace là danh mục plugin của Google và đối tác, công bố trên blog Antigravity ngày 29/10/2026, dùng được trong ứng dụng và CLI. Trong ứng dụng, mở Customizations rồi Marketplace; trong CLI, gõ /plugin. Plugin cài ở ứng dụng tự đồng bộ sang CLI. Từ shell, theo agy plugin --help:

Lệnh	Việc
agy plugin install <tên>	Cài từ Marketplace chính thức, URL GitHub hoặc thư mục cục bộ
agy plugin import gemini hoặc claude	Nhập extension Gemini CLI hoặc plugin Claude Code
agy plugin list --json	Liệt kê plugin, thành phần, đường dẫn
agy plugin validate --strict	Kiểm tra manifest và tệp

Công cụ MCP của plugin được đặt tên dạng <plugin>_<server>. Plugin cần khoá API được cài ở trạng thái tắt đến khi điền khoá.

Hook trong Antigravity dùng để làm gì?

Hook trong Antigravity là lệnh shell chạy ở mốc cố định của vòng lặp tác tử, khai báo trong hooks.json ở workspace, cấp toàn cục hoặc trong plugin, theo trang /docs/hooks (đọc ngày 03/11/2026). Có sáu sự kiện: SessionStart, PreToolUse, PostToolUse, PreInvocation, PostInvocation và Stop. Hook PreToolUse trả về trường decision như allow, deny (chặn ngay), ask, force_ask, và có thể sửa tham số trước khi công cụ chạy. Đây là chỗ đặt lưới an toàn cho MCP; ví dụ giả định, một hook chặn mọi lệnh xoá trên thư mục dữ liệu. Trong CLI, /hooks liệt kê hook đang hoạt động.

Rủi ro khi cài MCP, skill và plugin lạ là gì?

Rủi ro lớn nhất của tiện ích lạ là chúng chạy với quyền của chính tác tử trên máy bạn. Đây là phân tích của OPCAIOS từ cách tài liệu mô tả cơ chế, không phải cảnh báo trích từ Google:

1. Hook trong plugin chạy tự động khi plugin bật, tức plugin có thể chạy lệnh shell mà tác tử không gọi.
2. MCP server stdio là chương trình cục bộ: cài từ gói lạ giống cài phần mềm lạ.
3. SKILL.md là chỉ dẫn cho tác tử: một skill độc có thể dặn tác tử gửi dữ liệu ra ngoài.
4. Dữ liệu qua MCP có thể chứa lệnh nhúng nhắm vào tác tử (tiêm lệnh).

Cách giảm rủi ro: ưu tiên plugin chính thức, đọc hooks.json và SKILL.md trước khi cài từ GitHub, giới hạn công cụ bằng enabledTools và dùng khoá phạm vi hẹp. Xem bảo mật khi dùng AI viết code.

Antigravity so với Claude Code và Codex thế nào?

Cả ba công cụ đều có lệnh quản lý MCP và plugin, khác ở cú pháp và nơi lưu, theo phần trợ giúp CLI trên máy chúng tôi (Antigravity CLI 1.4.12, Claude Code 2.1.317, Codex CLI 0.162.1, ngày 03/11/2026):

Việc	Antigravity CLI	Claude Code	Codex CLI
Thêm MCP	agy mcp add	claude mcp add	codex mcp add
Tệp cấu hình	mcp_config.json	Cấu hình riêng của Claude Code	config.toml
Plugin	agy plugin	claude plugin	codex plugin (có quản lý marketplace)
Nhập từ công cụ khác	agy plugin import gemini/claude	claude mcp add-from-claude-desktop	Chưa thấy trong trợ giúp

Chi tiết phía Codex có ở bài MCP, skill và hooks trong Codex.

Kinh nghiệm của OPCAIOS

Ứng dụng Antigravity trên máy Mac chính của OPCAIOS khai báo 14 MCP server; CLI agy 1.4.12 có một skill trình duyệt cài thêm, và thư mục skill cấp người dùng có một skill điều phối cho công cụ quản lý terminal chúng tôi dùng. Hook có ở các mốc trước, sau tác tử và trước, sau công cụ, nhưng chỉ để báo trạng thái phiên; chúng tôi chưa có hook chặn lệnh. Có đúng một tệp workflow toàn cục nhưng là mẫu trống, chưa dùng thật. Lệnh agy plugin list ngày 03/11/2026 cho thấy CLI có 6 plugin, tất cả từ nguồn chính thức của Google (ví dụ plugin Chrome DevTools, Firebase); chúng tôi chưa xác nhận plugin nào được cài sẵn, plugin nào do tác tử cài, chưa cài plugin bên thứ ba, chưa chạy agy plugin import và chưa đo hiệu quả của từng MCP server.

Câu hỏi thường gặp

MCP Store và Plugin Marketplace có giống nhau không?

Không hoàn toàn. MCP Store trong ứng dụng và IDE là danh sách MCP server để cài từng server. Plugin Marketplace, công bố ngày 29/10/2026, là danh mục plugin, mỗi plugin có thể gộp skill, MCP server, tác tử con, rule và hook. Một plugin có thể chứa MCP server, nhưng một MCP server riêng lẻ không phải plugin.

Có dùng được server MCP kiểu SSE cũ không?

Theo trang /docs/mcp đọc ngày 03/11/2026, server MCP từ xa phải dùng Streamable HTTP; kiểu HTTP+SSE cũ và khoá httpUrl không được hỗ trợ. Nếu server chỉ có SSE, cần hỏi nhà cung cấp bản Streamable HTTP hoặc dùng một cầu nối cục bộ dạng stdio. Khoá URL đúng là serverUrl, khoá url cũng được chấp nhận.

Skill viết cho Claude Code có dùng được trong Antigravity không?

Antigravity theo chuẩn Agent Skills mở, cùng định dạng thư mục có SKILL.md với frontmatter mô tả, nên về nguyên tắc skill đúng chuẩn dùng lại được. Cần đặt vào .agents/skills/ hoặc thư mục skill toàn cục, và kiểm tra script kèm theo có phụ thuộc công cụ riêng của Claude Code không. Plugin Claude Code nhập được bằng agy plugin import claude; chúng tôi chưa thử.

Làm sao biết một plugin có an toàn không?

Không có cách chắc chắn. Tối thiểu nên đọc plugin.json, hooks.json, các SKILL.md và mã MCP server trước khi cài, nhất là plugin từ GitHub. agy plugin validate --strict chỉ kiểm tra cấu trúc, không kiểm tra ý đồ. Sau khi cài, xem agy plugin list --json để biết plugin thêm thành phần nào.

Nên bắt đầu với MCP và skill trong Antigravity từ đâu?

Bắt đầu với một MCP server chỉ đọc từ MCP Store, ví dụ đọc schema cơ sở dữ liệu thử, rồi viết một skill nhỏ cho việc lặp lại mỗi tuần. Muốn học cách nối tác tử với công cụ ngoài có kiểm soát, xem khoá đào tạo ứng dụng AI của OPCAIOS.

Nguồn: tài liệu Google Antigravity tại antigravity.google/docs (mcp, skills, plugins, marketplace, build-plugins, hooks, migration/workflows-to-skills), blog "Plugin Marketplace in Antigravity" (29/10/2026), trợ giúp agy mcp, agy plugin bản 1.4.12, claude mcp, claude plugin, codex mcp, codex plugin (đọc ngày 03/11/2026); chưa kiểm chứng: độ an toàn của plugin trong Marketplace, kết quả thật của agy plugin import. Kinh nghiệm là của OPCAIOS.