Máy chủ MCP dữ liệu người bán (Alpha công khai)

Nhận dữ liệu trực tiếp về tài khoản Merchant Center ngay từ trợ lý lập trình mà bạn chọn. Trong Môi trường phát triển tích hợp (IDE) hoặc khung tác nhân tuỳ chỉnh, giờ đây, bạn có thể truy cập và quản lý dữ liệu Merchant Center bằng dịch vụ Giao thức ngữ cảnh mô hình (MCP). Dịch vụ này cho phép trợ lý hoặc tác nhân lập trình của bạn thực hiện các thao tác ghi an toàn và chỉ đọc trên dữ liệu Merchant Center, cho phép trợ lý hoặc tác nhân này chẩn đoán vấn đề, kiểm tra chương trình và truy vấn báo cáo bằng ngữ cảnh trực tiếp, có thẩm quyền.

Để biết thêm thông tin về giao thức này, hãy xem tiêu chuẩn Giao thức bối cảnh mô hình.

Thử nghiệm: Alpha công khai: Tính năng này đang ở giai đoạn "Alpha công khai" mang tính thử nghiệm cao và có thể thay đổi bất cứ lúc nào mà không cần thông báo trước. Bạn không nên sử dụng các tính năng này cho các hệ thống nhạy cảm có nhu cầu cao về độ tin cậy.

Bảo mật và kiểm soát quyền truy cập

Máy chủ MCP Dữ liệu người bán được thiết kế với ưu tiên hàng đầu là tính bảo mật:

• Xác thực: Việc thực thi công cụ chịu sự điều chỉnh của quy trình xác thực API chuẩn của người bán, yêu cầu thông tin xác thực OAuth 2.0 hoặc tài khoản dịch vụ.
• Độ an toàn khi thực thi: Mặc dù lược đồ công cụ có khả năng hiển thị rộng rãi cho tác nhân của bạn, nhưng quá trình thực thi thực tế của mọi công cụ vẫn rất an toàn và bị hạn chế nghiêm ngặt theo thông tin đăng nhập API cụ thể của bạn.

Điểm quan trọng cần lưu ý

Trước khi sử dụng các công cụ này, hãy xem các phương pháp hay nhất và hạn chế sau đây:

Thay đổi và phát hành

Chúng tôi sẽ đăng thông tin về những thay đổi đối với ghi chú phát hành, nhưng những thay đổi này có thể xảy ra ngay lập tức mà không có giai đoạn ngừng cung cấp.

Thử nghiệm an toàn

Trước khi sử dụng các công cụ này trong môi trường sản xuất thực tế, bạn nên thử nghiệm trước bằng tài khoản thử nghiệm hoặc tài khoản không hoạt động.

Hạn mức dùng chung

Máy chủ MCP dùng chung nhóm hạn mức với các lệnh gọi Merchant API tiêu chuẩn của bạn. Các tác nhân đang chạy có thể nhanh chóng hết hạn mức, đặc biệt là đối với các lượt tìm nạp nguồn dữ liệu. Bạn nên sử dụng tài khoản kiểm thử để tránh làm gián đoạn dịch vụ sản xuất.

Lọc công cụ và đảm bảo an toàn

Trong tương lai, Google có thể thêm các công cụ mới (bao gồm cả khả năng viết) vào máy chủ MCP này. Để ngăn tác nhân AI của bạn tự động và vô tình thực thi các công cụ mới hoặc rủi ro, bạn nên định cấu hình rõ ràng ứng dụng khách của mình để lọc công cụ tích hợp thay vì hiển thị toàn bộ bộ công cụ.

Phạm vi và giới hạn

• Chỉ đọc: Để đảm bảo an toàn cho giai đoạn ban đầu này, các công cụ chỉ giới hạn ở các thao tác chỉ đọc và các công cụ ghi có rủi ro thấp (chẳng hạn như tạo nguồn dữ liệu).

Các tính năng hiện có

