Định cấu hình máy chủ MCP của Chat

Google Chat cung cấp một máy chủ Giao thức bối cảnh mô hình (MCP) từ xa, cho phép các tác nhân AI tương tác an toàn với dữ liệu của Google Chat. Bằng cách định cấu hình máy chủ MCP của Google Chat, bạn cho phép các ứng dụng AI như Google Antigravity và Claude thực hiện các hành động trong Google Chat.

Máy chủ MCP của Google Chat cung cấp một cách thức chuẩn hoá để các tác nhân AI:

  • Đọc dữ liệu: Liệt kê và tìm kiếm cuộc trò chuyện, cũng như đọc tin nhắn.
  • Tôn trọng tính bảo mật: Kế thừa các quyền và chế độ kiểm soát quản trị dữ liệu giống như người dùng.

Điều kiện tiên quyết

Định cấu hình máy chủ MCP của Google Chat

Để sử dụng máy chủ MCP của Google Chat, bạn phải bật máy chủ này trong dự án trên đám mây của Google Cloud, sau đó định cấu hình ứng dụng MCP để kết nối với máy chủ đó.

Bật API

Để sử dụng máy chủ MCP của Google Chat, bạn phải bật các API sau trong dự án trên đám mây của Google Cloud của mình:

  • Google Chat API

CLI

gcloud services enable chat.googleapis.com --project=PROJECT_ID

Thay thế PROJECT_ID bằng mã dự án trên đám mây của bạn.

Giao diện dòng lệnh

Bật các API trong Google Cloud Console:

Bật API

Bật dịch vụ MCP

Để bật các thành phần MCP cho Google Chat, bạn phải bật dịch vụ sau trong dự án trên đám mây của mình:

  • Google Chat MCP API

CLI

gcloud services enable chatmcp.googleapis.com --project=PROJECT_ID

Thay thế PROJECT_ID bằng mã dự án trên đám mây của bạn.

Giao diện dòng lệnh

Bật các dịch vụ MCP trong Google Cloud Console:

Bật các dịch vụ MCP

Định cấu hình ứng dụng Chat

Để sử dụng máy chủ MCP của Google Chat nhằm thực hiện các thao tác chỉ có thể đọc, chẳng hạn như tìm kiếm cuộc trò chuyện, bạn phải bật API và tạo một ứng dụng OAuth. Bạn không cần phải có một ứng dụng Chat đã định cấu hình.

Để thực hiện các thao tác ghi, chẳng hạn như gửi tin nhắn, bạn phải định cấu hình một ứng dụng Chat trong dự án của mình trên Google Cloud.

  1. Trong Google Cloud Console, hãy tìm Google Chat API rồi nhấp vào Google Chat API > Quản lý > Cấu hình.

    Chuyển đến Google Chat API

  2. Thiết lập ứng dụng Chat:

    1. Trong trường Tên ứng dụng, hãy nhập Chat MCP.
    2. Trong trường URL hình đại diện, hãy nhập https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. Trong phần Nội dung mô tả, hãy nhập Chat MCP server.
    4. Trong phần Chức năng, hãy tắt các tính năng tương tác bằng cách tắt chế độ Bật các tính năng tương tác.
    5. Trong phần Nhật ký, hãy chọn Ghi nhật ký lỗi vào tính năng Ghi nhật ký.

  3. Nhấp vào Lưu.

Để tìm hiểu thêm về cách xây dựng ứng dụng Chat, hãy xem bài viết Chọn cấu trúc ứng dụng Google Chat.

