গুগল হোম এমসিপি সার্ভার

প্রাথমিক অ্যাক্সেস

গুগল হোম মডেল কনটেক্সট প্রোটোকল (এমসিপি) সার্ভার এআই-চালিত ডেভেলপমেন্ট টুল এবং ভার্চুয়াল অ্যাসিস্ট্যান্টদের স্মার্ট হোম পরিবেশের সাথে সরাসরি যোগাযোগ করতে দেয়। স্ট্যান্ডার্ড এমসিপি টুল এবং আরপিসি ইন্টারফেস উন্মুক্ত করার মাধ্যমে, এই সার্ভার লার্জ ল্যাঙ্গুয়েজ মডেল (এলএলএম)-কে বাড়ির কাঠামো পরিদর্শন, ডিভাইসের অবস্থা পর্যবেক্ষণ, নিয়ন্ত্রণমূলক কাজ সম্পাদন এবং ঐতিহাসিক ঘটনা বিশ্লেষণ করতে সক্ষম করে।

!

একটি বাস্তব বাড়িকে কোনো এআই এজেন্টের সাথে সংযুক্ত করলে, সেই এজেন্ট আপনার হয়ে ডিভাইসগুলো নিয়ন্ত্রণ করতে পারে। হোম এমসিপি রেট লিমিট এবং সুরক্ষা ব্যবস্থা প্রয়োগ করে, যেমন দরজা খোলার মতো সংবেদনশীল কাজ নিষিদ্ধ করা। তবে, আপনার এজেন্টের ধরনের ওপর নির্ভর করে, এটিকে হোম এমসিপি-র সাথে সংযুক্ত করলে অপ্রত্যাশিত বা এমনকি অনাকাঙ্ক্ষিত আচরণও দেখা দিতে পারে। ডেভেলপারের নীতিমালা এবং পরিষেবার শর্তাবলী মনোযোগ সহকারে পর্যালোচনা করুন।

আপনি যদি পরিবারের অন্য সদস্যদের ব্যবহৃত কোনো গুগল হোমকে হোম এমসিপি-র সাথে সংযুক্ত করতে চান, তবে তাদের জানিয়ে দেওয়া উচিত যে আপনার এজেন্ট ডিভাইসগুলো নিয়ন্ত্রণ করতে এবং বাড়ির ডেটা অ্যাক্সেস করতে পারবে। বিকল্পভাবে, আপনি একটি অতিরিক্ত হোম তৈরি করে ডেভেলপমেন্ট ও টেস্টিংয়ের জন্য ডিভাইসগুলো সেট আপ করতে পারেন।

Google Home app (GHA) অথবা আপনার My Accounts পেজ থেকে যেকোনো সময় আপনার এজেন্টের Home MCP-তে অ্যাক্সেস প্রত্যাহার করা যেতে পারে।

সংক্ষিপ্ত বিবরণ

একটি এমসিপি সার্ভার স্মার্ট হোম পরিকাঠামো এবং এআই অ্যাপ্লিকেশনগুলির মধ্যে প্রক্সি হিসাবে কাজ করে। হোম এমসিপি সার্ভারটি এক্সিকিউটেবল টুল সরবরাহ করে, যা এআই ক্লায়েন্টদের রিয়েল-টাইম হোম টেলিমেট্রি সম্পর্কে জানতে এবং কমান্ড জারি করতে সক্ষম করে।

মূল সক্ষমতা

হোম এমসিপি সার্ভারটি বেশ কয়েকটি মূল সক্ষমতার ক্ষেত্র প্রদান করে:

  • কাঠামো শনাক্তকরণ: list_homes ব্যবহার করে প্রবেশযোগ্য বাড়ি ও কাঠামোসমূহ খুঁজে বের করুন।
  • রিসোর্স অনুসন্ধান: list_home_resources ব্যবহার করে ডিভাইস, এরিয়া লেআউট, বৈশিষ্ট্য, অ্যাট্রিবিউট এবং কমান্ড স্কিমা তালিকাভুক্ত করুন।
  • অবস্থা পর্যবেক্ষণ: list_home_states ব্যবহার করে রিয়েল-টাইমে ডিভাইসের সংযোগের অবস্থা এবং বৈশিষ্ট্যের অবস্থা পরীক্ষা করুন।
  • ডিভাইস নিয়ন্ত্রণ: run_home_actions ব্যবহার করে টার্গেট ডিভাইসগুলিতে প্যারামিটারযুক্ত অ্যাকশন কমান্ড কার্যকর করুন।
  • ঐতিহাসিক বিশ্লেষণ: list_home_history ব্যবহার করে নির্দিষ্ট সময়সীমার মধ্যে অতীতের অবস্থার পরিবর্তন এবং ইভেন্ট লগ অনুসন্ধান করুন।

