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

Quyền 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ụ phát triển dựa trên AI và trợ lý ảo 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 tiêu chuẩn và giao diện RPC, máy chủ cho phép Các mô hình ngôn ngữ lớn (LLM) kiểm tra cấu trúc nhà, giám sát trạng thái thiết bị, thực hiện các hành động kiểm soát và phân tích các sự kiện trước đây.

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ị. MCP tại nhà 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à hành vi không mong đợi. Xem xét kỹ lưỡng các chính sách dành cho nhà phát triển và điều khoản dịch vụ.

Nếu chọn kết nối một Google Home mà các thành viên khác trong gia đình sử dụng với Home MCP, bạn nên thông báo cho họ rằng trợ lý 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 các thiết bị để phát triển và kiểm thử.

Bạn có thể thu hồi quyền truy cập của nhân viên hỗ trợ 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à một proxy giữa cơ sở hạ tầng nhà thông minh và các ứng dụng AI. Máy chủ MCP tại nhà 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 tại nhà theo thời gian thực và đưa ra các lệnh.

Các chức năng cốt lõi

Máy chủ MCP tại nhà cung cấp một số lĩnh vực chức năng cốt lõi:

Khám phá cấu trúc: Truy xuất các 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à lược đồ lệnh bằng cách sử dụ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 cách sử dụng list_home_states.
Điều khiển thiết bị: Thực thi các lệnh hành động được tham số hoá trên các thiết bị mục tiêu bằng cách sử dụng run_home_actions.
Phân tích dữ liệu trong quá khứ: 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 cách sử dụng list_home_history.

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

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

Thiết lập nhà thông minh đang hoạt động trong Google Home với các thiết bị đã 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 máy khách 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, nhận được sự chấp thuận cấp 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 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 đăng nhập và sự đồng ý qua OAuth

Định cấu hình màn hình xin phép OAuth:
1. Mở phần API và Dịch vụ > Màn hình xin phép 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 OAuth.
3. Đặt Loại ứng dụng thành Ứng dụng web.
4. Thêm các URI chuyển hướng được uỷ quyền tương ứng với các ứng dụng AI mục tiêu của bạn:
  - 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 Tạo rồi sao chép Mã ứng dụng và Khoá bí mật của ứng dụng vào một vị trí an toàn.
Xuất bản ứng dụng của bạn:
1. Mở Google Auth Platform > Audience (Đố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ủ HomeMCP 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 từ 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://preprod-home.sandbox.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 để 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 CLI, IDE và môi trường 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 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 Cài đặt > Cài đặt nâng cao > Tuỳ chỉnh > home_mcp > 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 và sao chép mã uỷ quyền trở lại 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 tại nhà tuỳ chỉnh:

Mở Claude Connectors.
Nhấp vào + 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 Cowork, hãy nhấp vào + ở 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 tiện 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 thiết bị đầu cuối:
```
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.

Sự đồng ý đối với khuôn mặt quen thuộc

Để truy cập vào dữ liệu khuôn mặt quen thuộc trong MCP của Trang chủ, 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 cấp sự đồng ý phải là người quản lý cấu trúc Google Home.
Cấu trúc của người dùng phải có ít nhất một camera hoặc chuông cửa Google Nesttương thích và gói thuê bao Google Home Premiumđang hoạt động có 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ột 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 một Ứng dụng OAuth 2.0 nếu bạn chưa làm.

Đường liên kết đến 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 OAuth 2.0 và Mã cấu trúc Home. Có hai cách để lấy đường liên kết yêu cầu đồng ý.

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

Nhân viên hỗ trợ tạo đường liên kết

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

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 tác nhân.

CLIENT_ID – Mã ứng dụng 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 đích.

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 mối liên kết

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

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

CLIENT_ID – Mã ứng dụng 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 đích. Cách dễ nhất để lấy thông tin này là yêu cầu trợ lý của bạn bằng MCP của Home, "Tell me the structure ID (UUID) for [Structure Name]." (Cho tôi biết mã nhận dạng 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 bạn định cấu hình và xác thực máy khách, hãy xác minh kết nối máy chủ:

Khởi chạy trợ lý AI hoặc phiên Workspace.
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 liệt kê cùng với các công cụ đang hoạt động.
Đưa ra các câu lệnh mẫu cho trợ lý để kiểm thử nhiều 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?
- Thiết bị điều khiển: 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 khách 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ác phản hồi sẽ dựa trên dữ liệu đo từ xa tại nhà của bạn.

Hỗ trợ

Để được hỗ trợ phát triển MCP cho nhà, hãy truy cập vào Cộng đồng trợ giúp 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 đó để biết câu hỏi của bạn đã được trả lời hay chưa.

Để báo cáo lỗi hoặc yêu cầu về tính năng 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

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 của bạn, chúng tôi đã đưa vào một số đặc điểm được đánh dấu là thử nghiệm. Bạn có thể gặp phải những trường hợp mà 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 với Home MCP. Chúng tôi đang nỗ lực tối ưu hoá. Bạn có thể thấy độ trễ được cải thiện trong các bản phát hành sau này.

Sắp có

Tự động hoá – Hiện tại, chúng tôi không hỗ trợ việc tạo và quản lý quy trình tự động hoá bằng Home MCP. Chúng tôi đang nỗ lực để cung cấp 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 ở tương lai.

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 cốt lõi

Đ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 đăng nhập và sự đồng ý qua 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

Sự đồng ý đối với khuôn mặt quen thuộc

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

Đường liên kết đến sự đồng ý

Nhân viên hỗ trợ tạo đường liên kết

Bạn tạo mối 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!