เซิร์ฟเวอร์ MCP ของ Google Home

   ทดลองใช้ก่อนเปิดตัว   

เซิร์ฟเวอร์ Model Context Protocol (MCP) ของ Google Home ช่วยให้เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์และผู้ช่วยเสมือนที่ทำงานด้วยระบบ AI สามารถโต้ตอบกับสภาพแวดล้อมสมาร์ทโฮมได้โดยตรง เซิร์ฟเวอร์ช่วยให้โมเดลภาษาขนาดใหญ่ (LLM) ตรวจสอบโครงสร้างบ้าน ตรวจสอบสถานะอุปกรณ์ ดำเนินการควบคุม และวิเคราะห์เหตุการณ์ที่ผ่านมาได้โดยการแสดงเครื่องมือ MCP มาตรฐานและอินเทอร์เฟซ RPC

คำเตือน

การเชื่อมต่อบ้านจริงกับ AI Agent ช่วยให้ Agent ดังกล่าวควบคุมอุปกรณ์ในนามของคุณได้ MCP สำหรับบ้านจะบังคับใช้การจำกัดอัตราคำขอและการป้องกันด้านความปลอดภัย เช่น การห้ามดำเนินการที่มีความละเอียดอ่อนอย่างการปลดล็อกประตู อย่างไรก็ตาม การเชื่อมต่อ Agent กับ Home MCP อาจส่งผลให้เกิดลักษณะการทำงานที่ไม่คาดคิดหรือไม่พึงประสงค์ ทั้งนี้ขึ้นอยู่กับ Agent ของคุณ อ่านนโยบายและข้อกำหนดในการให้บริการของนักพัฒนาแอปอย่างละเอียด

หากเลือกเชื่อมต่อ Google Home ที่สมาชิกในครอบครัวคนอื่นๆ ใช้กับ Home MCP คุณควรแจ้งให้สมาชิกเหล่านั้นทราบว่าตัวแทนของคุณสามารถควบคุมอุปกรณ์และเข้าถึงข้อมูลบ้านได้ หรือจะสร้างบ้านเพิ่มและตั้งค่าอุปกรณ์สำหรับการพัฒนาและการทดสอบก็ได้

คุณสามารถเพิกถอนสิทธิ์เข้าถึง Home MCP ของตัวแทนได้ทุกเมื่อจาก Google Home app (GHA) หรือหน้าบัญชีของฉัน

ภาพรวม

เซิร์ฟเวอร์ MCP ทำหน้าที่เป็นพร็อกซีระหว่างโครงสร้างพื้นฐานของสมาร์ทโฮมกับแอปพลิเคชัน AI เซิร์ฟเวอร์ MCP ของ Home จะแสดงเครื่องมือที่เรียกใช้ได้ซึ่งช่วยให้ไคลเอ็นต์ AI สามารถค้นหาข้อมูลการตรวจวัดระยะไกลของบ้านแบบเรียลไทม์และออกคำสั่งได้

ความสามารถหลัก

เซิร์ฟเวอร์ MCP ของ Home มีความสามารถหลักหลายด้าน ดังนี้

  • การค้นหาบ้าน: ดึงข้อมูลบ้านและโครงสร้างที่เข้าถึงได้โดยใช้ list_homes
  • การค้นหาทรัพยากร: แสดงรายการอุปกรณ์ เลย์เอาต์พื้นที่ ลักษณะ แอตทริบิวต์ และสคีมาคำสั่งโดยใช้ list_home_resources
  • การตรวจสอบสถานะ: ตรวจสอบสถานะการเชื่อมต่ออุปกรณ์และสถานะลักษณะแบบเรียลไทม์โดยใช้ list_home_states
  • การควบคุมอุปกรณ์: ดำเนินการคำสั่งการทำงานที่มีพารามิเตอร์ในอุปกรณ์เป้าหมายโดยใช้ run_home_actions
  • การวิเคราะห์ข้อมูลย้อนหลัง: ค้นหาการเปลี่ยนแปลงสถานะและบันทึกเหตุการณ์ที่ผ่านมาในช่วงเวลาที่เจาะจงโดยใช้ list_home_history

ข้อกำหนดเบื้องต้น

ก่อนตั้งค่าเซิร์ฟเวอร์ MCP ของ Home โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้

  • การตั้งค่าสมาร์ทโฮมที่ใช้งานอยู่ใน Google Home พร้อมอุปกรณ์ที่เชื่อมต่อ
  • การสมัครใช้บริการ Google Home Premium Advanced ที่ใช้งานอยู่
  • สิทธิ์เข้าถึงโปรเจ็กต์ Google Cloud
  • ไคลเอ็นต์หรือแอปพลิเคชัน AI ที่เข้ากันได้กับ MCP เช่น Google Antigravity, Claude Cowork หรือ OpenClaw

