שרת MCP של Google Home

   גישה מוקדמת   

שרת Model Context Protocol‏ (MCP) של Google Home מאפשר לכלים לפיתוח מבוססי-AI ולעוזרים וירטואליים ליצור אינטראקציה ישירה עם סביבות של בית חכם. השרת חושף כלים סטנדרטיים של MCP וממשקי RPC, וכך מאפשר למודלים גדולים של שפה (LLM) לבדוק את מבני הבית, לעקוב אחרי מצבי המכשירים, לבצע פעולות בקרה ולנתח אירועים היסטוריים.

אזהרה!

חיבור של בית אמיתי לסוכן AI מאפשר לסוכן לשלוט במכשירים בשמכם. ה-MCP של הבית מחיל מגבלות על קצב הבקשות ואמצעי הגנה, כמו איסור על פעולות רגישות כמו פתיחת דלתות. עם זאת, בהתאם לסוכן, חיבור שלו ל-Home MCP עלול לגרום להתנהגות לא צפויה או אפילו לא רצויה. חשוב לעיין בקפידה במדיניות המפתחים ובתנאים ובהגבלות.

אם אתם בוחרים לקשר ל-Home MCP מכשיר Google Home שנמצא בשימוש של בני בית אחרים, אתם צריכים להודיע להם שהסוכן שלכם יכול לשלוט במכשירים ולגשת לנתונים של הבית. אפשרות אחרת היא ליצור בית נוסף ולהגדיר מכשירים לפיתוח ולבדיקות.

אתם יכולים לבטל את הגישה של הסוכן ל-Home MCP בכל שלב דרך Google Home app (GHA) או הדף 'החשבונות שלי'.

סקירה כללית

שרת MCP משמש כשרת proxy בין תשתית הבית החכם לבין אפליקציות 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, בוחרים באפשרות APIs & Services (ממשקי API ושירותים) >‏ Enabled APIs & Services (ממשקי API ושירותים מופעלים).
  2. מחפשים את Home API ולוחצים על Enable.
  1. מגדירים את מסך ההסכמה ל-OAuth:
    1. פותחים את APIs & Services (ממשקי API ושירותים) > OAuth consent screen (מסך הסכמה ל-OAuth).
    2. בוחרים בקהל חיצוני, לוחצים על מתחילים וממלאים את פרטי האפליקציה הנדרשים ואת כתובת האימייל ליצירת קשר.
  2. יוצרים מזהה לקוח ב-OAuth:
    1. פותחים את APIs & Services ‏ > Credentials.
    2. לוחצים על + Create credentials (יצירת פרטי כניסה) ובוחרים באפשרות OAuth client ID (מזהה לקוח 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. לוחצים על Create ומעתיקים את Client ID ואת Client Secret למיקום מאובטח.
  3. פרסום האפליקציה:
    1. פותחים את פלטפורמת האימות של Google > קהל.
    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 Coworker להתחבר לשרת ה-MCP הביתי המותאם אישית:

  1. פותחים את Claude Connectors.
  2. לוחצים על + ובוחרים באפשרות הוספת מחבר בהתאמה אישית.
  3. מזינים את כתובת ה-URL של השרת: https://home.googleapis.com/mcp.
  4. לוחצים על הגדרות מתקדמות ומזינים את מזהה הלקוח ואת הסוד של הלקוח.
  5. לוחצים על הוספה ומשלימים את תהליך ההרשאה של OAuth בדפדפן.
  6. בצ'אט של Cowork, לוחצים על + בפינה הימנית התחתונה, בוחרים באפשרות מחברים ומפעילים את המתג home_mcp.

מידע נוסף זמין במסמכי התיעוד של Claude Platform.

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.

כדי לגשת לנתונים של פרצופים מוכרים במרכז הבקרה של חשבון Google, המשתמשים צריכים להביע הסכמה מפורשת לשימוש בתכונה הזו בנפרד.

דרישות מוקדמות

  • המשתמש שנותן את ההסכמה צריך להיות מנהל של המבנה Google Home.
  • בבית של המשתמש צריך להיות לפחות Google Nestמצלמה או פעמון דלת תואמיםGoogle Home Premium ומינוי פעיל עם זיהוי פנים מוכרות שמופעל עבור כל מצלמה או פעמון דלת.
  • לאפליקציה שלכם צריך להיות מזהה לקוח OAuth 2.0 שנוצר ב-Google Cloud. אם עוד לא עשיתם זאת, תוכלו לקרוא את המאמר הגדרת לקוח AI כדי ליצור לקוח OAuth 2.0.

כדי להעניק לאפליקציה גישה, צריך להיכנס לקישור להסכמה שמותאם אישית עם מזהה הלקוח שלכם ב-OAuth 2.0 ועם מזהה המבנה Home. יש שתי דרכים לקבל את הקישור לבקשת ההסכמה.

אחרי שמקבלים את הקישור, נכנסים אליו ומביעים הסכמה.

אם הסוכן שלכם כבר מחובר ל-MCP של Home, הוא יכול לאתר באופן אוטומטי את מזהה המבנה Home שלכם וליצור קישור שמוכן ללחיצה.

מעדכנים את הפרמטרים הבאים ישירות בדף הזה, ואז מעתיקים ומדביקים את ההנחיה המותאמת אישית בצ'אט של הסוכן.

  • ‫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

אם הסוכן שלכם כבר מחובר ל-MCP של Home, הוא יכול לאתר באופן אוטומטי את מזהה המבנה Home שלכם וליצור קישור שמוכן ללחיצה.

מעדכנים את הפרמטרים הבאים ישירות בדף הזה, ואז פותחים את הקישור המותאם אישית בדפדפן אינטרנט.

  • ‫CLIENT_ID — מזהה הלקוח ב-OAuth 2.0 מתוך Google Cloud. לדוגמה, ‎`123456789-xyz.apps.googleusercontent.com`.
  • ‫STRUCTURE_ID – ה-UUID של מבנה 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 יכול לאחזר נתוני מצב בזמן אמת, וכל התשובות מבוססות על טלמטריה של הבית.

תמיכה

כדי לקבל תמיכה בפיתוח של MCP לבית חכם, אפשר להיכנס לפורום העזרה של Smart Home for Developers. שם אפשר לפרסם שאלה כדי לקבל עזרה, או לעיין בשאלות שפורסמו בעבר כדי לבדוק אם כבר ניתנה תשובה לשאלה שלכם.

כדי לדווח על באג ב-MCP או להגיש בקשה להוספת תכונה, אפשר לעבור אל האתר הציבורי למעקב אחר בעיות.

בעיות מוכרות

  • בדיקת תכונות – כדי לספק את מגוון הפונקציות הרחב ביותר לסוכנים שלכם, הוספנו כמה תכונות שמסומנות כניסיוניות. יכול להיות שתיתקלו בתרחישים שבהם התכונות הניסיוניות האלה לא יפעלו כצפוי. אם כן, אפשר להשתמש בכלי הציבורי למעקב אחרי בעיות כדי לדווח על כך.
  • זמן אחזור (Latency) – לפעמים יכול להיות שתבחינו בזמן אחזור ארוך מהצפוי ב-Home MCP. אנחנו פועלים כרגע לביצוע אופטימיזציות. בגרסאות עתידיות צפויים שיפורים בנתוני ההשהיה.

בקרוב

  • אוטומציות – בשלב הזה אין תמיכה ביצירה ובניהול של אוטומציות באמצעות Home MCP. אנחנו עובדים על הפונקציונליות הזו ומתכננים להשיק תמיכה באוטומציות בגרסה עתידית.