Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Máy chủ MCP của Google Home

Tiếp cận sớm

Máy chủ Giao thức ngữ cảnh mô hình (MCP) của Google Home cho phép các công cụ cho nhà phát triển và trợ lý ảo dựa trên AI tương tác trực tiếp với môi trường nhà thông minh. Bằng cách hiển thị các công cụ MCP và giao diện RPC tiêu chuẩn, máy chủ cho phép Mô hình ngôn ngữ lớn (LLM) kiểm tra cấu trúc nhà, theo dõi trạng thái thiết bị, thực thi các hành động điều khiển và phân tích các sự kiện trong quá khứ.

Cảnh báo!

Khi kết nối một ngôi nhà thực tế với một tác nhân AI, tác nhân đó có thể thay mặt bạn điều khiển các thiết bị. Home MCP thực thi các giới hạn về tốc độ và biện pháp bảo vệ an toàn, chẳng hạn như cấm các hành động nhạy cảm như mở khoá cửa. Tuy nhiên, tuỳ thuộc vào tác nhân, việc kết nối tác nhân đó với Home MCP có thể dẫn đến hành vi không mong muốn hoặc thậm chí là không mong muốn. Xem xét kỹ lưỡng chính sách và điều khoản dịch vụ dành cho nhà phát triển.

Nếu chọn kết nối một thiết bị Google Home mà các thành viên khác trong hộ gia đình sử dụng với Home MCP, bạn nên thông báo cho họ rằng tác nhân của bạn có thể điều khiển các thiết bị và truy cập vào dữ liệu nhà. Ngoài ra, bạn có thể tạo một nhà bổ sung và thiết lập thiết bị để phát triển và thử nghiệm.

Bạn có thể thu hồi quyền truy cập của tác nhân vào Home MCP bất cứ lúc nào trên Google Home app (GHA) hoặc trang Tài khoản của tôi.

Tổng quan

Máy chủ MCP đóng vai trò là proxy giữa cơ sở hạ tầng nhà thông minh và các ứng dụng AI. Máy chủ MCP Home cung cấp các công cụ có thể thực thi, cho phép các ứng dụng AI truy vấn dữ liệu đo từ xa theo thời gian thực của nhà và đưa ra lệnh.

Các chức năng chính

Máy chủ MCP Home cung cấp một số chức năng cốt lõi:

Khám phá cấu trúc: Truy xuất các ngôi nhà và cấu trúc có thể truy cập bằng cách sử dụng list_homes.
Khám phá tài nguyên: Liệt kê các thiết bị, bố cục khu vực, đặc điểm, thuộc tính và giản đồ lệnh bằng list_home_resources.
Giám sát trạng thái: Kiểm tra trạng thái kết nối của thiết bị theo thời gian thực và trạng thái đặc điểm bằng list_home_states.
Điều khiển thiết bị: Thực thi các lệnh hành động có tham số trên thiết bị mục tiêu bằng run_home_actions.
Phân tích nhật ký: Truy vấn các thay đổi về trạng thái và nhật ký sự kiện trong quá khứ trong các phạm vi thời gian cụ thể bằng list_home_history.

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

Trước khi thiết lập máy chủ MCP Home, hãy đảm bảo bạn có những thông tin sau:

Một chế độ thiết lập nhà thông minh đang hoạt động trong Google Home với các thiết bị thông minh đã kết nối.
Một gói thuê bao Google Home Premium Advanced đang hoạt động.
Quyền truy cập vào một dự án Google Cloud.
Một ứng dụng hoặc ứng dụng AI tương thích với MCP, chẳng hạn như Google Antigravity, Claude Cowork hoặc OpenClaw.

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

Để thiết lập máy chủ MCP, bạn cần tạo một dự án Google Cloud, xin phê duyệt quyền truy cập, bật Home API và tạo thông tin đăng nhập OAuth.

Tạo một dự án trên Google Cloud

Nếu chưa có Google Cloud, bạn phải tạo một tài khoản:

Mở bảng điều khiển Google Cloud.
Tạo một dự án Google Cloud mới.

Để biết thêm thông tin, hãy xem bài viết Tạo dự án trong tài liệu về Google Cloud.

Bật Home API

