Xây dựng máy chủ MCP Google Business Profile

Máy chủ tiết lộ điều gì

Máy chủ sử dụng giao thức truyền tải HTTP có thể phát trực tuyến từ đặc tả MCP (giao thức truyền tải), do đó không có gì để cài đặt hoặc chạy cục bộ. Các công cụ của nó thuộc ba lớp và mọi công cụ đều mang chú thích của đặc tả, vì vậy máy khách biết trước khi gọi liệu một công cụ chỉ đọc, thay đổi dữ liệu riêng của Reach hay thay đổi danh sách Google công khai (chú thích công cụ).

Máy chủ cũng cung cấp các lời nhắc MCP, các hướng dẫn bắt đầu có thể tái sử dụng của đặc tả (lời nhắc): một lời nhắc tối ưu hóa hồ sơ từng thay đổi đã được xác nhận, một lời nhắc xem xét khả năng hiển thị tìm kiếm và một lời nhắc xử lý các đánh giá chưa được trả lời. Máy khách hiển thị chúng dưới dạng các yêu cầu được tạo sẵn.

Mỗi công cụ gọi các quy trình máy chủ giống như bảng điều khiển Reach gọi, thông qua một trình gọi trong tiến trình. Do đó, các kiểm tra quyền truy cập địa điểm, giới hạn gói và kiểm tra kết nối Google chạy chính xác như đối với chủ sở hữu đã đăng nhập; lớp MCP không có đường vòng nào xung quanh chúng.

Một phiên ví dụ, từng lệnh gọi

Cách một thay đổi đến được Google

Một thay đổi lên hồ sơ công khai phải qua chủ tiệm hai lần. Đầu tiên, các công cụ ghi có destructiveHint, cho phép ứng dụng khách hiển thị lời nhắc phê duyệt riêng. Thứ hai, mô tả từng công cụ yêu cầu mô hình hiển thị chính xác thay đổi và nhận được sự đồng ý rõ ràng trong cuộc trò chuyện. Chỉnh sửa hồ sơ và thay đổi phương tiện đi xa hơn, mặc định có bản xem trước và không ghi gì cả.

Một lần chỉnh sửa hồ sơ cần hai lệnh gọi. Lần đầu, với preview: true (mặc định), trả về trước và sau của từng trường đã thay đổi, bất kỳ trường nào bị từ chối kèm cách sửa, và dấu vân tay basedOn của hồ sơ đã đọc. Lần thứ hai chỉ ghi nếu mang dấu vân tay đó và hồ sơ chưa thay đổi. Nếu ai đó đã chỉnh sửa hồ sơ trong lúc đó, qua bảng điều khiển hoặc đồng bộ Google, lệnh ghi bị từ chối và trợ lý phải xem trước lại.

API của Google tự áp dụng các trường được gửi theo mặt nạ cập nhật (locations.patch). Nó không thể biết liệu một người đã thấy thay đổi hay chưa. Bản xem trước và dấu vân tay đặt bước kiểm tra đó lên trước, để mô hình không thể áp dụng một chỉnh sửa cũ hoặc chưa xem, dù có thử lại.

Bài đăng và phản hồi đánh giá không có bước xem trước, vì văn bản chủ tiệm duyệt chính là thay đổi. Mô tả của chúng yêu cầu trợ lý hiển thị chính xác bài đăng hoặc phản hồi trước. Một phản hồi đã đăng thay thế bất kỳ phản hồi trước đó và không có công cụ nào xóa được nó (reviews.updateReply), và mô tả nói rõ điều đó, để mô hình có thể thông báo cho chủ tiệm trước khi họ đồng ý.

Reach chọn xác nhận trong cuộc trò chuyện thay vì hàng đợi đề xuất-và-phê-duyệt bên trong Reach. Chủ tiệm đã ở trong chat, một hộp thư đến thứ hai thêm một bước dễ bị bỏ qua, và đặc tả MCP đã kỳ vọng một con người có thể từ chối lệnh gọi công cụ (cân nhắc bảo mật).

Các biện pháp bảo vệ không phụ thuộc vào mô hình

