Máy chủ Giao thức ngữ cảnh mô hình (MCP) dành cho nhà phát triển Google Home cho phép các công cụ phát triển dựa trên AI tìm kiếm thông tin sau đây và truy xuất thông tin theo thời gian thực, dành riêng cho từng miền:
- Trung tâm dành cho nhà phát triển Google Home
- OpenThread
- Thông số kỹ thuật Matter: Dùng cho phiên bản 1.5.1
Việc này giúp đảm bảo rằng các tác nhân và công cụ AI có thể cung cấp câu trả lời kỹ thuật chính xác liên quan đến các chương trình và công nghệ dành cho nhà phát triển Google Home.
Máy chủ MCP hoạt động như một proxy giữa dịch vụ bên ngoài cung cấp ngữ cảnh hoặc dữ liệu và ứng dụng AI (máy chủ lưu trữ). Máy chủ MCP dành cho nhà phát triển Home cung cấp các công cụ có thể thực thi, cho phép Mô hình ngôn ngữ lớn (LLM) tìm câu trả lời chính xác trực tiếp từ các tập hợp dữ liệu đã lập chỉ mục. Để tìm hiểu thêm về máy chủ MCP, hãy xem bài viết Giao thức ngữ cảnh mô hình (MCP) là gì và hoạt động như thế nào?.
Điều kiện tiên quyết
Để sử dụng máy chủ MCP dành cho nhà phát triển Home, bạn phải cài đặt trình chỉnh sửa hoặc ứng dụng AI tương thích với MCP.
Google Antigravity
Nếu bạn đang sử dụng môi trường phát triển AI của Google, hãy cài đặt một trong những công cụ sau:
- Antigravity CLI: Xem hướng dẫn Bắt đầu sử dụng Antigravity CLI
- Antigravity 2.0: Xem Tài liệu về Google Antigravity
- Antigravity IDE: Xem hướng dẫn Bắt đầu sử dụng Antigravity IDE
Trợ lý AI bên thứ ba
Bạn cũng có thể tích hợp MCP với các ứng dụng AI, công cụ dòng lệnh và trình chỉnh sửa mã khác, chẳng hạn như:
- Claude Code
- Con trỏ
- GitHub Copilot (VS Code)
Chọn một đường dẫn xác thực
Tuỳ thuộc vào yêu cầu tích hợp, bạn có thể kết nối với máy chủ MCP dành cho nhà phát triển Home bằng đường dẫn dùng thử chưa được xác thực hoặc khoá API đã xác thực.
Kiểm thử kết nối chưa được xác thực
Phương thức này không yêu cầu khoá API hoặc cấu hình Google Cloud. Phương thức này sử dụng hạn mức công khai được chia sẻ, giúp bạn dễ dàng dùng thử máy chủ và kiểm thử ngay các cơ chế cốt lõi.
Kết nối đã xác thực cho quá trình sản xuất
Để tránh bị giới hạn tốc độ trong hạn mức công khai được chia sẻ, bạn nên xác thực môi trường của mình để phát triển bền vững.
Đường dẫn này yêu cầu bạn phải có một dự án Google Cloud đang hoạt động.
- Trong bảng điều khiển Google Cloud, hãy bật API trên dự án của bạn:
- Mở trang API dành cho nhà phát triển Home trong thư viện API của Google.
- Kiểm tra để đảm bảo bạn đã chọn đúng dự án mà bạn định sử dụng API.
- Nhấp vào Bật.
Tạo khoá API:
- Chuyển đến trang Thông tin xác thực.
- Nhấp vào Tạo thông tin xác thực, sau đó chọn khoá API trong trình đơn.
- Trong trường Tên, hãy cung cấp tên cho khoá.
Nhấp vào trình đơn thả xuống Chọn hạn chế cho API, sau đó nhập API dành cho nhà phát triển Home. Nhấp vào kết quả, sau đó nhấp vào OK.
Nhấp vào Tạo.
Sau khi tạo khoá, hãy nhấp vào Hiện khoá để xem khoá đó và sao chép khoá cho bước tiếp theo.
Định cấu hình ứng dụng
Có một số môi trường phát triển có thể kết nối với máy chủ MCP dành cho nhà phát triển Home bằng cấu hình chưa được xác thực hoặc cấu hình xác thực. Hãy xem hướng dẫn cho từng môi trường để thiết lập máy chủ.
Enter your API key: YOUR_API_KEY
Antigravity
Mở tệp cấu hình ~/.gemini/config/mcp_config.json cục bộ rồi thêm mục HomeDevelopers vào đối tượng mcpServers.
Bất kể bạn sử dụng Antigravity CLI, Antigravity 2.0 hay
Antigravity IDE, tất cả các công cụ này đều dùng chung một tệp cấu hình
nằm tại ~/.gemini/config/mcp_config.json. Mọi thay đổi hoặc ánh xạ máy chủ mà bạn xác định trong tệp này sẽ tự động áp dụng cho cả 3 môi trường.
Chưa được xác thực
{
"mcpServers": {
"HomeDevelopers": {
"serverUrl": "https://homedevelopers.googleapis.com/mcp"
}
}
}
Đã xác thực
{
"mcpServers": {
"HomeDevelopers": {
"serverUrl": "https://homedevelopers.googleapis.com/mcp",
"headers": {
"X-Goog-Api-Key": "YOUR_API_KEY"
}
}
}
}
Claude
Để định cấu hình Claude Code, hãy chạy lệnh trong thư mục ứng dụng của bạn.
Chưa được xác thực
claude mcp add HomeDevelopers --transport http https://homedevelopers.googleapis.com/mcp
Đã xác thực
claude mcp add HomeDevelopers --transport http https://homedevelopers.googleapis.com/mcp --header "X-Goog-Api-Key: "YOUR_API_KEY"
Con trỏ
Để định cấu hình
Con trỏ,
hãy chỉnh sửa .cursor/mcp.json (cho một dự án cụ thể) hoặc
~/.cursor/mcp.json (cho tất cả dự án).
Chưa được xác thực
{
"mcpServers": {
"HomeDevelopers": {
"url": "https://homedevelopers.googleapis.com/mcp"
}
}
}
Đã xác thực
{
"mcpServers": {
"HomeDevelopers": {
"url": "https://homedevelopers.googleapis.com/mcp",
"headers": {
"X-Goog-Api-Key": "YOUR_API_KEY"
}
}
}
}
GitHub Copilot
Để định cấu hình GitHub Copilot trong VS Code cho một dự án, hãy chỉnh sửa tệp .vscode/mcp.json trong không gian làm việc của bạn. Ngoài ra, để cung cấp máy chủ
trên toàn cầu, hãy nhấp vào nút Open Settings (JSON) (Mở phần Cài đặt (JSON)) trong phần
cài đặt người dùng
rồi thêm JSON vào khoá gốc "mcp".
Chưa được xác thực
{
"servers": {
"HomeDevelopers": {
"url": "https://homedevelopers.googleapis.com/mcp"
}
}
}
Đã xác thực
{
"servers": {
"HomeDevelopers": {
"url": "https://homedevelopers.googleapis.com/mcp",
"headers": {
"X-Goog-Api-Key": "YOUR_API_KEY"
}
}
}
}
Xác minh quá trình cài đặt và thực thi
Sau khi cập nhật cấu hình công cụ, hãy xác minh kết nối bằng cách nhắc không gian làm việc của tác nhân.
Ví dụ về quy trình xác minh (Antigravity CLI)
Khởi chạy phiên không gian làm việc tương tác:
agy
Thực thi macro danh sách kiểm tra khám phá để kiểm tra các máy chủ MCP đang hoạt động:
/mcpXác nhận rằng HomeDevelopers (hoặc khoá tên máy chủ bạn chọn) xuất hiện trong danh sách các kết nối đang hoạt động.
Hỏi Google Home một câu hỏi, chẳng hạn như:
How do I create an Automation using Home APIs?Nếu Antigravity cho rằng việc đọc tài liệu dành cho nhà phát triển Google Home sẽ hữu ích, thì công cụ này sẽ yêu cầu quyền sử dụng các công cụ
search_documentscủa Máy chủ MCP dành cho nhà phát triển Home. Chọn bất kỳ tuỳ chọn Cho phép nào để tiếp tục.
Sau khi gọi công cụ và suy nghĩ, Antigravity sẽ trả lời truy vấn của bạn bằng một câu trả lời có căn cứ.
Video hướng dẫn
Xem video để biết hướng dẫn từng bước về cách cài đặt MCP dành cho nhà phát triển Home.
Giao thức kiểm thử API HTTP trực tiếp (cURL)
Đối với quá trình kiểm thử quy trình bên ngoài môi trường trình bao bọc ứng dụng, bạn có thể gửi các tải trọng JSON-RPC tiêu chuẩn qua các kênh curl.
Khám phá các công cụ hệ thống đang hoạt động
curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"method": "tools/list",
"id": 1
}'
Thực thi truy vấn tìm kiếm chức năng
Chưa được xác thực
curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"method": "tools/call",
"id": 2,
"params": {
"name": "search_documents",
"arguments": {
"query": "How to create an automation?"
}
}
}'
Đã xác thực
curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json, text/event-stream' \
--header "X-Goog-Api-Key: "YOUR_API_KEY" \
--data '{
"jsonrpc": "2.0",
"method": "tools/call",
"id": 2,
"params": {
"name": "search_documents",
"arguments": {
"query": "How to create an automation?"
}
}
}'
Gửi phản hồi
Sử dụng biểu mẫu phản hồi của chúng tôi để gửi ý kiến và đề xuất của bạn về MCP dành cho nhà phát triển Home hoặc cách chúng tôi có thể cải thiện trải nghiệm của bạn với công cụ này.