خادم MCP في Google Home

   استخدام المنتج قبل إطلاقه   

يتيح خادم بروتوكول سياق النموذج (MCP) في Google Home لأدوات المطوّرين والمساعدين الافتراضيين المستندين إلى الذكاء الاصطناعي التفاعل مباشرةً مع بيئات المنازل المزوّدة بأجهزة ذكية. من خلال عرض أدوات بروتوكول سياق النموذج (MCP) العادية وواجهات استدعاء إجراء عن بُعد (RPC)، يتيح الخادم للنماذج اللغوية الكبيرة (LLM) فحص بُنى المنزل ومراقبة حالات الأجهزة وتنفيذ إجراءات التحكّم وتحليل الأحداث السابقة.

تحذير

يتيح ربط منزل حقيقي بوكيل ذكاء اصطناعي لهذا الوكيل التحكّم في الأجهزة نيابةً عنك. يفرض Home MCP حدودًا على معدّل الاستخدام وإجراءات حماية الأمان، مثل حظر الإجراءات الحساسة مثل فتح الأبواب. ومع ذلك، استنادًا إلى وكيلك، قد يؤدي ربطه بـ Home MCP إلى سلوك غير متوقع أو حتى غير مرغوب فيه. يُرجى مراجعة سياسات المطوّرين وبنود الخدمة بعناية.

إذا اخترت ربط Google Home المستخدَم من قِبل أفراد آخرين في الأسرة بـ Home MCP، عليك إعلامهم بأنّ وكيلك يمكنه التحكّم في الأجهزة والوصول إلى بيانات المنزل. بدلاً من ذلك، يمكنك إنشاء منزل إضافي وإعداد الأجهزة للتطوير والاختبار.

يمكنك إبطال إذن وصول وكيلك إلى Home MCP في أي وقت من خلال Google Home app (GHA) أو صفحة "حساباتي".

نظرة عامة

يعمل خادم MCP كخادم وكيل بين البنية الأساسية للمنزل المزوّد بأجهزة ذكية وتطبيقات الذكاء الاصطناعي. يتيح خادم "بروتوكول سياق النموذج" (MCP) في Home استخدام أدوات قابلة للتنفيذ تسمح لعملاء الذكاء الاصطناعي بطلب بيانات القياس عن بُعد في الوقت الفعلي وإصدار الأوامر.

الإمكانات الأساسية

يوفّر خادم Home MCP العديد من مجالات الإمكانات الأساسية:

  • استكشاف البنية: يمكنك استرداد المنازل والبُنى التي يمكن الوصول إليها باستخدام list_homes.
  • استكشاف الموارد: يمكنك عرض قائمة بالأجهزة وتخطيطات المناطق والسمات والخصائص ومخططات الأوامر باستخدام list_home_resources.
  • مراقبة الحالة: يمكنك التحقّق من حالة اتصال الجهاز وحالات السمات في الوقت الفعلي باستخدام list_home_states.
  • التحكّم في الجهاز: يمكنك تنفيذ أوامر إجراءات ذات مَعلمات على أجهزة الاختبار باستخدام run_home_actions.
  • التحليل السابق: يمكنك الاستعلام عن تغييرات الحالة السابقة وسجلّات الأحداث على مدار نطاقات زمنية محدّدة باستخدام list_home_history.

المتطلبات الأساسية

قبل إعداد خادم Home MCP، تأكَّد من توفّر ما يلي:

  • إعدادات نشطة للمنزل المزوّد بأجهزة ذكية في Google Home مع أجهزة متصلة
  • اشتراك نشط في Google Home Premium Advanced
  • الوصول إلى مشروع "Google Cloud"
  • تطبيق أو برنامج مستند إلى الذكاء الاصطناعي ومتوافق مع بروتوكول 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، اختَر واجهات برمجة التطبيقات والخدمات > واجهات برمجة التطبيقات والخدمات التي تم تفعيلها.
  2. ابحث عن Home API وانقر على تفعيل.
  1. اضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth:
    1. افتح واجهات برمجة التطبيقات والخدمات > شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
    2. اختَر الجمهور الخارجي، وانقر على البدء، ثم املأ معلومات التطبيق المطلوبة وعنوان البريد الإلكتروني لجهة الاتصال.
  2. أنشئ معرّف عميل OAuth:
    1. افتح واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.
    2. انقر على + إنشاء بيانات اعتماد واختَر معرِّف عميل OAuth.
    3. اضبط نوع التطبيق على تطبيق ويب.
    4. أضِف معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه التي تتوافق مع عملاء الذكاء الاصطناعي المستهدَفين:
      • ‫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. ضمن حالة النشر، انقر على نشر التطبيق.

