scoopy
Liên hệ
← Tất cả công cụ

Tiện ích

Gemini 4 Argon MCP

Công cụ kết nối Gemini 4 Argon (Thinking) trên Web với Antigravity và các AI Coding Agent thông qua MCP. Tự động thiết lập, quản lý phiên đăng nhập và hỗ trợ khôi phục kết nối, giúp tận dụng Gemini Web mà không cần API key riêng.

Hướng dẫn sử dụng

GEMINI 4 ARGON MCP — HƯỚNG DẪN CÀI ĐẶT & SỬ DỤNG

Gemini 4 Argon MCP giúp kết nối Gemini Web với Antigravity và các AI Coding Agent thông qua MCP Server hoặc API tương thích OpenAI/Claude.

Hỗ trợ tự động cấu hình, quản lý phiên đăng nhập Google và kết nối Gemini với các công cụ lập trình AI.

1. YÊU CẦU HỆ THỐNG

  • Windows 10/11.
  • Python và pip đã được cài đặt.
  • Kết nối Internet ổn định.
  • Tài khoản Google có quyền truy cập Gemini Web.
  • Antigravity hoặc ứng dụng AI hỗ trợ MCP / Custom API.

2. CÀI ĐẶT CÔNG CỤ

Bước 1: Tải và giải nén

  1. Tải file ZIP từ Scoopy.
  2. Giải nén vào thư mục mong muốn.
  3. Mở thư mục vừa giải nén.

Bước 2: Cài đặt thư viện cần thiết

Mở CMD hoặc PowerShell và chạy lần lượt:

pip install playwright

playwright install chromium

Nếu đã cài đặt đầy đủ thì có thể bỏ qua bước này.

Bước 3: Khởi chạy công cụ

  1. Chạy file Start_Argon_AGY.bat trong thư mục tool.
  2. Chờ chương trình khởi tạo.
  3. Một cửa sổ Chromium sẽ xuất hiện.
  4. Đăng nhập tài khoản Google có quyền truy cập Gemini Web.
  5. Tool sẽ tự động xử lý phiên đăng nhập, thiết lập MCP và khởi chạy Antigravity.

Lưu ý: Khuyến khích sử dụng tài khoản Google phụ, không chứa dữ liệu quan trọng.

3. CÁCH 1 — SỬ DỤNG VỚI ANTIGRAVITY (KHUYÊN DÙNG)

Đây là phương thức tích hợp trực tiếp thông qua MCP Server.

Các bước thực hiện:

  1. Cài đặt và mở Antigravity.
  2. Khởi chạy Start_Argon_AGY.bat.
  3. Đăng nhập Google theo hướng dẫn.
  4. Chờ tool tự động thiết lập kết nối MCP.
  5. Kiểm tra MCP Server đã được nhận diện trong Antigravity.

Ví dụ sử dụng:

  • "Dùng Argon phân tích kiến trúc dự án này."
  • "Nhờ Argon review code, tìm bug logic và đề xuất hướng tối ưu."
  • "Sử dụng Argon để đánh giá kế hoạch triển khai module."
  • "Tham khảo Argon trước khi thực hiện thay đổi lớn trong codebase."

Cơ chế hoạt động:

Antigravity → MCP Server → Gemini Web → Trả kết quả về Antigravity.

Agent trong Antigravity sẽ sử dụng kết quả phân tích từ Argon để hỗ trợ xử lý công việc.

Quan trọng: Với MCP, Argon hoạt động như một công cụ hỗ trợ AI Agent, không trực tiếp thay thế model chính của Antigravity.

4. CÁCH 2 — OPENAI COMPATIBLE API

Ngoài MCP, tool còn cung cấp API Server chạy trên máy tính để kết nối với các ứng dụng hỗ trợ OpenAI Compatible.

Có thể sử dụng với Cline, Roo Code, Continue, Chatbox hoặc ứng dụng hỗ trợ cấu hình Custom API phù hợp.

Bước 1: Khởi chạy tool

Chạy Start_Argon_AGY.bat và hoàn tất đăng nhập Google.

Đảm bảo API Server của tool đang hoạt động trước khi kết nối.

Bước 2: Cấu hình OpenAI Compatible

Mở phần Settings / API Providers / Models trong ứng dụng AI.

Nhập các thông số sau:

  • Provider: OpenAI Compatible / Custom OpenAI
  • Base URL: http://localhost:4981/openai/v1
  • API Key: sk-123456
  • Model ID: gemini-4-argon

Các Model ID được cung cấp:

  • gemini-4-argon
  • gemini-2.5-pro
  • gemini-2.5-flash

Chọn Model ID phù hợp với nhu cầu sử dụng.

Bước 3: Kiểm tra kết nối

  1. Lưu cấu hình API Provider.
  2. Chọn model vừa thiết lập.
  3. Gửi câu hỏi thử nghiệm.
  4. Kiểm tra phản hồi từ Gemini.

Nếu kết nối thành công, ứng dụng có thể gửi yêu cầu đến API Server của tool để nhận kết quả từ Gemini Web.

5. CÁCH 3 — CLAUDE COMPATIBLE API

Dành cho những ứng dụng hỗ trợ Custom Anthropic/Claude Compatible API.

Thông số cấu hình:

  • Provider: Claude / Anthropic Compatible
  • Base URL: http://localhost:4981/claude/v1
  • API Key: sk-123456
  • Model ID: gemini-4-argon