กำหนดค่าเซิร์ฟเวอร์ MCP

การตั้งค่าเซิร์ฟเวอร์ MCP ต้องสร้างโปรเจ็กต์ Google Cloud, รับการอนุมัติการเข้าถึง, เปิดใช้ Home API และสร้างข้อมูลเข้าสู่ระบบ OAuth

สร้างโปรเจ็กต์ Google Cloud

หากยังไม่มี Google Cloud คุณต้องสร้างบัญชีโดยทำดังนี้

  1. เปิดคอนโซล Google Cloud
  2. สร้างโปรเจ็กต์ Google Cloud ใหม่

ดูข้อมูลเพิ่มเติมได้ที่บทความสร้างโปรเจ็กต์ในเอกสารประกอบของ Google Cloud

เปิดใช้ Home API

  1. ในเมนูการนำทางของคอนโซล Google Cloud ให้เลือก API และบริการ > API และบริการที่เปิดใช้
  2. ค้นหา Home API แล้วคลิกเปิดใช้
  1. กำหนดค่าหน้าจอขอความยินยอม OAuth ดังนี้
    1. เปิด API และบริการ > หน้าจอขอความยินยอม OAuth
    2. เลือกกลุ่มเป้าหมายภายนอก คลิกเริ่มต้นใช้งาน แล้วกรอกข้อมูลแอปและอีเมลติดต่อที่จำเป็น
  2. สร้างรหัสไคลเอ็นต์ OAuth โดยทำดังนี้
    1. เปิด API และบริการ > ข้อมูลเข้าสู่ระบบ
    2. คลิก + สร้างข้อมูลเข้าสู่ระบบ แล้วเลือกรหัสไคลเอ็นต์ OAuth
    3. ตั้งค่าประเภทแอปพลิเคชันเป็นเว็บแอปพลิเคชัน
    4. เพิ่ม URI การเปลี่ยนเส้นทางที่ได้รับอนุญาตซึ่งสอดคล้องกับไคลเอ็นต์ AI เป้าหมาย ดังนี้
      • Google Antigravity: https://antigravity.google/oauth-callback
      • Claude Cowork: https://claude.ai/api/mcp/auth_callback
      • OpenClaw: URI การเปลี่ยนเส้นทางที่ระบุโดยการติดตั้ง OpenClaw ในเครื่อง
    5. คลิกสร้าง แล้วคัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ไปยังตำแหน่งที่ปลอดภัย
  3. เผยแพร่แอปพลิเคชันโดยทำดังนี้
    1. เปิด Google Auth Platform > กลุ่มเป้าหมาย
    2. ในส่วนสถานะการเผยแพร่ ให้คลิกเผยแพร่แอป

กำหนดค่าไคลเอ็นต์ AI

คุณสามารถกำหนดค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ AI หลายรายการเพื่อเชื่อมต่อกับเซิร์ฟเวอร์ Home MCP โดยใช้การตรวจสอบสิทธิ์ OAuth ป้อนรหัสไคลเอ็นต์ OAuth และรหัสลับไคลเอ็นต์ที่นี่ แล้วทำตามวิธีการตั้งค่าที่ต้องการ

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

การตั้งค่าอัตโนมัติโดยใช้พรอมต์

หากผู้ช่วย AI รองรับการจัดการการกำหนดค่าเครื่องมือ MCP จากแชทโดยตรง คุณสามารถสั่งให้ผู้ช่วยกำหนดค่าเซิร์ฟเวอร์ได้โดยวางพรอมต์ต่อไปนี้

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

ตั้งค่าด้วยตนเอง

เลือกเครื่องมือ AI ที่ต้องการเพื่อดูวิธีการตั้งค่าด้วยตนเอง

Antigravity

Google Antigravity มีการผสานรวมในตัวสำหรับเซิร์ฟเวอร์ MCP ในสภาพแวดล้อม CLI, IDE และเดสก์ท็อป

  1. เปิดเมนูการกำหนดค่าแอปพลิเคชัน: Settings > Advanced settings > Customizations > Open MCP Config

  2. เพิ่มรายการ home_mcp ใต้ออบเจ็กต์การกำหนดค่า mcpServers ดังนี้

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

  3. ดำเนินการตรวจสอบสิทธิ์ให้เสร็จสมบูรณ์: ไปที่การตั้งค่า > การตั้งค่าขั้นสูง > การปรับแต่ง > home_mcp > การตรวจสอบสิทธิ์

  4. ทำตามขั้นตอนการให้สิทธิ์ Google Home ในเว็บเบราว์เซอร์ให้เสร็จสมบูรณ์ เลือกโครงสร้างบ้าน แล้วคัดลอกรหัสการให้สิทธิ์กลับไปที่ Antigravity

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ Google Antigravity