ضبط عميل الذكاء الاصطناعي

يمكنك ضبط عدة بيئات تطوير مستندة إلى الذكاء الاصطناعي للاتصال بخادم Home MCP باستخدام مصادقة OAuth. أدخِل معرّف عميل OAuth وسر العميل هنا، ثم اتّبِع تعليمات الإعداد المفضّلة لديك.

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

الإعداد المبرمَج باستخدام طلب

إذا كان مساعد الذكاء الاصطناعي يتيح إدارة إعدادات أدوات 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

الإعداد اليدوي

اختَر أداة الذكاء الاصطناعي المفضّلة لديك للحصول على تعليمات الإعداد اليدوي.

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. انقر على الإعدادات المتقدّمة وأدخِل معرّف العميل والرمز السري للعميل.
  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.

للوصول إلى بيانات الوجوه المألوفة في "لوحة التحكّم في المحتوى" في تطبيق Home، على المستخدمين الموافقة صراحةً على هذه الميزة بشكل منفصل.

المتطلبات الأساسية

  • يجب أن يكون المستخدم الذي يمنح الموافقة مديرًا لبنية Google Home.
  • يجب أن يتوفّر في منزل المستخدم كاميرا أو جرس باب واحد على الأقل متوافق مع Google Nest واشتراك نشط في Google Home Premium مع تفعيل ميزة التعرّف على الوجوه المألوفة لكل كاميرا أو جرس باب.
  • يجب أن يتضمّن تطبيقك معرّف عميل OAuth 2.0 تم إنشاؤه في Google Cloud. يُرجى الاطّلاع على ضبط عميل الذكاء الاصطناعي لإنشاء عميل 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 المستهدَفة أسهل طريقة للحصول على هذا المعرّف هي أن تطلب من وكيلك باستخدام 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. ابدأ جلسة المساعد المستنِد إلى الذكاء الاصطناعي أو مساحة العمل.
  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. امنح أذونات تنفيذ الأداة عندما يطلب منك العميل ذلك. يمكن للمساعد المستنِد إلى الذكاء الاصطناعي استرداد بيانات الحالة في الوقت الفعلي، وستستند جميع الردود إلى بيانات القياس عن بُعد في منزلك.

الدعم

للحصول على الدعم بشأن تطوير MCP في Home، انتقِل إلى منتدى المساعدة في Smart Home للمطوّرين. يمكنك نشر سؤال للحصول على المساعدة، أو الاطّلاع على الأسئلة المنشورة سابقًا لمعرفة ما إذا تمّت الإجابة عن سؤالك.

للإبلاغ عن خطأ أو طلب ميزة في MCP، يُرجى الانتقال إلى أداة تتبُّع المشاكل العامة.

المشاكل المعروفة

  • تنفيذ الأذونات: يجب أن يقتصر الوصول إلى Home MCP على المستخدمين الذين لديهم اشتراك Google Home Premium Advanced. في الوقت الحالي، هناك خطأ يسمح لمشتركي Nest Aware Plus بالوصول إلى Home MCP. نحن نعمل على حلّ هذه المشكلة وسنطرح إصلاحًا قريبًا.
  • اختبار السمات: لتوفير أوسع مجموعة من الوظائف لوكلائك، أضفنا بعض السمات التي تم وضع علامة "تجريبية" عليها. قد تواجه سيناريوهات لا تعمل فيها هذه السمات التجريبية على النحو المتوقّع. إذا كان الأمر كذلك، يُرجى استخدام أداة تتبُّع المشاكل العامة للإبلاغ عن المشكلة.
  • وقت الاستجابة: قد تلاحظ أحيانًا وقت استجابة أطول من المتوقّع في Home MCP. نحن نعمل جاهدين على إجراء تحسينات. نتوقّع أن نشهد تحسينات في وقت الاستجابة في الإصدارات المستقبلية.

قريبًا

  • عمليات التشغيل الآلي: لا يمكن حاليًا إنشاء عمليات التشغيل الآلي وإدارتها باستخدام Home MCP. نحن نعمل على هذه الوظيفة ونخطط لإصدار دعم عمليات التشغيل الآلي في إصدار مستقبلي.