Lưu ý:

  • Chỉ sử dụng endpoint Claude Compatible với ứng dụng hỗ trợ giao thức tương ứng.
  • Không nhầm lẫn Base URL của OpenAI và Claude.
  • Khả năng tương thích phụ thuộc vào ứng dụng và những tính năng mà API Server đã triển khai.

6. SỬ DỤNG VỚI APP HOẶC TELEGRAM BOT RIÊNG

Nếu đang phát triển ứng dụng AI hoặc Telegram Bot, bạn có thể tích hợp thông qua API tương thích OpenAI, miễn là ứng dụng hỗ trợ định dạng yêu cầu và phản hồi tương ứng.

Luồng hoạt động:

Người dùng → App / Telegram Bot → OpenAI Compatible API → Gemini Web → Trả kết quả về ứng dụng.

Thông tin kết nối:

  • Base URL: http://localhost:4981/openai/v1
  • API Key: sk-123456
  • Model: gemini-4-argon

Lưu ý quan trọng:

  • API Server mặc định được truy cập qua localhost trên máy đang chạy tool.
  • Nếu app chạy trên VPS hoặc thiết bị khác, cần triển khai kết nối mạng hoặc API Bridge phù hợp.
  • Không công khai API Server ra Internet nếu chưa có xác thực và biện pháp bảo mật.
  • API Bridge cần được kiểm tra về khả năng tương thích, timeout và giới hạn request.

7. TÍNH NĂNG NỔI BẬT

✅ Tự động thiết lập: Chạy một file BAT để hỗ trợ đăng nhập Google, cấu hình MCP và mở Antigravity.

✅ MCP Integration: Kết nối Gemini Web với AI Coding Agent thông qua MCP Server.

✅ OpenAI Compatible: Cung cấp API Server local để sử dụng với ứng dụng hỗ trợ OpenAI Compatible.

✅ Claude Compatible: Có endpoint riêng cho các ứng dụng hỗ trợ giao thức Claude tương thích.

✅ Chromium độc lập: Sử dụng profile trình duyệt riêng, hạn chế xung đột với Chrome chính.

✅ Tự làm mới phiên: Hỗ trợ làm mới cookie trong nền khi cần thiết, giúp giảm thao tác đăng nhập lại.

✅ Hỗ trợ nhiều Model ID: Gemini 4 Argon, Gemini 2.5 Pro và Gemini 2.5 Flash theo cấu hình tool.

8. XỬ LÝ LỖI THƯỜNG GẶP

Lỗi không mở được công cụ

  • Kiểm tra Python và pip.
  • Cài lại Playwright và Chromium.
  • Kiểm tra thông báo lỗi trong CMD.
  • Thử khởi chạy lại file BAT.

Antigravity không nhận MCP

  • Kiểm tra tool có đang chạy không.
  • Kiểm tra trạng thái MCP Server.
  • Khởi động lại Antigravity.
  • Thử chạy lại file Start_Argon_AGY.bat.

OpenAI Compatible không kết nối được

  • Kiểm tra API Server có hoạt động không.
  • Kiểm tra Base URL và port 4981.
  • Kiểm tra API Key và Model ID.
  • Đảm bảo ứng dụng AI hỗ trợ Custom OpenAI Endpoint.

Gemini không trả kết quả

  • Kiểm tra kết nối Internet.
  • Kiểm tra phiên đăng nhập Google.
  • Xác nhận tài khoản vẫn truy cập được Gemini Web.
  • Thử khởi chạy lại tool nếu cần.

9. LƯU Ý BẢO MẬT

⚠️ ĐỌC KỸ TRƯỚC KHI SỬ DỤNG

  • Tool sử dụng phiên đăng nhập Gemini Web, không phải API chính thức của Google.
  • Khuyến khích sử dụng tài khoản Google phụ (clone), không chứa dữ liệu quan trọng.
  • Tool có khả năng truy cập cookie và dữ liệu phiên đăng nhập Google.
  • Nên kiểm tra độ tin cậy của mã nguồn trước khi chạy.
  • Không chia sẻ cookie, token hay thông tin đăng nhập cho người khác.
  • Khả năng hoạt động phụ thuộc vào các thay đổi của Gemini Web.
  • Không bảo đảm hoạt động liên tục hoặc không giới hạn.
  • Việc sử dụng phải tuân thủ chính sách và điều khoản của dịch vụ liên quan.

Khuyến cáo: Hãy ưu tiên tài khoản phụ để trải nghiệm an toàn, hạn chế rủi ro đối với tài khoản Google chính.

10. HỖ TRỢ

Nếu gặp vấn đề trong quá trình cài đặt hoặc kết nối, vui lòng liên hệ Scoopy để được hỗ trợ.

Khi báo lỗi, nên gửi:

  • Phiên bản công cụ.
  • Ảnh chụp thông báo lỗi.
  • Ứng dụng AI đang sử dụng.
  • Mô tả ngắn vấn đề gặp phải.

Không gửi mật khẩu, cookie hoặc token đăng nhập khi yêu cầu hỗ trợ.

Điểm mới trong bản 1.0.0

Phiên bản 1.0.0 — Phát hành đầu tiên

  • Tích hợp Gemini 4 Argon (Thinking) qua MCP.
  • Hỗ trợ Antigravity và các AI Coding Agent tương thích.
  • Tự động hóa quá trình thiết lập và kết nối.
  • Sử dụng Chromium với profile độc lập.
  • Hỗ trợ quản lý phiên đăng nhập và tự khôi phục kết nối.
  • Tối ưu trải nghiệm cài đặt và sử dụng trên Windows.