পূর্বশর্ত

হোম এমসিপি সার্ভার সেট আপ করার আগে, আপনার কাছে নিম্নলিখিত জিনিসগুলি আছে কিনা তা নিশ্চিত করুন:

  • গুগল হোমে সংযুক্ত ডিভাইসসহ একটি সক্রিয় স্মার্ট হোম সেটআপ।
  • একটি সক্রিয় Google Home Premium Advanced সাবস্ক্রিপশন।
  • একটি Google Cloud প্রকল্পে প্রবেশাধিকার।
  • একটি এমসিপি-উপযোগী এআই ক্লায়েন্ট বা অ্যাপ্লিকেশন, যেমন গুগল অ্যান্টিগ্র্যাভিটি, ক্লদ কোওয়ার্ক, বা ওপেনক্ল।

এমসিপি সার্ভার কনফিগার করুন

এমসিপি সার্ভার সেট আপ করার জন্য একটি Google Cloud প্রজেক্ট তৈরি করা, অ্যাক্সেসের অনুমোদন নেওয়া, হোম এপিআই সক্রিয় করা এবং ওঅথ ক্রেডেনশিয়াল তৈরি করা প্রয়োজন।

একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন

আপনার যদি আগে থেকে Google Cloud না থাকে, তবে আপনাকে অবশ্যই একটি তৈরি করতে হবে:

  1. Google Cloud কনসোলটি খুলুন।
  2. একটি নতুন Google Cloud প্রজেক্ট তৈরি করুন।

আরও তথ্যের জন্য, Google Cloud ডকুমেন্টেশনে 'প্রজেক্ট তৈরি করুন ' নিবন্ধটি দেখুন।

হোম এপিআই সক্রিয় করুন

  1. Google Cloud কনসোল নেভিগেশন মেনুতে, APIs & Services > Enabled APIs & Services নির্বাচন করুন।
  2. Home API অনুসন্ধান করুন এবং Enable-এ ক্লিক করুন।
  1. OAuth সম্মতি স্ক্রিনটি কনফিগার করুন:
    1. এপিআই ও পরিষেবা > ওঅথ সম্মতি স্ক্রিন খুলুন।
    2. এক্সটার্নাল অডিয়েন্স নির্বাচন করুন, ‘Get started’- এ ক্লিক করুন এবং প্রয়োজনীয় অ্যাপের তথ্য ও যোগাযোগের ইমেল পূরণ করুন।
  2. একটি OAuth ক্লায়েন্ট আইডি তৈরি করুন:
    1. ওপেন এপিআই ও পরিষেবাসমূহ > ক্রেডেনশিয়াল ।
    2. + Create credentials-এ ক্লিক করুন এবং OAuth ক্লায়েন্ট আইডি নির্বাচন করুন।
    3. অ্যাপ্লিকেশনের ধরণ ওয়েব অ্যাপ্লিকেশন হিসেবে সেট করুন।
    4. আপনার লক্ষ্য AI ক্লায়েন্টদের সাথে সঙ্গতিপূর্ণ অনুমোদিত রিডাইরেক্ট URI-গুলো যোগ করুন:
      • গুগল অ্যান্টিগ্র্যাভিটি: https://antigravity.google/oauth-callback
      • Claude Cowork: https://claude.ai/api/mcp/auth_callback
      • OpenClaw: আপনার স্থানীয় OpenClaw ইনস্টলেশন দ্বারা নির্দিষ্ট পুনঃনির্দেশ URI
    5. Create-এ ক্লিক করুন এবং আপনার Client ID ও Client Secret একটি সুরক্ষিত স্থানে কপি করে রাখুন।
  3. আপনার অ্যাপ্লিকেশনটি প্রকাশ করুন:
    1. গুগল অথোরাইজেশন প্ল্যাটফর্ম খুলুন > অডিয়েন্স ।
    2. পাবলিশিং স্ট্যাটাস- এর অধীনে, পাবলিশ অ্যাপ-এ ক্লিক করুন।

