تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

خادم MCP في Google Home

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

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

تحذير:

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

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

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

نظرة عامة

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

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

يوفّر خادم MCP الرئيسي عدة مجالات أساسية للقدرات:

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

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

قبل إعداد خادم 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، عليك إنشاء حساب باتّباع الخطوات التالية:

افتح وحدة تحكّم Google Cloud.
أنشئ Google Cloud مشروعًا جديدًا.

لمزيد من المعلومات، يُرجى الاطّلاع على المقالة إنشاء مشاريع في مستندات Google Cloud.

تفعيل Home API

في قائمة التنقّل في Google Cloud، اختَر واجهات برمجة التطبيقات والخدمات > واجهات برمجة التطبيقات والخدمات المفعَّلة.
ابحث عن Home API وانقر على تفعيل.

إعداد موافقة OAuth وبيانات الاعتماد

إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth:
1. افتح واجهات برمجة التطبيقات والخدمات > شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
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. انقر على إنشاء وانسخ معرّف العميل والرمز السري للعميل إلى مكان آمن.
انشر تطبيقك باتّباع الخطوات التالية:
1. افتح منصة Google للمصادقة > الجمهور.
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://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

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

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

Antigravity

توفّر Google Antigravity عملية دمج مدمجة لخوادم MCP في جميع بيئات واجهة سطر الأوامر وبيئة التطوير المتكاملة (IDE) وبيئات أجهزة الكمبيوتر.

افتح قائمة إعدادات التطبيق: الإعدادات > الإعدادات المتقدّمة > التخصيصات > فتح إعدادات MCP.

أضِف الإدخال home_mcp ضمن كائن الإعداد mcpServers:

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

إكمال عملية المصادقة: انتقِل إلى الإعدادات > الإعدادات المتقدّمة > التخصيصات > home_mcp > المصادقة.
أكمِل عملية منح أذونات Google Home في متصفّح الويب، واختَر بنية منزلك، وانسخ رمز التفويض وأعِد لصقه في Antigravity.

لمزيد من المعلومات، يمكنك الاطّلاع على مستندات Google Antigravity.

Claude

لضبط Claude Cowork للاتصال بخادم MCP المنزلي المخصّص، اتّبِع الخطوات التالية:

افتح Claude Connectors.
انقر على + واختَر إضافة موصِّل مخصّص.
أدخِل عنوان URL الخاص بالخادم: https://home.googleapis.com/mcp.
انقر على الإعدادات المتقدّمة وأدخِل معرّف العميل والرمز السري للعميل.
انقر على إضافة وأكمِل عملية تفويض OAuth في المتصفّح.
في محادثة Cowork، انقر على + في أسفل يمين الشاشة، واختَر الموصلات، ثم فعِّل home_mcp.

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات منصة Claude.

OpenClaw

اضبط OpenClaw للاتصال بنقل SSE البعيد باستخدام مصادقة OAuth:

جهِّز حزمة 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"
        }
      }
    }
  }
}

طبِّق تصحيح الإعدادات في الوحدة الطرفية:
```
openclaw config patch --stdin
```
أعِد تشغيل بوابة OpenClaw باتّباع الخطوات التالية:
```
openclaw gateway restart
```
ابدأ عملية المصادقة باتّباع الخطوات التالية:
```
openclaw mcp login home_mcp
```
اتّبِع عنوان URL الخاص بالتفويض الذي تم إنشاؤه لتسجيل الدخول ومنح الإذن بالوصول.

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات OpenClaw.

الموافقة على استخدام ميزة "التعرّف على الوجوه المألوفة"

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

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

يجب أن يكون المستخدم الذي يمنح الموافقة مشرفًا على بنية Google Home.
يجب أن يتضمّن منزل المستخدم كاميرا أو جرس باب واحدًا على الأقل متوافقًا Google Nest واشتراكًا نشطًا Google Home Premium مع تفعيل ميزة التعرّف على الوجوه المألوفة لكل كاميرا أو جرس باب.
يجب أن يتضمّن تطبيقك معرّف عميل OAuth 2.0 تم إنشاؤه في Google Cloud. راجِع إعداد عميل الذكاء الاصطناعي لإنشاء عميل OAuth 2.0 إذا لم يسبق لك إجراء ذلك.

روابط الموافقة

لمنح تطبيقك إذن الوصول، عليك الانتقال إلى رابط موافقة مخصّص باستخدام معرّف عميل OAuth 2.0 ومعرّف Home. هناك طريقتان للحصول على رابط الموافقة.

بعد الحصول على الرابط، انتقِل إليه وقدِّم موافقتك.

ينشئ الوكيل الرابط

إذا كان وكيلك مرتبطًا بخادم MCP الخاص بمنزل Google، يمكنه تلقائيًا تحديد معرّف بنية 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

إنشاء الرابط

عدِّل المَعلمات التالية مباشرةً في هذه الصفحة، ثم افتح الرابط المعدَّل في متصفّح ويب.

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

التحقّق من الاتصال والوظائف

بعد إعداد العميل ومصادقته، تحقَّق من اتصال الخادم باتّباع الخطوات التالية:

ابدأ جلسة مع مساعدك المستنِد إلى الذكاء الاصطناعي أو جلسة في مساحة عملك.
تحقَّق من اتصالات خادم MCP النشطة (في Antigravity، شغِّل /mcp أو افحص قوائم الأدوات).
تأكَّد من إدراج home_mcp مع الأدوات النشطة.
أرسِل طلبات نموذجية إلى مساعدك لاختبار إمكانات مختلفة:
- اكتشاف الكيانات: 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?
منح أذونات تنفيذ الأداة عندما يطلب منك العميل ذلك يمكن لمساعد الذكاء الاصطناعي استرداد بيانات الحالة في الوقت الفعلي، وستستند جميع الردود إلى بيانات القياس عن بُعد في منزلك.

الدعم

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

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

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

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

قريبًا

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

خادم MCP في Google Home تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

warning تحذير:

نظرة عامة

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

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

ضبط إعدادات خادم MCP

إنشاء مشروع على Google Cloud

تفعيل Home API

إعداد موافقة OAuth وبيانات الاعتماد

إعداد عميل الذكاء الاصطناعي

الإعداد الآلي باستخدام طلب

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

Antigravity

Claude

OpenClaw

الموافقة على استخدام ميزة "التعرّف على الوجوه المألوفة"

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

روابط الموافقة

ينشئ الوكيل الرابط

إنشاء الرابط

التحقّق من الاتصال والوظائف

الدعم

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

قريبًا

خادم MCP في Google Home

تحذير: