سرور MCP گوگل هوم

دسترسی زودهنگام

سرور پروتکل زمینه مدل گوگل هوم (MCP) به ابزارهای توسعه مبتنی بر هوش مصنوعی و دستیاران مجازی اجازه می‌دهد تا مستقیماً با محیط‌های خانه هوشمند تعامل داشته باشند. این سرور با ارائه ابزارهای استاندارد MCP و رابط‌های RPC، مدل‌های زبان بزرگ (LLM) را قادر می‌سازد تا ساختارهای خانه را بررسی کنند، وضعیت دستگاه‌ها را رصد کنند، اقدامات کنترلی را اجرا کنند و رویدادهای تاریخی را تجزیه و تحلیل کنند.

هشدار!

اتصال یک خانه واقعی به یک عامل هوش مصنوعی به آن عامل اجازه می‌دهد تا دستگاه‌ها را از طرف شما کنترل کند. Home MCP محدودیت‌های نرخ و محافظت‌های ایمنی، مانند ممنوعیت اقدامات حساس مانند باز کردن قفل درها را اعمال می‌کند. با این حال، بسته به عامل شما، اتصال آن به Home MCP می‌تواند منجر به رفتار غیرمنتظره یا حتی نامطلوب شود. سیاست‌ها و شرایط خدمات توسعه‌دهنده را با دقت بررسی کنید.

اگر تصمیم دارید یک Google Home که توسط سایر اعضای خانواده استفاده می‌شود را به Home MCP متصل کنید، باید به آنها اطلاع دهید که نماینده شما می‌تواند دستگاه‌ها را کنترل کرده و به داده‌های خانه دسترسی داشته باشد. از طرف دیگر، می‌توانید یک خانه اضافی ایجاد کنید و دستگاه‌ها را برای توسعه و آزمایش تنظیم کنید.

دسترسی نماینده شما به Home MCP را می‌توان در هر زمانی از طریق Google Home app (GHA) یا صفحه حساب‌های من شما لغو کرد .

نمای کلی

یک سرور MCP به عنوان یک واسطه بین زیرساخت خانه هوشمند و برنامه‌های هوش مصنوعی عمل می‌کند. سرور Home MCP ابزارهای اجرایی را در اختیار کاربران هوش مصنوعی قرار می‌دهد که به آنها اجازه می‌دهد تا به صورت بلادرنگ از اطلاعات خانه مطلع شوند و دستوراتی را صادر کنند.

قابلیت‌های اصلی

سرور Home MCP چندین قابلیت اصلی را ارائه می‌دهد:

  • کشف ساختار: خانه‌ها و ساختارهای قابل دسترسی را با استفاده از list_homes بازیابی کنید.
  • کشف منابع: فهرست کردن دستگاه‌ها، طرح‌بندی‌های ناحیه، ویژگی‌ها، صفات و طرحواره‌های فرمان با استفاده از list_home_resources .
  • نظارت بر وضعیت: وضعیت اتصال دستگاه را به صورت بلادرنگ بررسی کنید و وضعیت‌ها را با استفاده از list_home_states مشخص کنید.
  • کنترل دستگاه: با استفاده از run_home_actions دستورات اکشن پارامتری را روی دستگاه‌های هدف اجرا کنید.
  • تحلیل تاریخچه: با استفاده از list_home_history تغییرات وضعیت گذشته و گزارش‌های رویداد را در بازه‌های زمانی خاص جستجو کنید.

پیش‌نیازها

قبل از راه‌اندازی سرور Home MCP، مطمئن شوید که موارد زیر را دارید:

  • راه‌اندازی فعال خانه هوشمند در گوگل هوم با دستگاه‌های متصل.
  • اشتراک فعال Google Home Premium Advanced .
  • دسترسی به یک پروژه Google Cloud .
  • یک کلاینت یا برنامه هوش مصنوعی سازگار با MCP، مانند Google Antigravity، Claude Cowork یا OpenClaw.

پیکربندی سرور MCP

راه‌اندازی سرور MCP مستلزم ایجاد یک پروژه Google Cloud ، دریافت تأییدیه دسترسی، فعال کردن Home API و تولید اعتبارنامه‌های OAuth است.

ایجاد یک پروژه گوگل کلود

اگر از قبل 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 های تغییر مسیر مجاز مربوط به کلاینت های هوش مصنوعی هدف خود را اضافه کنید:
      • گوگل آنتی گراویتی: https://antigravity.google/oauth-callback
      • کلود کورک: https://claude.ai/api/mcp/auth_callback
      • OpenClaw: تغییر مسیر URL مشخص شده توسط نصب محلی OpenClaw شما
    5. روی ایجاد کلیک کنید و شناسه کلاینت و رمز کلاینت خود را در یک مکان امن کپی کنید.
  3. اپلیکیشن خود را منتشر کنید:
    1. پلتفرم احراز هویت گوگل > مخاطب را باز کنید.
    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

تنظیم دستی