আপনার এআই ক্লায়েন্ট কনফিগার করুন

আপনি OAuth অথেনটিকেশন ব্যবহার করে হোম এমসিপি সার্ভারের সাথে সংযোগ করার জন্য একাধিক এআই ডেভেলপমেন্ট এনভায়রনমেন্ট কনফিগার করতে পারেন। এখানে আপনার OAuth ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট লিখুন, তারপর আপনার পছন্দের সেটআপ নির্দেশাবলী অনুসরণ করুন।

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

একটি প্রম্পট ব্যবহার করে স্বয়ংক্রিয় সেটআপ

যদি আপনার এআই অ্যাসিস্ট্যান্ট সরাসরি চ্যাট থেকে এমসিপি টুল কনফিগারেশন পরিচালনা করা সমর্থন করে, তাহলে আপনি নিম্নলিখিত প্রম্পটটি পেস্ট করে আপনার অ্যাসিস্ট্যান্টকে সার্ভার কনফিগার করার নির্দেশ দিতে পারেন:

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

ম্যানুয়াল সেটআপ

ম্যানুয়াল সেটআপ নির্দেশাবলীর জন্য আপনার পছন্দের এআই টুলটি নির্বাচন করুন।

অ্যান্টিগ্র্যাভিটি

গুগল অ্যান্টিগ্র্যাভিটি তার CLI, IDE, এবং ডেস্কটপ এনভায়রনমেন্ট জুড়ে MCP সার্ভারের জন্য বিল্ট-ইন ইন্টিগ্রেশন প্রদান করে।

  1. অ্যাপ্লিকেশন কনফিগারেশন মেনুটি খুলুন: সেটিংস > উন্নত সেটিংস > কাস্টমাইজেশন > এমসিপি কনফিগ খুলুন ।

  2. mcpServers কনফিগারেশন অবজেক্টের অধীনে home_mcp এন্ট্রিটি যোগ করুন:

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

  3. সম্পূর্ণ প্রমাণীকরণ: সেটিংস > উন্নত সেটিংস > কাস্টমাইজেশন > home_mcp > প্রমাণীকরণ- এ যান।

  4. আপনার ওয়েব ব্রাউজারে গুগল হোমের অনুমতি প্রক্রিয়াটি সম্পন্ন করুন, আপনার বাড়ির কাঠামোটি নির্বাচন করুন এবং অনুমোদন কোডটি কপি করে অ্যান্টিগ্র্যাভিটিতে ফিরিয়ে আনুন।

আরও তথ্যের জন্য, গুগল অ্যান্টিগ্র্যাভিটি ডকুমেন্টেশন দেখুন।

ক্লদ

আপনার কাস্টম হোম এমসিপি সার্ভারের সাথে সংযোগ করতে ক্লড কোওয়ার্ক কনফিগার করুন:

  1. ওপেন ক্লড কানেক্টর ।
  2. + এ ক্লিক করুন এবং কাস্টম কানেক্টর যোগ করুন নির্বাচন করুন।
  3. সার্ভার ইউআরএলটি লিখুন: https://home.googleapis.com/mcp ।
  4. উন্নত সেটিংসে ক্লিক করুন এবং আপনার ক্লায়েন্ট আইডি ও ক্লায়েন্ট সিক্রেট লিখুন।
  5. অ্যাড-এ ক্লিক করুন এবং আপনার ব্রাউজারে OAuth অনুমোদন প্রক্রিয়াটি সম্পূর্ণ করুন।
  6. Cowork চ্যাটে, নিচের-বাম কোণায় থাকা + চিহ্নে ক্লিক করুন, Connectors নির্বাচন করুন, এবং home_mcp টগলটি অন করুন।