Trong trình đơn điều hướng của bảng điều khiển Google Cloud, hãy chọn API và dịch vụ > API và dịch vụ đã bật.
Tìm Home API rồi nhấp vào Bật.

Định cấu hình thông tin xác thực và sự đồng ý của OAuth

Định cấu hình màn hình xin phép bằng OAuth:
1. Mở API và dịch vụ > Màn hình xin phép bằng OAuth.
2. Chọn đối tượng Bên ngoài, nhấp vào Bắt đầu rồi điền thông tin bắt buộc về ứng dụng và email liên hệ.
Tạo mã ứng dụng OAuth:
1. Mở API và Dịch vụ > Thông tin xác thực.
2. Nhấp vào + Tạo thông tin xác thực rồi chọn Mã ứng dụng khách OAuth.
3. Đặt Application type (Loại ứng dụng) thành Web application (Ứng dụng web).
4. Thêm URI chuyển hướng được uỷ quyền tương ứng với ứng dụng AI mục tiêu:
  - Google Antigravity: https://antigravity.google/oauth-callback
  - Claude Cowork: https://claude.ai/api/mcp/auth_callback
  - OpenClaw: URI chuyển hướng do bản cài đặt OpenClaw cục bộ của bạn chỉ định
5. Nhấp vào Create (Tạo) rồi sao chép Client ID (Mã ứng dụng khách) và Client Secret (khoá bí mật của ứng dụng khách) vào một vị trí an toàn.
Xuất bản ứng dụng:
1. Mở Nền tảng xác thực của Google > Đối tượng.
2. Trong phần Trạng thái xuất bản, hãy nhấp vào Xuất bản ứng dụng.

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

Bạn có thể định cấu hình một số môi trường phát triển AI để kết nối với máy chủ MCP Home bằng phương thức xác thực OAuth. Nhập Mã ứng dụng khách OAuth và Khoá bí mật của ứng dụng khách tại đây, sau đó làm theo hướng dẫn thiết lập mà bạn muốn.

Enter your Client ID: YOUR_CLIENT_ID
Enter your Client Secret: YOUR_CLIENT_SECRET

Thiết lập tự động bằng câu lệnh

Nếu trợ lý AI của bạn hỗ trợ quản lý cấu hình công cụ MCP ngay trong cuộc trò chuyện, bạn có thể hướng dẫn trợ lý định cấu hình máy chủ bằng cách dán câu lệnh sau:

Please configure the Home MCP server for me with these settings:
- Name: home_mcp
- Server URL: https://home.googleapis.com/mcp
- Transport: sse
- OAuth Scope: https://www.googleapis.com/auth/home.platform.v2
- Client ID: YOUR_CLIENT_ID
- Client Secret: YOUR_CLIENT_SECRET

Thiết lập thủ công

Chọn công cụ AI bạn muốn dùng để xem hướng dẫn thiết lập thủ công.

Antigravity

Google Antigravity cung cấp tính năng tích hợp sẵn cho các máy chủ MCP trên môi trường CLI, IDE và máy tính.

Mở trình đơn cấu hình ứng dụng: Cài đặt > Cài đặt nâng cao > Tuỳ chỉnh > Mở cấu hình MCP.

Thêm mục home_mcp vào trong đối tượng cấu hình mcpServers:

{
  "mcpServers": {
    "home_mcp": {
      "serverUrl": "https://home.googleapis.com/mcp",
      "oauth": {
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

Hoàn tất quy trình xác thực: Chuyển đến phần Settings (Cài đặt) > Advanced settings (Cài đặt nâng cao) > Customizations (Tuỳ chỉnh) > home_mcp > Authentication (Xác thực).
Hoàn tất quy trình cấp quyền cho Google Home trong trình duyệt web, chọn cấu trúc nhà của bạn rồi sao chép mã uỷ quyền vào Antigravity.

Để biết thêm thông tin, hãy xem tài liệu về Google Antigravity.

Claude

Định cấu hình Claude Cowork để kết nối với máy chủ MCP tuỳ chỉnh tại nhà:

Mở Claude Connectors.
Nhấp vào biểu tượng + rồi chọn Thêm trình kết nối tuỳ chỉnh.
Nhập URL của máy chủ: https://home.googleapis.com/mcp.
Nhấp vào Cài đặt nâng cao rồi nhập Mã ứng dụng khách và khoá bí mật của ứng dụng khách.
Nhấp vào Thêm rồi hoàn tất quy trình uỷ quyền OAuth trong trình duyệt.
Trong cuộc trò chuyện với Cowork, hãy nhấp vào biểu tượng + ở góc dưới bên trái, chọn Trình kết nối rồi bật home_mcp.

Để biết thêm thông tin, hãy xem tài liệu về Nền tảng Claude.

OpenClaw

Định cấu hình OpenClaw để kết nối với phương thức truyền tải SSE từ xa bằng phương thức xác thực OAuth:

Chuẩn bị khối JSON của bản vá cấu hình:

{
  "mcp": {
    "servers": {
      "home_mcp": {
        "url": "https://home.googleapis.com/mcp",
        "transport": "sse",
        "auth": "oauth",
        "oauth": {
          "scope": "https://www.googleapis.com/auth/home.platform.v2",
          "redirectUrl": "[YOUR_OPENCLAW_REDIRECT_URL]"
        },
        "env": {
          "CLIENT_ID": "YOUR_CLIENT_ID",
          "CLIENT_SECRET": "YOUR_CLIENT_SECRET"
        }
      }
    }
  }
}

Áp dụng bản vá cấu hình trong dòng lệnh:
```
openclaw config patch --stdin
```
Khởi động lại cổng OpenClaw:
```
openclaw gateway restart
```
Bắt đầu quy trình xác thực:
```
openclaw mcp login home_mcp
```
Truy cập vào URL uỷ quyền đã tạo để đăng nhập và cấp quyền truy cập.

Để biết thêm thông tin, hãy xem tài liệu về OpenClaw.

Đồng ý với tính năng Khuôn mặt quen thuộc

Để truy cập vào dữ liệu về khuôn mặt quen thuộc trong MCP của Home, người dùng phải đồng ý rõ ràng với tính năng này một cách riêng biệt.

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

Người dùng đồng ý phải là người quản lý cấu trúc Google Home.
Nhà của người dùng phải có ít nhất một camera hoặc chuông cửa Google Nest tương thích và một gói thuê bao Google Home Premium đang hoạt động, đồng thời đã bật tính năng Phát hiện khuôn mặt quen thuộc cho mỗi camera hoặc chuông cửa.
Ứng dụng của bạn phải có Mã ứng dụng khách OAuth 2.0 được tạo trong Google Cloud. Hãy xem phần Định cấu hình ứng dụng AI để tạo ứng dụng OAuth 2.0 nếu bạn chưa làm việc này.

Đường liên kết đến thông tin về sự đồng ý

Để cấp quyền truy cập cho ứng dụng, bạn phải truy cập vào một đường liên kết đồng ý được cá nhân hoá bằng Mã ứng dụng khách OAuth 2.0 và Mã cấu trúc Home. Có hai cách để lấy đường liên kết đến thông báo yêu cầu đồng ý.

Sau khi bạn có đường liên kết, hãy truy cập vào đường liên kết đó và đồng ý.

Tác nhân tạo đường liên kết

Nếu tác nhân của bạn đã kết nối với Home MCP, thì tác nhân đó có thể tự động tìm Mã cấu trúc Home của bạn và tạo một đường liên kết có thể nhấp vào.

Cập nhật các tham số sau ngay trên trang này, sau đó sao chép và dán câu lệnh tuỳ chỉnh vào cuộc trò chuyện của nhân viên hỗ trợ.

CLIENT_ID — Mã ứng dụng khách OAuth 2.0 của bạn từ Google Cloud. Ví dụ: `123456789-xyz.apps.googleusercontent.com`.
STRUCTURE_NAME — Tên của cấu trúc Home mục tiêu.

Please query my Home MCP to find the
Structure ID for my home named STRUCTURE_NAME. Once found, display
the structure name and ID, generate my clickable Familiar Faces Consent Link by
replacing <STRUCTURE_ID> in this URL with the structure ID you found:
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=<STRUCTURE_ID>&features=1&continue=https%3A%2F%2Fhome.google.com

Bạn tạo đường liên kết

Cập nhật các tham số sau ngay trên trang này, sau đó mở đường liên kết tuỳ chỉnh trong trình duyệt web.

CLIENT_ID — Mã ứng dụng khách OAuth 2.0 của bạn từ Google Cloud. Ví dụ: `123456789-xyz.apps.googleusercontent.com`.
STRUCTURE_ID — UUID của cấu trúc Home mục tiêu. Cách dễ nhất để lấy mã này là hỏi tác nhân của bạn bằng cách sử dụng MCP nhà, "Cho tôi biết mã cấu trúc (UUID) của [Tên cấu trúc]."

https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

Xác minh kết nối và chức năng

Sau khi ứng dụng của bạn được định cấu hình và xác thực, hãy xác minh kết nối máy chủ:

Khởi chạy phiên làm việc với trợ lý AI hoặc không gian làm việc.
Kiểm tra các kết nối máy chủ MCP đang hoạt động (trong Antigravity, hãy chạy /mcp hoặc kiểm tra danh sách công cụ).
Xác nhận rằng home_mcp có trong danh sách các công cụ đang hoạt động.
Đưa ra câu lệnh mẫu cho trợ lý để kiểm tra các chức năng:
- Khám phá thực thể: How many lights do I have in my house?
- Giám sát trạng thái theo thời gian thực: Is my home secured?
- Điều khiển thiết bị: Turn off all the outside lights.
- Phân tích sự kiện trong quá khứ: What happened while I was out?
Cấp quyền thực thi công cụ khi được ứng dụng nhắc. Trợ lý AI có thể truy xuất dữ liệu trạng thái theo thời gian thực và tất cả câu trả lời sẽ dựa trên dữ liệu đo từ xa của nhà bạn.

Hỗ trợ

Để được hỗ trợ phát triển MCP cho nhà thông minh, hãy truy cập vào Cộng đồng trợ giúp về Nhà thông minh dành cho nhà phát triển. Tại đây, bạn có thể đăng câu hỏi để được trợ giúp hoặc xem qua các câu hỏi đã đăng trước đó để xem câu hỏi của bạn đã được trả lời hay chưa.

Để gửi lỗi hoặc yêu cầu về tính năng của MCP, hãy truy cập vào công cụ theo dõi lỗi công khai của chúng tôi.

Vấn đề đã biết

Thực thi quyền — Chỉ những người dùng có gói thuê bao Google Home Premium Advanced mới có thể truy cập vào MCP chính. Hiện tại, một lỗi đang cho phép người đăng ký Nest Aware Plus có quyền truy cập vào Home MCP. Chúng tôi đang nỗ lực giải quyết vấn đề này và sẽ sớm phát hành bản sửa lỗi.
Kiểm thử đặc điểm — Để cung cấp bộ chức năng rộng nhất cho các tác nhân, chúng tôi đã thêm một số đặc điểm được đánh dấu là thử nghiệm. Bạn có thể gặp phải trường hợp các đặc điểm thử nghiệm này không hoạt động như mong đợi. Nếu có, vui lòng sử dụng công cụ theo dõi lỗi công khai để báo cáo.
Độ trễ — Đôi khi, bạn có thể nhận thấy độ trễ lâu hơn dự kiến khi sử dụng Home MCP. Chúng tôi đang nỗ lực tối ưu hoá. Dự kiến sẽ có những cải tiến về độ trễ trong các bản phát hành sau này.

Sắp có

Tự động hoá — Tính năng tạo và quản lý quy trình tự động hoá bằng Home MCP hiện chưa được hỗ trợ. Chúng tôi đang nỗ lực phát triển chức năng này và dự định sẽ phát hành tính năng hỗ trợ tự động hoá trong một bản phát hành sau này.

Máy chủ MCP của Google Home Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

warning Cảnh báo!

Tổng quan

Các chức năng chính

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

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

Tạo một dự án trên Google Cloud

Bật Home API

Định cấu hình thông tin xác thực và sự đồng ý của OAuth

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

Thiết lập tự động bằng câu lệnh

Thiết lập thủ công

Antigravity

Claude

OpenClaw

Đồng ý với tính năng Khuôn mặt quen thuộc

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

Đường liên kết đến thông tin về sự đồng ý

Tác nhân tạo đường liên kết

Bạn tạo đường liên kết

Xác minh kết nối và chức năng

Hỗ trợ

Vấn đề đã biết

Sắp có

Máy chủ MCP của Google Home

Cảnh báo!