Máy chủ MCP của Google Chat sử dụng OAuth 2.0 để xác thực và uỷ quyền. Bạn phải định cấu hình màn hình xin phép bằng OAuth trước khi có thể tạo mã ứng dụng khách OAuth.

  1. Trong Google Cloud Console, hãy chuyển đến Google Auth Platform > Xây dựng thương hiệu.

    Chuyển đến phần Xây dựng thương hiệu

  2. Nếu đã định cấu hình Nền tảng xác thực của Google, bạn có thể định cấu hình các chế độ cài đặt sau đây cho Màn hình xin phép bằng OAuth trong phần Thương hiệu, Đối tượng và Quyền truy cập dữ liệu. Nếu bạn thấy thông báo cho biết Nền tảng xác thực của Google chưa được định cấu hình, hãy nhấp vào Bắt đầu:

    1. Trong phần App Information (Thông tin ứng dụng), trong mục App name (Tên ứng dụng), hãy nhập Chat MCP Server.
    2. Trong phần Email hỗ trợ người dùng, hãy chọn địa chỉ email của bạn hoặc một nhóm trên Google Groups phù hợp.
    3. Nhấp vào Tiếp theo.
    4. Trong phần Đối tượng, hãy chọn Nội bộ. Nếu bạn không thể chọn Nội bộ, hãy chọn Bên ngoài.
    5. Nhấp vào Tiếp theo.
    6. Trong phần Thông tin liên hệ, hãy nhập Địa chỉ email để nhận thông báo về mọi thay đổi đối với dự án của bạn.
    7. Nhấp vào Tiếp theo.
    8. Trong phần Hoàn tất, hãy xem Chính sách dữ liệu người dùng của các dịch vụ API của Google và nếu bạn đồng ý, hãy chọn Tôi đồng ý với Chính sách dữ liệu người dùng của các dịch vụ API của Google.
    9. Nhấp vào Tiếp tục.
    10. Nhấp vào Tạo.
    11. Nếu bạn đã chọn Bên ngoài cho loại người dùng, hãy thêm người dùng thử nghiệm:
      1. Nhấp vào Đối tượng.
      2. Trong phần Người dùng thử nghiệm, hãy nhấp vào Thêm người dùng.
      3. Nhập địa chỉ email của bạn và mọi người dùng thử nghiệm được uỷ quyền khác, sau đó nhấp vào Lưu.

  3. Nhấp vào Data Access (Truy cập dữ liệu) > Add or Remove Scopes (Thêm hoặc xoá phạm vi). Một bảng điều khiển sẽ xuất hiện cùng với danh sách phạm vi cho từng API mà bạn đã bật trong dự án Google Cloud.

    1. Trong phần Thêm phạm vi theo cách thủ công, hãy dán các phạm vi cho máy chủ MCP của Google Chat:

      • https://www.googleapis.com/auth/chat.spaces.readonly
      • https://www.googleapis.com/auth/chat.memberships.readonly
      • https://www.googleapis.com/auth/chat.messages.readonly
      • https://www.googleapis.com/auth/chat.messages.create
      • https://www.googleapis.com/auth/chat.users.readstate
      • https://www.googleapis.com/auth/chat.users.spacesettings

    2. Nhấp vào Thêm vào bảng.

    3. Nhấp vào Cập nhật.

    4. Sau khi chọn các phạm vi mà ứng dụng của bạn yêu cầu, trên trang Truy cập dữ liệu, hãy nhấp vào Lưu.

Định cấu hình ứng dụng MCP

Để thêm máy chủ MCP từ xa của Google Chat vào ứng dụng MCP, hãy làm theo hướng dẫn dành cho ứng dụng của bạn.

Antigravity