Đặc tả nói rằng ứng dụng khách phải coi chú thích công cụ là không đáng tin cậy trừ khi chúng đến từ máy chủ đáng tin cậy (chú thích công cụ), và mô hình có thể bỏ qua mô tả. Vì vậy máy chủ thực thi các quy tắc riêng của nó:

• Hạn ngạch ghi Google. Mỗi doanh nghiệp có thể thực hiện tối đa 20 thay đổi Google mỗi giờ qua trợ lý. Một mô hình bị kẹt trong vòng lặp sẽ chạm giới hạn và được thông báo phải đợi bao lâu, thay vì viết lại hồ sơ liên tục.
• An toàn khi thử lại. Mỗi thay đổi chấp nhận một khóa đơn nhất. Lặp lại với cùng khóa trả về kết quả đầu tiên thay vì ghi lại; không có khóa, một lệnh gọi giống hệt trong một khoảng thời gian ngắn được tính là cùng một thay đổi.
• Kiểm tra địa điểm trên mọi lệnh gọi. Mã số địa điểm mà mô hình gửi được kiểm tra với quyền truy cập Google trực tiếp của chủ tiệm mỗi lần, bằng cùng kiểm tra mà bảng điều khiển dùng. Máy chủ không giữ phiên nào để mô hình tái sử dụng.
• Số điện thoại bị che. Khách hàng tiềm năng và yêu cầu đặt chỗ trả về với số điện thoại bị che chỉ còn bốn số cuối, kể cả trong ghi chú. Email được giữ nguyên, vì chủ tiệm cần chúng để trả lời khách hàng tiềm năng.
• Thu hồi mà máy chủ thực thi. Chủ tiệm có thể ngắt kết nối trợ lý từ màn hình AI Connectors trong Reach, và máy chủ từ chối token của ứng dụng khách đó kể từ lúc đó.

Nói cho mô hình biết những gì nó không thấy được

Một trợ lý nhận được danh sách rỗng sẽ nói với chủ tiệm “bạn không có đánh giá nào”. Thường thì sự thật là dữ liệu tồn tại nhưng bị ẩn: địa điểm được thêm từ hồ sơ công khai và không có kết nối Google, gói dịch vụ không bao gồm tính năng, hoặc Google chưa hoàn tất đồng bộ lần đầu. Do đó, kết quả đọc mang theo danh sách giới hạn nêu rõ lý do và liên kết để khắc phục. Danh sách rỗng có nghĩa là không có gì bị ẩn.

Kết quả tài khoản cũng làm tương tự cho các tính năng. Mỗi tính năng được đánh dấu là có sẵn hoặc chưa được xây dựng, để mô hình không mô tả các cuộc gọi hoặc quảng cáo như những thứ Reach có thể làm hôm nay. Khi chủ tiệm muốn thứ gì đó Reach chưa có, trợ lý có thể gửi yêu cầu đến nhóm Reach bằng chính lời của chủ tiệm, sau khi cho họ xem nội dung.

Mỗi phản hồi cũng trả về phiên bản lược đồ của công cụ. Ứng dụng khách lưu bộ nhớ đệm lược đồ công cụ và có thể lỗi thầm lặng khi một lược đồ thay đổi, vì vậy một thay đổi phá vỡ sẽ hiện ra trong phản hồi và trong nhật ký của Reach thay vì chỉ trong tỷ lệ lỗi của ứng dụng khách.

Đăng nhập: OAuth 2.1, không cần khóa API

Máy chủ là tài nguyên được bảo vệ OAuth 2.1, như đặc tả ủy quyền MCP mô tả (ủy quyền). Nó công bố siêu dữ liệu tài nguyên được bảo vệ (RFC 9728), để ứng dụng khách tự tìm máy chủ ủy quyền, tự đăng ký và mở đăng nhập qua trình duyệt. Chủ tiệm đăng nhập bằng tài khoản Reach của họ; không có khóa nào để dán.