আরও তথ্যের জন্য, ক্লড প্ল্যাটফর্মের ডকুমেন্টেশন দেখুন।

ওপেনক্ল

OAuth প্রমাণীকরণের মাধ্যমে রিমোট SSE ট্রান্সপোর্টে সংযোগ করার জন্য OpenClaw কনফিগার করুন:

  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 Home কাঠামোর একজন ব্যবস্থাপক হতে হবে।
  • ব্যবহারকারীর কাঠামোতে অবশ্যই কমপক্ষে একটি সামঞ্জস্যপূর্ণ Google Nest ক্যামেরা বা ডোরবেল এবং একটি সক্রিয় Google Home Premium সাবস্ক্রিপশন থাকতে হবে, যেখানে প্রতিটি ক্যামেরা বা ডোরবেলের জন্য পরিচিত মুখ শনাক্তকরণ (Familiar face detection) সক্রিয় করা থাকবে।
  • আপনার অ্যাপ্লিকেশনের জন্য Google Cloud একটি OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করা থাকতে হবে। যদি আগে থেকে তা করা না থাকে, তবে একটি OAuth 2.0 ক্লায়েন্ট তৈরি করতে ' আপনার এআই ক্লায়েন্ট কনফিগার করুন' অংশটি দেখুন।

আপনার অ্যাপ্লিকেশনকে অ্যাক্সেস দেওয়ার জন্য, আপনাকে অবশ্যই আপনার OAuth 2.0 ক্লায়েন্ট আইডি এবং Home স্ট্রাকচার আইডি দিয়ে ব্যক্তিগতকৃত একটি সম্মতি লিঙ্কে যেতে হবে। আপনার সম্মতি লিঙ্কটি পাওয়ার দুটি উপায় রয়েছে।

একবার আপনার লিঙ্কটি পেয়ে গেলে, সেখানে যান এবং সম্মতি প্রদান করুন।

আপনার এজেন্ট যদি ইতিমধ্যেই হোম এমসিপি-র সাথে সংযুক্ত থাকে, তবে এটি স্বয়ংক্রিয়ভাবে আপনার Home স্ট্রাকচার আইডি খুঁজে বের করতে এবং ক্লিক করার জন্য প্রস্তুত একটি লিঙ্ক তৈরি করতে পারবে।

নিম্নলিখিত প্যারামিটারগুলো সরাসরি এই পৃষ্ঠাতেই আপডেট করুন, তারপর কাস্টমাইজ করা প্রম্পটটি আপনার এজেন্টের চ্যাটে কপি-পেস্ট করুন।

  • CLIENT_ID — Google Cloud থেকে প্রাপ্ত আপনার OAuth 2.0 ক্লায়েন্ট আইডি। উদাহরণস্বরূপ, `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 স্ট্রাকচার আইডি খুঁজে বের করতে এবং ক্লিক করার জন্য প্রস্তুত একটি লিঙ্ক তৈরি করতে পারবে।

এই পৃষ্ঠাতেই সরাসরি নিম্নলিখিত প্যারামিটারগুলো আপডেট করুন, তারপর কাস্টমাইজ করা লিঙ্কটি একটি ওয়েব ব্রাউজারে খুলুন।

  • CLIENT_ID — Google Cloud থেকে প্রাপ্ত আপনার OAuth 2.0 ক্লায়েন্ট আইডি। উদাহরণস্বরূপ, `123456789-xyz.apps.googleusercontent.com`।
  • STRUCTURE_ID — নির্দিষ্ট Home স্ট্রাকচারের UUID। এটি পাওয়ার সবচেয়ে সহজ উপায় হলো হোম এমসিপি (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 MCP-এর মাধ্যমে অটোমেশন তৈরি এবং পরিচালনা করা বর্তমানে সমর্থিত নয়। আমরা এই কার্যকারিতাটি নিয়ে কাজ করছি এবং ভবিষ্যতের কোনো সংস্করণে অটোমেশন সমর্থন চালু করার পরিকল্পনা করছি।