ابزار هوش مصنوعی مورد نظر خود را برای دستورالعمل‌های تنظیم دستی انتخاب کنید.

ضد جاذبه

گوگل آنتی‌گراویتی (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. مراحل مجوزهای گوگل هوم را در مرورگر وب خود تکمیل کنید، ساختار خانه خود را انتخاب کنید و کد مجوز را دوباره در Antigravity کپی کنید.

برای اطلاعات بیشتر، به مستندات Google Antigravity مراجعه کنید.

کلود

کلود کوورک را برای اتصال به سرور MCP خانگی سفارشی خود پیکربندی کنید:

  1. کانکتورهای کلود را باز کنید.
  2. روی + کلیک کنید و گزینه افزودن کانکتور سفارشی را انتخاب کنید.
  3. آدرس اینترنتی سرور را وارد کنید: https://home.googleapis.com/mcp .
  4. روی تنظیمات پیشرفته کلیک کنید و شناسه کلاینت و راز کلاینت خود را وارد کنید.
  5. روی افزودن کلیک کنید و مراحل احراز هویت OAuth را در مرورگر خود تکمیل کنید.
  6. در یک چت Cowork، روی + در گوشه پایین سمت چپ کلیک کنید، Connectors را انتخاب کنید و home_mcp را فعال کنید.

برای اطلاعات بیشتر، به مستندات پلتفرم کلود مراجعه کنید.

اوپن‌کلاو

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 MCP، کاربران باید صریحاً و جداگانه با این ویژگی موافقت کنند.

پیش‌نیازها

  • کاربری که رضایت می‌دهد باید مدیر ساختار Google Home باشد.
  • ساختمان کاربر باید حداقل یک دوربین یا زنگ درب سازگار Google Nest و یک اشتراک فعال Google Home Premium با قابلیت تشخیص چهره فعال برای هر دوربین یا زنگ درب داشته باشد.
  • برنامه شما باید یک شناسه کلاینت OAuth 2.0 ایجاد شده در Google Cloud داشته باشد. اگر قبلاً این کار را نکرده‌اید ، به بخش پیکربندی کلاینت هوش مصنوعی خود برای ایجاد یک کلاینت OAuth 2.0 مراجعه کنید.

برای اعطای دسترسی به برنامه خود، باید از یک لینک رضایت که با شناسه کلاینت OAuth 2.0 و شناسه ساختار Home شما شخصی‌سازی شده است، بازدید کنید. دو راه برای دریافت لینک رضایت وجود دارد.

وقتی لینک خود را دریافت کردید، از آن بازدید کنید و رضایت خود را اعلام کنید.

اگر نماینده شما از قبل به Home MCP متصل باشد، می‌تواند به طور خودکار شناسه ساختار 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

اگر نماینده شما از قبل به Home MCP متصل باشد، می‌تواند به طور خودکار شناسه ساختار Home شما را پیدا کرده و یک لینک آماده برای کلیک ایجاد کند.

پارامترهای زیر را مستقیماً در این صفحه به‌روزرسانی کنید، سپس پیوند سفارشی‌شده را در یک مرورگر وب باز کنید.

  • CLIENT_ID — شناسه کلاینت OAuth 2.0 شما از Google Cloud . برای مثال، `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_ID — شناسه ساختار 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 خانگی، به انجمن راهنمای خانه هوشمند برای توسعه‌دهندگان مراجعه کنید. در آنجا می‌توانید سوالی ارسال کنید تا کمک بگیرید، یا سوالات ارسال شده قبلی را بررسی کنید تا ببینید آیا به سوال شما قبلاً پاسخ داده شده است یا خیر.

برای ثبت درخواست اشکال یا ویژگی MCP، به بخش پیگیری مشکلات عمومی ما مراجعه کنید.

مشکلات شناخته شده

  • آزمایش ویژگی‌ها — برای ارائه وسیع‌ترین مجموعه عملکرد برای کارگزاران شما، برخی ویژگی‌ها را که به عنوان آزمایشی علامت‌گذاری شده‌اند، گنجانده‌ایم. ممکن است با سناریوهایی مواجه شوید که این ویژگی‌های آزمایشی مطابق انتظار کار نکنند. در این صورت، لطفاً از ردیاب مشکلات عمومی برای گزارش استفاده کنید.
  • تأخیر — گاهی اوقات ممکن است متوجه تأخیر بیش از حد انتظار در Home MCP شوید. ما به طور فعال روی بهینه‌سازی‌ها کار می‌کنیم. انتظار می‌رود در نسخه‌های آینده شاهد بهبود تأخیر باشیم.

به زودی

  • اتوماسیون‌ها — ایجاد و مدیریت اتوماسیون‌ها با Home MCP در حال حاضر پشتیبانی نمی‌شود. ما در حال کار بر روی این قابلیت هستیم و قصد داریم پشتیبانی از اتوماسیون‌ها را در نسخه‌های آینده منتشر کنیم.