Để thêm máy chủ MCP từ xa của Google Chat vào Antigravity, hãy thêm cấu hình máy chủ vào tệp mcp_config.json. Các hướng dẫn này hỗ trợ Antigravity 2.0, Antigravity IDE và Antigravity CLI.

  1. Tạo mã ứng dụng khách và khoá bí mật OAuth 2.0:

    1. Trong Google Cloud Console, hãy chuyển đến Google Auth Platform > Clients (Ứng dụng khách) > Create Client (Tạo ứng dụng khách)

      Chuyển đến phần Tạo ứng dụng

    2. Chọn Ứng dụng web làm loại ứng dụng.

    3. Nhập Tên.

    4. Trong mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi thêm https://antigravity.google/oauth-callback vào trường URI.

    5. Chọn Sử dụng khách hàng này cho một tác nhân dựa trên AI.

    6. Nhấp vào Tạo rồi sao chép Mã ứng dụng khách và Khoá bí mật của ứng dụng khách.

  2. Mở hoặc tạo tệp cấu hình ~/.gemini/config/mcp_config.json.

  3. Thêm cấu hình mcpServers vào mcp_config.json:

    {
  "mcpServers": {
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    Thay thế nội dung sau:

    • OAUTH_CLIENT_ID: Mã ứng dụng khách mà bạn đã tạo.
    • OAUTH_CLIENT_SECRET: Khoá bí mật của ứng dụng khách mà bạn đã tạo.

  4. Tiết kiệm mcp_config.json.

  5. Xác thực máy chủ MCP. Bạn có thể xác thực bằng cách sử dụng chế độ cài đặt GUI hoặc CLI:

    • Đối với Antigravity IDE hoặc GUI (Antigravity 2.0):

      1. Mở màn hình cài đặt (ví dụ: nhấp vào Settings (Cài đặt) ở dưới cùng bên trái hoặc mở Antigravity User Settings (Cài đặt người dùng Antigravity)).
      2. Chuyển đến phần Tuỳ chỉnh.
      3. Trong mục Máy chủ MCP đã cài đặt, hãy nhấp vào Làm mới.
      4. Tìm chat trong danh sách, nhấp vào Xác thực, đăng nhập vào Tài khoản Google của bạn, sao chép mã uỷ quyền, dán mã đó vào hộp thoại nhập rồi nhấp vào Gửi.

    • Đối với Antigravity CLI:

      1. Bắt đầu sử dụng Antigravity CLI:

        agy

      2. Mở bảng điều khiển quản lý MCP tương tác bằng cách chạy:

        /mcp

      3. Sử dụng các phím mũi tên để chọn chat, di chuyển đến thao tác Xác thực rồi nhấn phím Enter. Hoàn tất quy trình đăng nhập trong trình duyệt, sao chép mã uỷ quyền, dán mã đó vào lời nhắc của thiết bị đầu cuối rồi nhấn phím Enter.

  6. Xác minh rằng máy chủ được định cấu hình chính xác và đang chạy:

    • Đối với Antigravity IDE hoặc GUI: Nút Đăng xuất sẽ xuất hiện bên cạnh máy chủ trong phần Tuỳ chỉnh > Máy chủ MCP đã cài đặt.
    • Đối với Antigravity CLI: Mở bảng điều khiển /mcp để xem các máy chủ MCP đã định cấu hình. Các máy chủ đã được xác minh và xác thực sẽ hiển thị trạng thái Đã xác thực bên cạnh tên của chúng trong bảng điều khiển TUI tương tác. Bạn có thể chọn bất kỳ máy chủ nào trong chế độ xem trang tổng quan để kiểm tra trạng thái và liệt kê tất cả công cụ có sẵn của máy chủ đó.

Máy chủ MCP từ xa đã sẵn sàng để sử dụng trong Antigravity.

Claude

Để sử dụng máy chủ MCP từ xa của Google Chat với Claude.ai hoặc Claude Desktop, bạn phải có gói Claude Enterprise, Pro, Max hoặc Team.

Để thêm máy chủ MCP từ xa của Google Chat vào Claude, hãy định cấu hình một trình kết nối tuỳ chỉnh bằng mã ứng dụng khách OAuth và khoá bí mật.

  1. Tạo mã ứng dụng khách và khoá bí mật OAuth 2.0:

    1. Trong Google Cloud Console, hãy chuyển đến Google Auth Platform > Clients (Ứng dụng khách) > Create Client (Tạo ứng dụng khách)

      Chuyển đến phần Tạo ứng dụng

    2. Chọn Ứng dụng web làm loại ứng dụng.

    3. Nhập Tên.

    4. Trong mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi thêm https://claude.ai/api/mcp/auth_callback vào trường URI.

    5. Chọn Sử dụng khách hàng này cho một tác nhân dựa trên AI.

    6. Nhấp vào Tạo rồi sao chép Mã ứng dụng khách và Khoá bí mật của ứng dụng khách.

  2. Định cấu hình máy chủ MCP trong Claude:

    1. Trong Claude.ai hoặc Claude Desktop, hãy chuyển đến phần Settings (Cài đặt) (hoặc Admin settings (Cài đặt quản trị)) > Connectors (Trình kết nối).
    2. Nhấp vào Thêm trình kết nối tuỳ chỉnh.
    3. Nhập thông tin chi tiết về kết nối cho sản phẩm Google Chat:
      • Tên máy chủ: Google Chat.
      • URL của máy chủ MCP từ xa: https://chatmcp.googleapis.com/mcp/v1
    4. Trong phần Cài đặt nâng cao, hãy nhập Mã ứng dụng khách OAuth và Khoá bí mật của ứng dụng khách OAuth.
    5. Nhấp vào Thêm.

Khác

Nhiều ứng dụng AI có cách kết nối với máy chủ MCP từ xa. Thông thường, bạn cần nhập thông tin chi tiết về máy chủ, chẳng hạn như tên, điểm cuối, giao thức truyền tải và phương pháp xác thực. Đối với máy chủ MCP từ xa của Google Chat, hãy nhập thông tin sau:

Để biết thêm thông tin chi tiết về cách kết nối các loại ứng dụng, hãy xem bài viết Định cấu hình MCP trong ứng dụng AI.

Kiểm thử máy chủ MCP của Google Chat

Sau khi định cấu hình ứng dụng MCP, bạn có thể xác minh kết nối bằng cách chạy một số câu lệnh kiểm thử.

Hãy thử hỏi ứng dụng MCP của bạn những câu hỏi sau:

  • "Tin nhắn gần đây nhất trong không gian "Dự án X" là gì?"

    Ứng dụng tìm không gian bằng search_conversations rồi truy xuất tin nhắn bằng list_messages.

Nếu các công cụ thực thi thành công và bạn nhận được phản hồi có liên quan, thì máy chủ MCP của Google Chat đã được định cấu hình chính xác.

Khắc phục sự cố

Nếu gặp sự cố khi kết nối với máy chủ MCP, bạn có thể kiểm tra lỗi trong nhật ký OAuth. Yêu cầu quản trị viên kiểm tra sự kiện trong nhật ký OAuth trong công cụ điều tra bảo mật.

Nếu các yêu cầu của bạn đến máy chủ MCP bị từ chối, hãy xác minh rằng ứng dụng OAuth 2.0 của bạn đã chọn Sử dụng ứng dụng này cho tác nhân dựa trên AI trong Nền tảng xác thực của Google > Ứng dụng. Nếu bạn không thể thay đổi chế độ cài đặt này trên một ứng dụng OAuth hiện có, hãy tạo một ứng dụng OAuth mới và chọn Sử dụng ứng dụng này cho một tác nhân dựa trên AI, sau đó cập nhật ứng dụng của bạn để sử dụng ứng dụng OAuth mới. Nếu một ứng dụng OAuth hiện có được dùng cho cả tính năng tác nhân AI và tính năng không phải tác nhân, hãy tạo một ứng dụng OAuth riêng cho tác nhân AI và giữ lại ứng dụng hiện có cho các tính năng không phải tác nhân. Để biết hướng dẫn, hãy xem bài viết Định cấu hình ứng dụng MCP và Quản lý ứng dụng OAuth.

Nếu bạn được nhắc đăng nhập lại sau mỗi giờ, thì ứng dụng MCP của bạn sẽ không nhận được mã làm mới. Máy chủ uỷ quyền của Google chỉ cấp mã làm mới khi yêu cầu uỷ quyền có chứa access_type=offline; chỉ yêu cầu phạm vi OIDC offline_access là chưa đủ. Nếu ứng dụng MCP của bạn hỗ trợ các tham số uỷ quyền tuỳ chỉnh, hãy thêm access_type=offline vào yêu cầu uỷ quyền. Để nhận mã làm mới mới cho người dùng đã cấp quyền truy cập, hãy thêm prompt=consent.

Tài liệu tham khảo về công cụ

Các công cụ sau đây có sẵn cho máy chủ MCP của Google Chat:

  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
  • get_notification_settings
  • update_notification_settings

Lưu ý quan trọng về bảo mật: Tiêm câu lệnh gián tiếp

Khi bạn cho mô hình ngôn ngữ tiếp xúc với dữ liệu không đáng tin cậy, có nguy cơ xảy ra cuộc tấn công chèn câu lệnh gián tiếp. Vì các máy chủ lưu trữ MCP như Google Antigravity có quyền truy cập vào các công cụ và API mạnh mẽ thông qua máy chủ MCP của Google Chat, nên các máy chủ lưu trữ này có thể đọc, sửa đổi và xoá dữ liệu trong Tài khoản Google của bạn.

Để giảm thiểu những rủi ro này, bạn phải sàng lọc câu lệnh và câu trả lời để phát hiện nội dung độc hại hoặc các cuộc tấn công chèn câu lệnh. Bạn có thể sử dụng Model Armor do Google cung cấp hoặc bạn có thể sử dụng giải pháp của riêng mình nếu bạn ghi lại giải pháp đó để người dùng chấp nhận rủi ro đó. Để biết thêm thông tin, hãy xem bài viết Định cấu hình bảo mật cho máy chủ MCP của Google Workspace.

Hãy làm theo các phương pháp hay nhất sau đây:

  • Chỉ sử dụng các công cụ đáng tin cậy. Tuyệt đối không kết nối máy chủ MCP của Google Chat với các ứng dụng không đáng tin cậy hoặc chưa được xác minh.
  • Hãy thận trọng với dữ liệu đầu vào không đáng tin cậy. Tránh yêu cầu ứng dụng MCP xử lý thông báo hoặc các tài nguyên khác từ các nguồn chưa được xác minh. Những thông tin đầu vào này có thể chứa các lệnh ẩn có thể chiếm đoạt phiên của bạn, cho phép kẻ tấn công sửa đổi, đánh cắp hoặc xoá dữ liệu của bạn.
  • Xem tất cả hành động. Hãy luôn xem xét kỹ các hành động mà ứng dụng AI thực hiện thay mặt bạn để đảm bảo các hành động đó là chính xác và phù hợp với ý định của bạn.