Máy chủ kiểm tra rằng mỗi token được cấp cho tài nguyên này chứ không phải cho dịch vụ khác trên cùng máy chủ ủy quyền, biện pháp phòng vệ confused-deputy mà các chỉ báo tài nguyên tồn tại để giải quyết (RFC 8707). Kết nối Google không bao giờ đến được trợ lý: Reach giữ nó, và trợ lý chỉ giữ một token Reach.

Đó cũng là lý do chủ tiệm không cần quyền truy cập API Google. Google cấp API Business Profile theo dự án sau yêu cầu truy cập (điều kiện tiên quyết), điều mà hầu hết doanh nghiệp nhỏ không bao giờ thực hiện.

Những gì nó không thể làm

• Nó không thể thay đổi danh mục chính hoặc địa chỉ. Những thứ đó vẫn thuộc về chủ tiệm trong các công cụ riêng của Google.
• Nó không thể xóa bài đăng hoặc gỡ phản hồi đánh giá. Một phản hồi đã đăng có thể được thay thế, chứ không xóa được.
• Không có Google Business Profile đã kết nối, nó chỉ có thể đọc hồ sơ công khai. Một địa điểm được thêm từ hồ sơ công khai sẽ nhận được ảnh chụp đó và một liên kết để kết nối.
• Nó không thể thực hiện quá 20 thay đổi Google mỗi giờ cho mỗi doanh nghiệp qua trợ lý.
• Thứ hạng tìm kiếm chỉ bao gồm các từ khóa được theo dõi. Một từ khóa mới không có thứ hạng cho đến khi lần kiểm tra đầu tiên chạy.

Kết nối nó trong Claude, ChatGPT hoặc Cursor

URL máy chủ

Về máy chủ Google Business Profile MCP của Reach

Mỗi ứng dụng khách thêm máy chủ từ xa theo cách khác nhau, vì vậy các bước được đặt trên một trang riêng cho mỗi ứng dụng khách: Claude, ChatGPT, Claude Code, Cursor và VS Code. Các nhà cung cấp tài liệu hóa cùng nền tảng: Anthropic về kết nối tùy chỉnh, OpenAI về kết nối từ ChatGPT và Cursor về máy chủ MCP.

Các câu hỏi thường gặp

Tôi có cần quyền truy cập API Google Business Profile để dùng máy chủ MCP này không?

Không. Reach giữ kết nối Google, và trợ lý đăng nhập vào Reach bằng OAuth. API của Google cần một dự án Google Cloud đã được phê duyệt (điều kiện tiên quyết), điều này tránh được điều đó.

Những trợ lý AI nào hoạt động với nó?

Bất kỳ ứng dụng khách nào hỗ trợ máy chủ MCP từ xa với đăng nhập OAuth, bao gồm Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex, Windsurf và Cline.

Trợ lý có thể thay đổi hồ sơ của tôi mà không hỏi không?

Các thay đổi lên Google phải qua lời nhắc phê duyệt của ứng dụng khách và một sự đồng ý rõ ràng trong cuộc trò chuyện, và chỉnh sửa hồ sơ cần bản xem trước mới. Máy chủ không thể thấy cuộc trò chuyện, vì vậy các biện pháp bảo vệ mà nó tự thực thi là từ chối bản xem trước cũ, giới hạn ghi Google mỗi giờ và an toàn khi thử lại.

Nó có tốn phí không?

Đọc không tốn phí. Soạn thảo phản hồi đánh giá tốn tín dụng Reach, và một số tính năng phụ thuộc vào gói dịch vụ. Gói Free bao gồm một địa điểm.

Chuyện gì xảy ra nếu kết nối Google bị đứt?

Kết quả tài khoản hiển thị trạng thái kết nối của từng địa điểm. Nếu không hoạt động, trợ lý bảo chủ tiệm kết nối lại Google trong Reach và ngừng làm việc trên địa điểm đó.

Kết nối trợ lý với hồ sơ của riêng bạn

Bắt đầu bằng một câu hỏi chỉ đọc, chẳng hạn như đánh giá nào chưa được trả lời, sau đó phê duyệt một thay đổi nhỏ và đọc lại. Trang thiết lập hướng dẫn từng khách hàng.

Thiết lập máy chủ MCP Google Business Profile

Mở AI Connectors trong Reach