Antigravity và Cloud MCP

Cloud MCP sử dụng điểm cuối HTTP từ xa https://mcp.altifigence.com/cloud-mcp. Máy chủ đã cấu hình, tài khoản đã cấp quyền và thao tác đọc công cụ thành công là các bước kiểm tra riêng biệt. Tính khả dụng phụ thuộc vào ứng dụng khách và chính sách công cụ của tổ chức Cloud của bạn.

Cấu hình Antigravity

Khi phiên bản Antigravity đã cài đặt đọc các máy chủ MCP từ xa từ mcp_config.json, mục cấu hình Cloud MCP có dạng như sau. Hãy kiểm tra tài liệu của phiên bản đã cài đặt và tệp cấu hình dự kiến trước khi sử dụng.

{
  "mcpServers": {
    "altifigence": {
      "serverUrl": "https://mcp.altifigence.com/cloud-mcp"
    }
  }
}

Tài liệu của Antigravity liệt kê tệp toàn cục ~/.gemini/config/mcp_config.json và tệp không gian làm việc <workspace>/.agents/mcp_config.json. Trong tệp đó, máy chủ từ xa sử dụng phương thức truyền tải Streamable HTTP và nhận điểm cuối qua serverUrl. Mục cấu hình Cloud MCP không sử dụng headers hoặc thông tin xác thực của ứng dụng khách; quyền truy cập đến từ bước cấp quyền tài khoản bên dưới.

Xác thực

Khi phiên bản Antigravity của bạn cung cấp Authenticate cho máy chủ đã cấu hình, Antigravity bắt đầu quy trình cấp quyền tài khoản. Tài liệu của Antigravity cho biết Authenticate nằm cạnh máy chủ trong thẻ Customizations của Agent settings. Cloud quay về lệnh gọi lại đã đăng ký của Antigravity; hãy hoàn tất mọi bước còn lại trong Antigravity theo tài liệu của ứng dụng này. Tài khoản, tổ chức và các phạm vi (scopes) được yêu cầu thuộc về quy trình cấp quyền đó. Trang thiết lập DDS không chứng minh rằng Antigravity đã hoàn tất cấp quyền. Bản thân lệnh gọi lại (callback) không xác lập quyền truy cập công cụ Cloud thành công.

Kiểm tra tính khả dụng của kết nối trong DDS

1. Dùng QUOTA để mở thiết lập DDS rồi chọn Developer access.

2. Đọc dự án được chọn trong Overview cùng yêu cầu về đăng nhập tài khoản, sự đồng ý của tổ chức và quyền hạn.

3. Chọn Open setup để mở Developer tools. Đọc thông tin thiết lập được cung cấp và liên kết Documentation.

4. Mở rộng Details. Đọc MCP endpoint, Transport, Authentication và các nhãn quyền hạn. Phương thức truyền tải hiển thị là Streamable HTTP.

Trong Developer access, đọc dự án được chọn cùng yêu cầu về đăng nhập và sự đồng ý.

Chọn Open setup để mở Developer tools.

Bảng Details là tài liệu tham chiếu về tên công cụ và danh mục quyền hạn. Các công cụ thực tế được khám phá của kết nối và quyền được cấp hiện tại mới quyết định quyền truy cập; riêng bảng tham chiếu không kích hoạt công cụ.

Mở rộng Details để đọc điểm cuối Cloud MCP, các quyền hạn và tài liệu tham chiếu công cụ.

Context, search & connections là một trang thiết lập riêng cho ngữ cảnh, Web search và các kết nối AI. Những điều khiển này không phải là màn hình đồng ý cấp quyền của Cloud MCP. Developer tools có thể hiển thị thông tin thiết lập mà không mở phiên cấp quyền bên ngoài trên máy chủ này.

Khi kết nối hiển thị các công cụ đọc

Một tài khoản Cloud đã kết nối có thể hiển thị định danh, các dự án có thể truy cập và thao tác đọc tệp đã lưu dưới quyền cloud.read. Việc đọc thành công một tệp nhỏ không nhạy cảm từ dự án do kết nối đó trả về xác nhận nhiều hơn là chỉ cấu hình máy chủ. Định danh dự án/tệp, phân trang, hoàn tất các phần dữ liệu (chunk) và phiên bản xác định nội dung đã được đọc. Một công cụ bị từ chối sẽ vẫn không khả dụng nếu thiếu chính sách hiện tại của tổ chức và sự đồng ý bắt buộc.

Giữ tách biệt với DX dành cho nhân viên

Điểm cuối DX dành cho nhân viên kết thúc bằng /dx-mcp. Plugin tổ chức và quy trình đăng nhập thiết bị dành cho nhân viên của điểm cuối này không cấu hình quyền truy cập Cloud của khách hàng. Không được dùng quy trình mã thiết bị DX để thay thế cho bước cấp quyền Cloud, và không được trộn lẫn các phạm vi quyền nhân viên với các phạm vi cloud.*.

Nếu kết nối thất bại

Nếu Antigravity từ chối mục cấu hình, hãy xem tài liệu của phiên bản đã cài đặt. Lệnh gọi lại bị từ chối, thiếu công cụ hoặc thao tác đọc bị từ chối có nguyên nhân khác với việc không gian làm việc DDS không khả dụng. Hãy giữ lại thông báo lỗi đã lược bỏ thông tin nhạy cảm và dùng hướng dẫn khắc phục sự cố MCP. Không đưa các token, cookie trình duyệt và mã cấp quyền vào cấu hình dự án dùng chung.

Hướng dẫn liên quan

Hướng dẫn kết nối · Authentication · Tham chiếu công cụ · Khắc phục sự cố