Claude

กำหนดค่า Claude Cowork ให้เชื่อมต่อกับเซิร์ฟเวอร์ MCP ในบ้านที่กำหนดเองโดยทำดังนี้

  1. เปิด Claude Connectors
  2. คลิก + แล้วเลือกเพิ่มเครื่องมือเชื่อมต่อที่กำหนดเอง
  3. ป้อน URL ของเซิร์ฟเวอร์: https://home.googleapis.com/mcp
  4. คลิก Advanced settings แล้วป้อน Client ID และ รหัสลับไคลเอ็นต์
  5. คลิกเพิ่ม แล้วทำตามขั้นตอนการให้สิทธิ์ OAuth ในเบราว์เซอร์ให้เสร็จสมบูรณ์
  6. ในแชท Cowork ให้คลิก + ที่มุมซ้ายล่าง เลือกเครื่องมือเชื่อมต่อ แล้วเปิด home_mcp

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของแพลตฟอร์ม Claude

OpenClaw

กำหนดค่า OpenClaw เพื่อเชื่อมต่อกับการรับส่ง SSE ระยะไกลด้วยการตรวจสอบสิทธิ์ OAuth โดยทำดังนี้

  1. เตรียมบล็อก JSON ของแพตช์การกำหนดค่า ดังนี้

    {
  "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"
        }
      }
    }
  }
}

  2. ใช้แพตช์การกำหนดค่าในเทอร์มินัลโดยทำดังนี้

    openclaw config patch --stdin

  3. รีสตาร์ทเกตเวย์ OpenClaw โดยทำดังนี้

    openclaw gateway restart

  4. เริ่มขั้นตอนการตรวจสอบสิทธิ์

    openclaw mcp login home_mcp

  5. ไปที่ URL การให้สิทธิ์ที่สร้างขึ้นเพื่อลงชื่อเข้าใช้และให้สิทธิ์เข้าถึง

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ OpenClaw

หากต้องการเข้าถึงข้อมูลใบหน้าที่คุ้นเคยใน MCP ของ Home ผู้ใช้ต้องให้ความยินยอมอย่างชัดแจ้งสำหรับฟีเจอร์นี้แยกต่างหาก

ข้อกำหนดเบื้องต้น

  • ผู้ใช้ที่ให้ความยินยอมต้องเป็นผู้จัดการบ้าน Google Home
  • บ้านของผู้ใช้ต้องมีกล้องหรือกริ่งประตู Google Nest ที่เข้ากันได้อย่างน้อย 1 ตัว และการสมัครใช้บริการ Google Home Premium ที่ใช้งานอยู่ซึ่งเปิดใช้การตรวจจับใบหน้าที่คุ้นเคยสำหรับกล้องหรือกริ่งประตูแต่ละตัว
  • แอปพลิเคชันของคุณต้องมีรหัสไคลเอ็นต์ OAuth 2.0 ที่สร้างใน Google Cloud ดูหัวข้อกำหนดค่าไคลเอ็นต์ AI เพื่อสร้างไคลเอ็นต์ OAuth 2.0 หากยังไม่ได้ทำ

หากต้องการให้สิทธิ์เข้าถึงแอปพลิเคชัน คุณต้องไปที่ลิงก์ความยินยอมที่ปรับเปลี่ยนในแบบของคุณด้วยรหัสไคลเอ็นต์ OAuth 2.0 และรหัสโครงสร้าง Home คุณรับลิงก์ความยินยอมได้ 2 วิธี

เมื่อได้รับลิงก์แล้ว ให้ไปที่ลิงก์และให้ความยินยอม

หาก Agent เชื่อมต่อกับ Home MCP อยู่แล้ว ก็จะค้นหาHomeรหัสบ้านและสร้างลิงก์ที่พร้อมคลิกได้โดยอัตโนมัติ

อัปเดตพารามิเตอร์ต่อไปนี้โดยตรงในหน้านี้ จากนั้นคัดลอกและวางพรอมต์ที่กำหนดเองลงในแชทของ Agent

  • CLIENT_ID — รหัสไคลเอ็นต์ OAuth 2.0 จาก Google Cloud เช่น `123456789-xyz.apps.googleusercontent.com`
  • STRUCTURE_NAME - ชื่อของโครงสร้าง Home ปลายทาง
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

หาก Agent เชื่อมต่อกับ Home MCP อยู่แล้ว ก็จะค้นหาHomeรหัสบ้านและสร้างลิงก์ที่พร้อมคลิกได้โดยอัตโนมัติ