Bạn có thể sử dụng máy chủ MCP của Dữ liệu người bán để thực hiện các thao tác sau theo cách có sự hỗ trợ của AI:

• Truy xuất trạng thái chi tiết và ngữ cảnh báo cáo cho một số sản phẩm cụ thể bằng cách sử dụng tên tài nguyên chính xác.
• Liệt kê và tìm kiếm nhiều sản phẩm.
• Dữ liệu hiệu suất cụm từ tìm kiếm, trạng thái sản phẩm và thông tin chi tiết về giá thông qua báo cáo tìm kiếm.
• Liệt kê, tạo, tìm nạp và kiểm tra trạng thái tải lên của nguồn dữ liệu.
• Xác định các vấn đề ở cấp tài khoản ảnh hưởng đến khả năng hiển thị sản phẩm hoặc việc tham gia chương trình.
• Liệt kê các lý do tổng hợp khiến sản phẩm bị từ chối trong kho hàng.
• Kiểm tra các khu vực đang hoạt động, các yêu cầu chưa đáp ứng và trạng thái tham gia của các chương trình cụ thể trong Merchant Center.
• Xem xét chế độ cài đặt cải thiện tự động cho mặt hàng, hình ảnh và thông tin vận chuyển.

Thiết lập

Để kết nối IDE hoặc trợ lý lập trình với máy chủ MCP của Dữ liệu người bán, hãy cập nhật chế độ cài đặt ứng dụng MCP. Ví dụ: cập nhật tệp mcp.json cho Claude Desktop, Antigravity, Visual Studio Code hoặc khung tác nhân tuỳ chỉnh của bạn.

Việc thiết lập máy chủ MCP cục bộ yêu cầu phải có tài khoản dịch vụ. Không hỗ trợ OAuth cho hoạt động thực thi cục bộ không có giao diện người dùng này. Bạn phải tạo một tài khoản dịch vụ, tải tệp khoá riêng tư JSON của tài khoản đó xuống và cung cấp đường dẫn đến tệp đó cùng với mã truy cập Merchant Center cụ thể của bạn dưới dạng đối số.

Để biết hướng dẫn chi tiết về cách tạo và tải tài khoản dịch vụ xuống, hãy xem hướng dẫn về Tài khoản dịch vụ.

Cấu hình ứng dụng

Thiết lập cấu hình:

Antigravity

Làm theo hướng dẫn trong tài liệu Antigravity.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Claude Desktop

Làm theo hướng dẫn trong tài liệu về Claude Desktop.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Ví dụ về các trường hợp sử dụng

Máy chủ MCP của Dữ liệu người bán cho phép tác nhân của bạn tương tác với dữ liệu trực tiếp của Merchant Center. Dưới đây là một số trường hợp phổ biến:

Tình huống 1: Chẩn đoán trường hợp sản phẩm bị từ chối

Bạn muốn biết lý do một sản phẩm cụ thể không xuất hiện trong kết quả trên Google Tìm kiếm.

Câu lệnh của người dùng:

"Tại sao sản phẩm có mã ưu đãi "offer123" của tôi bị từ chối?"

Hành vi của nhân viên hỗ trợ khi sử dụng MCP:

1. Tác nhân gọi list_products hoặc get_product_by_name để xác định trạng thái sản phẩm.
2. Máy chủ MCP trả về trạng thái sản phẩm, bao gồm cả danh sách issues (ví dụ: "Định dạng giá không chính xác" hoặc "Thiếu giá trị phí vận chuyển").
3. Nhân viên hỗ trợ sẽ phân tích các vấn đề và giải thích nguyên nhân gốc rễ cho bạn, đồng thời đề xuất cách khắc phục (ví dụ: cập nhật thông tin về giá).

Trường hợp 2: Kiểm tra tính năng tự động cải thiện

Bạn muốn xác minh xem tính năng tự động cải thiện thông tin vận chuyển có đang hoạt động hay không.

Câu lệnh của người dùng:

"Tôi có bật tính năng tự động cải thiện thông tin vận chuyển không?"

Hành vi của tác nhân với MCP:

1. Tác nhân gọi get_automatic_improvements để truy xuất các chế độ cài đặt ở cấp tài khoản.
2. Máy chủ MCP trả về cấu hình cho biết trạng thái của hình ảnh, mặt hàng và thông tin vận chuyển được cải thiện.
3. Nhân viên hỗ trợ xác nhận rằng các điểm cải thiện về thông tin vận chuyển đang hoạt động hoặc giải thích cách bật các điểm này nếu chúng đang ở trạng thái tắt.

Tình huống 3: Chỉ số hiệu suất truy vấn

Bạn muốn nhanh chóng kiểm tra hiệu suất gần đây mà không cần điều hướng giao diện người dùng Merchant Center.

Câu lệnh của người dùng:

"Cho tôi xem 5 sản phẩm hoạt động hiệu quả nhất theo số lượt nhấp trong tuần trước."

Hành vi của tác nhân với MCP:

1. Tác nhân tạo một truy vấn bằng Ngôn ngữ truy vấn Merchant Center (MCQL) nhắm đến bảng product_performance_view, sắp xếp theo clicks DESC và giới hạn ở 5.
2. Tác nhân gọi report_search bằng truy vấn đã tạo.
3. Máy chủ MCP thực thi truy vấn dựa trên cơ sở dữ liệu báo cáo trực tiếp và trả về các hàng.
4. Tác nhân này định dạng kết quả thành một bảng Markdown rõ ràng cho bạn.

Danh sách chi tiết các công cụ hiện có

Máy chủ MCP cung cấp các công cụ sau cho tác nhân của bạn:

Công cụ MCP	Mô tả
get_product_by_name	Nhận thông tin sản phẩm của một người bán cụ thể bằng cách sử dụng tên tài nguyên sản phẩm chính xác. Trả về trạng thái chi tiết của sản phẩm, bao gồm cả bối cảnh báo cáo và các vấn đề tiềm ẩn ở cấp sản phẩm.
list_products	Liệt kê hoặc tìm kiếm nhiều sản phẩm của một người bán nhất định. Trả về trạng thái chi tiết của sản phẩm, bao gồm cả bối cảnh báo cáo và các vấn đề tiềm ẩn ở cấp sản phẩm.
report_search	Truy vấn các bảng báo cáo để truy xuất chỉ số hiệu suất, trạng thái sản phẩm và thông tin chi tiết về giá. Hãy xem Hướng dẫn về báo cáo để biết thông tin chi tiết.
list_data_sources	Liệt kê các nguồn dữ liệu cho một người bán cụ thể.
get_data_source	Xem thông tin chi tiết về một nguồn dữ liệu cụ thể.
create_data_source	Tạo một nguồn dữ liệu cho một người bán nhất định.
fetch_data_source	Tìm nạp và xử lý tệp được liên kết với một nguồn dữ liệu cho một người bán cụ thể.
get_file_upload	Nhận trạng thái của lần tải tệp lên gần đây nhất cho một nguồn dữ liệu nhất định.
list_accounts	Liệt kê các tài khoản của một người dùng cụ thể.
list_account_issues	Liệt kê các vấn đề ở cấp tài khoản của một người bán nhất định để xác định các vấn đề trên toàn tài khoản.
list_programs	Liệt kê các chương trình của một người bán nhất định, bao gồm cả trạng thái tham gia, khu vực đang hoạt động và mọi yêu cầu chưa đáp ứng.
list_aggregated_product_issues	Liệt kê các vấn đề tổng hợp ở cấp sản phẩm để theo dõi trạng thái tổng thể của dữ liệu sản phẩm.
get_automatic_improvements	Nhận chế độ cài đặt tự động cải thiện, bao gồm cả tính năng cập nhật mặt hàng, cải thiện hình ảnh và cải thiện thông tin vận chuyển.