Điều kiện tiên quyết để sử dụng các ứng dụng đã kết nối

Trước khi bắt đầu, hãy đảm bảo rằng bạn có:

  • Một máy chủ MCP đã triển khai có điểm cuối HTTPS an toàn

    Máy chủ MCP của bạn phải có thể truy cập công khai qua HTTPS bằng phương thức truyền tải HTTP có thể truyền trực tuyến (ví dụ: https://api.yourdomain.com/v1/mcp).

    Tham khảo Hướng dẫn dành cho nhà phát triển về máy chủ MCP của Connected Apps Platform để biết thông tin chi tiết về cách triển khai.

  • Đảm bảo máy chủ của bạn có thể nhận yêu cầu từ Google

    Nếu máy chủ của bạn hạn chế quyền truy cập từ bên ngoài theo IP nguồn, hãy đưa các địa chỉ IP sau vào danh sách cho phép:

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    Dải IP gửi đi của Google có thể thay đổi theo thời gian, vì vậy, bạn nên đọc các dải IP này trong danh sách đã xuất bản của Google và thường xuyên làm mới danh sách cho phép:

  • Quyền truy cập vào tài khoản nhà phát triển đã đăng ký trong Google Connected Console

    Sau khi đăng nhập, hãy đảm bảo bạn có một trong các quyền sau đây đối với Ứng dụng đã kết nối trong Google Connected Console:

    • Xem các ứng dụng có thể kết nối
    • Tạo và quản lý các ứng dụng có thể kết nối

    Chủ sở hữu hoặc quản trị viên tài khoản cũng phải chấp nhận Điều khoản dịch vụ của các ứng dụng có thể kết nối. Trong lần đầu tiên tổ chức của bạn truy cập vào các ứng dụng được kết nối trong Google Connected Console, chủ sở hữu tài khoản hoặc quản trị viên phải đăng nhập và chấp nhận thoả thuận của chương trình trước khi các thành viên được mời trong nhóm có thể tiếp tục.

    Nếu bạn cho rằng mình có quyền truy cập nhưng không thể tạo ứng dụng được kết nối, hãy yêu cầu chủ sở hữu tài khoản hoặc quản trị viên cấp cho tài khoản người dùng của bạn quyền "Xem ứng dụng được kết nối" hoặc "Tạo và quản lý ứng dụng được kết nối" trên trang Người dùng và quyền.

  • Có thể lưu trữ tệp xác minh .well-known trên miền máy chủ MCP

    Để xác minh quyền sở hữu miền, bạn phải có thể phân phát trực tiếp tệp mã thông báo xác thực JSON (với HTTP 200 OK và không có lệnh chuyển hướng) tại https://<your-domain>/.well-known/google-connected-apps.

  • Xem các danh mục ứng dụng có thể kết nối hiện có

    Danh mục của ứng dụng được kết nối liên kết với các chức năng cụ thể mà ứng dụng đó cần hỗ trợ để đảm bảo mang đến trải nghiệm chất lượng cao cho người dùng. Sau khi chọn danh mục cho một ứng dụng được kết nối, bạn sẽ không thể thay đổi danh mục đó. Tìm hiểu thêm.

  • Một máy chủ MCP đã triển khai có URL điểm cuối hợp lệ

    Tham khảo Hướng dẫn cho nhà phát triển về máy chủ MCP của ứng dụng đã kết nối để biết thêm thông tin chi tiết.

  • Siêu dữ liệu công khai và tài sản thương hiệu cho ứng dụng được kết nối của bạn

    • Tên ứng dụng được kết nối: Tên hiển thị của ứng dụng được kết nối mà người dùng nhìn thấy trên các sản phẩm của Google và được dùng khi người dùng đề cập đến ứng dụng của bạn bằng @.
    • Nội dung mô tả: Nội dung tóm tắt ngắn gọn, chỉ gồm một câu (dưới 30 từ) về những việc mà ứng dụng có thể kết nối của bạn có thể làm cho người dùng, chẳng hạn như "Theo dõi các giao dịch mua gần đây, kiểm tra trạng thái giao hàng và xem nhật ký đặt hàng".
    • Biểu tượng: Biểu tượng ứng dụng có kích thước 512 px × 512 px ở định dạng JPEG hoặc PNG, với kích thước tệp tối đa là 1 MB (1.024 KB).
    • Chức năng: Ít nhất 3 nhiệm vụ có giá trị cao mà ứng dụng có thể kết nối của bạn có thể thực hiện, chẳng hạn như "Tìm kiếm nhật ký đặt hàng" hoặc "Kiểm tra trạng thái giao hàng trực tiếp", ngoài các chức năng mặc định được xác định theo danh mục của ứng dụng. Người dùng sẽ thấy thông tin này để quyết định có nên kết nối hay không. Đừng thêm số vào đầu tên chức năng.
    • Câu lệnh mẫu: Ít nhất 3 câu hỏi mẫu giúp người dùng hiểu được những điều họ có thể hỏi. Bắt đầu ít nhất 2 câu lệnh mẫu bằng tên của ứng dụng đã kết nối. Đề cập đến tên ứng dụng của bạn một cách tự nhiên trong ít nhất 1 câu lệnh (tức là không bắt đầu bằng tên ứng dụng). Đừng thêm số vào đầu câu lệnh mẫu.
    • URL của Điều khoản dịch vụ: URL truy cập công khai cho Điều khoản dịch vụ của ứng dụng được kết nối.
    • URL của chính sách quyền riêng tư: URL có thể truy cập công khai cho Chính sách quyền riêng tư của ứng dụng được kết nối.
    • URL của trang web (không bắt buộc): Trang web cho ứng dụng được kết nối của bạn.