อัปเดตพารามิเตอร์ต่อไปนี้โดยตรงในหน้านี้ แล้วเปิดลิงก์ที่กำหนดเองในเว็บเบราว์เซอร์

  • CLIENT_ID — รหัสไคลเอ็นต์ OAuth 2.0 จาก Google Cloud เช่น `123456789-xyz.apps.googleusercontent.com`
  • STRUCTURE_ID — UUID ของบ้าน Home เป้าหมาย วิธีที่ง่ายที่สุดในการรับข้อมูลนี้คือการถาม Agent โดยใช้ MCP ของ Home ว่า "บอกรหัสบ้าน (UUID) ของ [ชื่อบ้าน] ให้ฉันหน่อย"
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

ยืนยันการเชื่อมต่อและฟังก์ชันการทำงาน

เมื่อกำหนดค่าและตรวจสอบสิทธิ์ไคลเอ็นต์แล้ว ให้ยืนยันการเชื่อมต่อเซิร์ฟเวอร์โดยทำดังนี้

  1. เปิดเซสชันผู้ช่วย AI หรือ Workspace
  2. ตรวจสอบการเชื่อมต่อเซิร์ฟเวอร์ MCP ที่ใช้งานอยู่ (ใน Antigravity ให้เรียกใช้ /mcp หรือตรวจสอบรายการเครื่องมือ)
  3. ตรวจสอบว่า home_mcp อยู่ในรายการเครื่องมือที่ใช้งานอยู่

  4. ส่งพรอมต์ตัวอย่างไปยังผู้ช่วยเพื่อทดสอบความสามารถต่างๆ ดังนี้

    • การค้นพบเอนทิตี: How many lights do I have in my house?
    • การตรวจสอบสถานะแบบเรียลไทม์: Is my home secured?
    • การควบคุมอุปกรณ์: Turn off all the outside lights.
    • การวิเคราะห์เหตุการณ์ที่ผ่านมา: What happened while I was out?

  5. ให้สิทธิ์การเรียกใช้เครื่องมือเมื่อได้รับข้อความแจ้งจากไคลเอ็นต์ ผู้ช่วย AI สามารถดึงข้อมูลสถานะแบบเรียลไทม์ และคำตอบทั้งหมดจะอิงตามข้อมูลการตรวจวัดระยะไกลของบ้าน

การสนับสนุน

หากต้องการการสนับสนุนด้านการพัฒนา Home MCP โปรดไปที่ชุมชนความช่วยเหลือของสมาร์ทโฮมสำหรับนักพัฒนาซอฟต์แวร์ คุณสามารถโพสต์คำถามเพื่อขอความช่วยเหลือ หรือดูคำถามที่โพสต์ไว้ก่อนหน้านี้เพื่อดูว่ามีคำตอบสำหรับคำถามของคุณแล้วหรือไม่

หากต้องการรายงานข้อบกพร่องหรือส่งคำขอฟีเจอร์ของ MCP โปรดไปที่เครื่องมือติดตามปัญหาแบบสาธารณะ

ปัญหาที่ทราบ

  • การบังคับใช้การให้สิทธิ์ - การเข้าถึง MCP ของ Home ควรจำกัดไว้สำหรับผู้ใช้ที่มีการสมัครใช้บริการ Google Home Premium Advanced ปัจจุบันข้อบกพร่องทำให้สมาชิก Nest Aware Plus มีสิทธิ์เข้าถึง Home MCP เรากำลังดำเนินการแก้ไขปัญหานี้และจะเผยแพร่การแก้ไขในเร็วๆ นี้
  • การทดสอบลักษณะ — เพื่อให้เอเจนต์มีชุดฟังก์ชันการทำงานที่กว้างที่สุด เราได้รวมลักษณะบางอย่างที่ทำเครื่องหมายว่าอยู่ระหว่างการทดสอบไว้ด้วย คุณอาจพบสถานการณ์ที่ลักษณะทดลองเหล่านี้ไม่ทำงานตามที่คาดไว้ หากเป็นเช่นนั้น โปรดใช้เครื่องมือติดตามปัญหาแบบสาธารณะเพื่อรายงาน
  • เวลาในการตอบสนอง — บางครั้งคุณอาจสังเกตเห็นเวลาในการตอบสนองที่นานกว่าที่คาดไว้กับ Home MCP เรากำลังดำเนินการเพิ่มประสิทธิภาพอย่างเต็มที่ คาดว่าจะเห็นการปรับปรุงเวลาในการตอบสนองในรุ่นต่อๆ ไป

เร็วๆ นี้

  • การทำงานอัตโนมัติ — ขณะนี้ระบบยังไม่รองรับการสร้างและจัดการการทำงานอัตโนมัติด้วย Home MCP เรากำลังดำเนินการกับฟังก์ชันการทำงานนี้และวางแผนที่จะเปิดตัวการรองรับการทำงานอัตโนมัติในรุ่นต่อๆ ไป