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

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

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

คำเตือน

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

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

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

ภาพรวม

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

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

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

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

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

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

  • การตั้งค่าสมาร์ทโฮมที่ใช้งานอยู่ใน 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. คลิกสร้าง แล้วคัดลอก Client ID และ Client Secret ไปยัง ตำแหน่งที่ปลอดภัย
  3. เผยแพร่แอปพลิเคชันโดยทำดังนี้
    1. เปิด Google Auth Platform > Audience
    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://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

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

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

Antigravity

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

  1. เปิดเมนูการกำหนดค่าแอปพลิเคชัน: การตั้งค่า > การตั้งค่าขั้นสูง > การปรับแต่ง > เปิดการกำหนดค่า MCP

  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. คลิกการตั้งค่าขั้นสูง แล้วป้อน Client ID (รหัสไคลเอ็นต์) และ Client Secret (รหัสลับไคลเอ็นต์)
  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 ของบ้าน ผู้ใช้ต้องให้ความยินยอมอย่างชัดแจ้งสำหรับ ฟีเจอร์นี้แยกต่างหาก

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

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

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

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

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

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

  • 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 เชื่อมต่อกับ MCP ของ Home อยู่แล้ว Agent จะ ค้นหา Home Structure ID โดยอัตโนมัติและ สร้างลิงก์ที่พร้อมคลิก

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

  • CLIENT_ID — รหัสไคลเอ็นต์ OAuth 2.0 จาก Google Cloud เช่น `123456789-xyz.apps.googleusercontent.com`
  • STRUCTURE_ID — UUID ของโครงสร้าง Home เป้าหมาย วิธีที่ง่ายที่สุดในการ รับรหัสนี้คือการถามตัวแทนโดยใช้ Home MCP ว่า "บอกรหัสโครงสร้าง (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 หรือเซสชันพื้นที่ทำงาน
  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 สามารถดึงข้อมูลสถานะแบบเรียลไทม์และคำตอบทั้งหมดจะ อิงตามการวัดและส่งข้อมูลจากระยะไกลในบ้านของคุณ

การสนับสนุน

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

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

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

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

เร็วๆ นี้

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