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

ডেভেলপার প্রিভিউ: গুগল ওয়ার্কস্পেস ডেভেলপার প্রিভিউ প্রোগ্রামের অংশ হিসেবে উপলব্ধ, যা নির্দিষ্ট কিছু ফিচারে আগেভাগে অ্যাক্সেস প্রদান করে।

গুগল চ্যাট একটি রিমোট মডেল কনটেক্সট প্রোটোকল (MCP) সার্ভার প্রদান করে, যা এআই এজেন্টদের গুগল চ্যাট ডেটার সাথে নিরাপদে ইন্টারঅ্যাক্ট করার সুযোগ দেয়। গুগল চ্যাট MCP সার্ভার কনফিগার করার মাধ্যমে, আপনি Gemini CLI, Claude বা IDE-এর মতো এআই অ্যাপ্লিকেশনগুলোকে গুগল চ্যাটে বিভিন্ন অ্যাকশন সম্পাদন করার জন্য সক্ষম করেন।

গুগল চ্যাট এমসিপি সার্ভার এআই এজেন্টদের জন্য একটি প্রমিত পদ্ধতি প্রদান করে:

• ডেটা পড়ুন : কথোপকথনের তালিকা দেখুন ও অনুসন্ধান করুন এবং বার্তা পড়ুন।
• নিরাপত্তাকে সম্মান করুন : ব্যবহারকারীর মতোই একই অনুমতি এবং ডেটা পরিচালনা নিয়ন্ত্রণ লাভ করুন।

পূর্বশর্ত

• একটি গুগল ক্লাউড প্রজেক্ট। প্রজেক্ট তৈরি করতে, ‘প্রজেক্ট তৈরি করুন’ দেখুন।

• একটি MCP ক্লায়েন্ট, যেমন Gemini CLI ।

• এই পৃষ্ঠার কমান্ডগুলো চালানোর জন্য, নিচের ধাপগুলো অনুসরণ করে আপনার স্থানীয় ডেভেলপমেন্ট এনভায়রনমেন্টে gcloud CLI সেট আপ করুন:

  1. Google Cloud CLI ইনস্টল করুন । আপনি যদি আগে gcloud CLI ইনস্টল করে থাকেন, তাহলে gcloud components update চালিয়ে নিশ্চিত করুন যে আপনার কাছে সর্বশেষ সংস্করণটি রয়েছে।
  2. আপনি যদি কোনো এক্সটার্নাল আইডেন্টিটি প্রোভাইডার (IdP) ব্যবহার করেন, তাহলে আপনার ফেডারেটেড আইডেন্টিটি দিয়ে gcloud CLI-তে সাইন ইন করুন। আরও তথ্যের জন্য, “আপনার ফেডারেটেড আইডেন্টিটি দিয়ে gcloud CLI-তে সাইন ইন করুন” দেখুন।
  3. gcloud CLI চালু করুন ।

গুগল চ্যাট এমসিপি সার্ভার কনফিগার করুন

Google Chat MCP সার্ভার ব্যবহার করতে হলে, আপনাকে অবশ্যই আপনার Google Cloud প্রজেক্টে এটি সক্রিয় করতে হবে এবং তারপর এর সাথে সংযোগ করার জন্য আপনার MCP ক্লায়েন্ট কনফিগার করতে হবে।

এপিআইগুলি সক্রিয় করুন

Google Chat MCP সার্ভার ব্যবহার করার জন্য, আপনাকে আপনার Google Cloud প্রজেক্টে নিম্নলিখিত API-গুলি সক্রিয় করতে হবে:

• গুগল চ্যাট এপিআই

সিএলআই

gcloud services enable chat.googleapis.com --project=PROJECT_ID

PROJECT_ID জায়গায় আপনার গুগল ক্লাউড প্রজেক্ট আইডি বসান।

কনসোল

গুগল ক্লাউড কনসোলে এপিআইগুলো সক্রিয় করুন:

এপিআইগুলি সক্রিয় করুন

এমসিপি পরিষেবাগুলি সক্রিয় করুন

Google Chat-এর জন্য MCP কম্পোনেন্টগুলো সক্রিয় করতে, আপনাকে আপনার Google Cloud প্রজেক্টে নিম্নলিখিত সার্ভিসটি সক্রিয় করতে হবে:

• গুগল চ্যাট এমসিপি এপিআই

সিএলআই

gcloud services enable chatmcp.googleapis.com --project=PROJECT_ID

PROJECT_ID জায়গায় আপনার গুগল ক্লাউড প্রজেক্ট আইডি বসান।

কনসোল

গুগল ক্লাউড কনসোলে এমসিপি পরিষেবাগুলি সক্রিয় করুন:

এমসিপি পরিষেবাগুলি সক্রিয় করুন

চ্যাট অ্যাপটি কনফিগার করুন

গুগল চ্যাট এমসিপি সার্ভার ব্যবহার করতে হলে, আপনাকে আপনার গুগল ক্লাউড প্রজেক্টে একটি চ্যাট অ্যাপ কনফিগার করতে হবে।

1. গুগল ক্লাউড কনসোলে, Google Chat API অনুসন্ধান করুন এবং Google Chat API > Manage > Configuration-এ ক্লিক করুন।

   গুগল চ্যাট এপিআই-তে যান

2. চ্যাট অ্যাপটি সেট আপ করুন:

   1. 'এই চ্যাট অ্যাপটিকে একটি গুগল ওয়ার্কস্পেস অ্যাড-অন হিসাবে তৈরি করুন ' বিকল্পটি থেকে টিক চিহ্ন তুলে দিন। নিশ্চিত করার জন্য একটি ডায়ালগ বক্স খুলবে। ডায়ালগ বক্সে, 'অক্ষম করুন' (Disable) বোতামে ক্লিক করুন।
   2. অ্যাপের নামের ফিল্ডে Chat MCP লিখুন।
   3. Avatar URL ফিল্ডে https://developers.google.com/chat/images/quickstart-app-avatar.png লিখুন।
   4. Description- এ Chat MCP server লিখুন।
   5. Functionality-এর অধীনে, Enable interactive features টগলটি বন্ধ করে ইন্টারেক্টিভ ফিচারগুলো বন্ধ করুন।
   6. ‘Visibility’-এর অধীনে, ‘Make this Chat app available to specific people and groups in your domain’ নির্বাচন করুন এবং আপনার ইমেল ঠিকানা লিখুন।
   7. লগস-এর অধীনে, ত্রুটি লগ করার বিকল্পটি লগিং-এ নির্বাচন করুন।

3. সংরক্ষণ করুন- এ ক্লিক করুন।

চ্যাট অ্যাপ তৈরি করার বিষয়ে আরও জানতে, “Choose a Google Chat app architecture” দেখুন।

OAuth সম্মতি স্ক্রিন সেট আপ করুন

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

1. Google Cloud কনসোলে, Google Auth Platform > Branding- এ যান।

   ব্র্যান্ডিং-এ যান

2. আপনি যদি ইতিমধ্যেই গুগল অথ প্ল্যাটফর্ম কনফিগার করে থাকেন, তাহলে আপনি ব্র্যান্ডিং , অডিয়েন্স এবং ডেটা অ্যাক্সেস- এ নিম্নলিখিত OAuth কনসেন্ট স্ক্রিন সেটিংস কনফিগার করতে পারেন। যদি আপনি ‘গুগল অথ প্ল্যাটফর্ম এখনও কনফিগার করা হয়নি ’ লেখা কোনো বার্তা দেখতে পান, তাহলে ‘গেট স্টার্টেড’-এ ক্লিক করুন:

   1. অ্যাপ ইনফরমেশন-এর অধীনে, অ্যাপ নেম- এর জায়গায় Chat MCP Server টাইপ করুন।
   2. ব্যবহারকারী সহায়তা ইমেল- এ, আপনার ইমেল ঠিকানা অথবা একটি উপযুক্ত গুগল গ্রুপ নির্বাচন করুন।
   3. পরবর্তী ধাপে যান।
   4. Audience-এর অধীনে, Internal নির্বাচন করুন। যদি আপনি Internal নির্বাচন করতে না পারেন, তাহলে External নির্বাচন করুন।
   5. পরবর্তী ধাপে যান।
   6. যোগাযোগের তথ্যের অধীনে, একটি ইমেল ঠিকানা লিখুন যেখানে আপনার প্রকল্পের যেকোনো পরিবর্তন সম্পর্কে আপনাকে জানানো যাবে।
   7. পরবর্তী ধাপে যান।
   8. Finish-এর অধীনে, Google API Services ব্যবহারকারীর ডেটা নীতি পর্যালোচনা করুন এবং যদি আপনি সম্মত হন, তাহলে I agree to the Google API Services: User Data Policy নির্বাচন করুন।
   9. চালিয়ে যান-এ ক্লিক করুন।
   10. তৈরি করুন- এ ক্লিক করুন।
   11. যদি আপনি ব্যবহারকারীর ধরন হিসেবে 'এক্সটার্নাল' নির্বাচন করে থাকেন, তাহলে পরীক্ষামূলক ব্যবহারকারী যোগ করুন:
       1. দর্শকবৃন্দে ক্লিক করুন।
       2. টেস্ট ইউজার্স-এর অধীনে, অ্যাড ইউজার্স-এ ক্লিক করুন।
       3. আপনার ইমেল ঠিকানা এবং অন্য কোনো অনুমোদিত পরীক্ষামূলক ব্যবহারকারীর তথ্য প্রবেশ করান, তারপর সেভ-এ ক্লিক করুন।

3. ডেটা অ্যাক্সেস > স্কোপ যোগ বা অপসারণ-এ ক্লিক করুন। একটি প্যানেল প্রদর্শিত হবে, যেখানে আপনার গুগল ক্লাউড প্রজেক্টে সক্রিয় করা প্রতিটি এপিআই-এর স্কোপের একটি তালিকা থাকবে।

   1. ‘Manually add scopes’- এর অধীনে, Google Chat MCP সার্ভারের জন্য স্কোপগুলো পেস্ট করুন:

      • https://www.googleapis.com/auth/chat.spaces.readonly
      • https://www.googleapis.com/auth/chat.memberships.readonly
      • https://www.googleapis.com/auth/chat.messages.readonly
      • https://www.googleapis.com/auth/chat.users.readstate.readonly

   2. টেবিলে যোগ করুন-এ ক্লিক করুন।

   3. আপডেট-এ ক্লিক করুন।

   4. আপনার অ্যাপের জন্য প্রয়োজনীয় পরিধিগুলো নির্বাচন করার পর, ডেটা অ্যাক্সেস পৃষ্ঠায়, সেভ-এ ক্লিক করুন।

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

আপনার এমসিপি ক্লায়েন্টে গুগল চ্যাট রিমোট এমসিপি সার্ভার যোগ করতে, আপনার ক্লায়েন্টের জন্য দেওয়া নির্দেশাবলী অনুসরণ করুন।

জেমিনি সিএলআই

আপনার Gemini CLI-তে Google Chat রিমোট MCP সার্ভার যোগ করতে, আপনার settings.json ফাইলে সার্ভার কনফিগারেশনটি যোগ করুন।

1. একটি OAuth 2.0 ক্লায়েন্ট আইডি এবং সিক্রেট তৈরি করুন:

   1. Google Cloud কনসোলে, Google Auth Platform > Clients > Create Client- এ যান।

      ক্লায়েন্ট তৈরি করতে যান

   2. অ্যাপ্লিকেশনের ধরন হিসেবে ডেস্কটপ অ্যাপ নির্বাচন করুন।

   3. একটি নাম লিখুন।

   4. Create-এ ক্লিক করুন এবং আপনার Client ID ও Client Secret কপি করুন।

2. ~/.gemini/settings.json কনফিগারেশন ফাইলটি খুলুন অথবা তৈরি করুন।

3. settings.json এ mcpServers কনফিগারেশন যোগ করুন:

   {
     "mcpServers": {
       "chat": {
         "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
         "oauth": {
           "enabled": true,
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET",
           "scopes": [
             "https://www.googleapis.com/auth/chat.spaces.readonly",
             "https://www.googleapis.com/auth/chat.memberships.readonly",
             "https://www.googleapis.com/auth/chat.messages.readonly",
             "https://www.googleapis.com/auth/chat.users.readstate.readonly"
           ]
         }
       }
     }
   }
   

   নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

   • OAUTH_CLIENT_ID : আপনার তৈরি করা ক্লায়েন্ট আইডি।
   • OAUTH_CLIENT_SECRET : আপনার তৈরি করা ক্লায়েন্ট সিক্রেট।

4. settings.json সংরক্ষণ করুন।

5. জেমিনি সিএলআই শুরু করুন:

   gemini
   

6. Gemini CLI-তে, নিম্নলিখিত কমান্ডটি চালিয়ে MCP সার্ভারের সাথে প্রমাণীকরণ করুন:

   /mcp auth chat
   

   1. নির্দেশিত হলে, আপনার ব্রাউজারে একটি প্রমাণীকরণ পৃষ্ঠা খুলতে 1 চাপুন। আপনি যদি SSH-এর মাধ্যমে কাজ করেন, তাহলে CLI-তে দেওয়া নির্দেশাবলী অনুসরণ করুন।
   2. আপনার গুগল অ্যাকাউন্টে সাইন ইন করুন।
   3. অনুরোধকৃত OAuth স্কোপগুলো পর্যালোচনা করুন এবং Allow-এ ক্লিক করুন।
   4. প্রমাণীকরণ সফল হয়েছে তা নিশ্চিত করে একটি বার্তা প্রদর্শিত হয়।

7. Gemini CLI-তে, আপনার কনফিগার করা MCP সার্ভার এবং সেগুলোর টুলগুলো দেখতে /mcp list চালান।

   প্রতিক্রিয়াটি নিম্নলিখিতের অনুরূপ:

   🟢 chat - Ready (2 tools)
     Tools:
     - search_conversations
     - list_messages
   

রিমোট এমসিপি সার্ভারটি জেমিনি সিএলআই-তে ব্যবহারের জন্য প্রস্তুত।

ক্লদ

Claude.ai বা Claude Desktop-এর সাথে Google Chat রিমোট MCP সার্ভার ব্যবহার করতে হলে, আপনার অবশ্যই Claude Enterprise, Pro, Max, বা Team প্ল্যান থাকতে হবে।

Claude-এ Google Chat রিমোট MCP সার্ভার যোগ করতে, একটি OAuth ক্লায়েন্ট আইডি এবং সিক্রেট দিয়ে একটি কাস্টম কানেক্টর কনফিগার করুন।

1. একটি OAuth 2.0 ক্লায়েন্ট আইডি এবং সিক্রেট তৈরি করুন:

   1. Google Cloud কনসোলে, Google Auth Platform > Clients > Create Client- এ যান।

      ক্লায়েন্ট তৈরি করতে যান

   2. অ্যাপ্লিকেশনের ধরণ হিসেবে ওয়েব অ্যাপ্লিকেশন নির্বাচন করুন।

   3. একটি নাম লিখুন।

   4. Authorized redirect URIs সেকশনে, + Add URI-তে ক্লিক করুন এবং তারপরে URIs ফিল্ডে https://claude.ai/api/mcp/auth_callback যোগ করুন।

   5. Create-এ ক্লিক করুন এবং আপনার Client ID ও Client Secret কপি করুন।

2. Claude-এ MCP সার্ভারটি কনফিগার করুন:

   1. Claude.ai বা Claude Desktop-এ, Settings (অথবা Admin settings ) > Connectors- এ যান।
   2. কাস্টম কানেক্টর যোগ করুন -এ ক্লিক করুন।
   3. গুগল চ্যাট প্রোডাক্টের জন্য সংযোগের বিবরণ লিখুন:
      • সার্ভারের নাম : Google Chat ।
      • রিমোট এমসিপি সার্ভার ইউআরএল : https://chatmcp.googleapis.com/mcp/v1
   4. অ্যাডভান্সড সেটিংসে , আপনার OAuth ক্লায়েন্ট আইডি এবং OAuth ক্লায়েন্ট সিক্রেট লিখুন।
   5. যোগ করুন-এ ক্লিক করুন।

অন্যান্য

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

• সার্ভারের নাম : chat

• সার্ভার ইউআরএল : https://chatmcp.googleapis.com/mcp/v1

• পরিবহন : HTTP

• প্রমাণীকরণ : গুগল চ্যাট রিমোট এমসিপি সার্ভার OAuth 2.0 ব্যবহার করে। বিস্তারিত জানতে, প্রমাণীকরণ এবং অনুমোদন সম্পর্কে জানুন দেখুন।

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

গুগল চ্যাট এমসিপি সার্ভার পরীক্ষা করুন

এমসিপি ক্লায়েন্ট কনফিগার করার পর, আপনি কয়েকটি টেস্ট প্রম্পট চালিয়ে সংযোগটি যাচাই করতে পারেন।

আপনার এমসিপি ক্লায়েন্টকে নিম্নলিখিত প্রশ্নগুলো জিজ্ঞাসা করে দেখুন:

• 'প্রজেক্ট এক্স' স্পেসের শেষ বার্তাটি কী ছিল?

  ক্লায়েন্ট search_conversations ব্যবহার করে স্পেসটি খুঁজে বের করে এবং তারপর list_messages ব্যবহার করে মেসেজগুলো পুনরুদ্ধার করে।

যদি টুলগুলো সফলভাবে কাজ করে এবং আপনি প্রাসঙ্গিক উত্তর পান, তাহলে আপনার গুগল চ্যাট এমসিপি সার্ভারটি সঠিকভাবে কনফিগার করা আছে।

সমস্যা সমাধান

এমসিপি সার্ভারে সংযোগ করতে সমস্যা হলে, আপনি OAuth লগগুলিতে ত্রুটি পরীক্ষা করতে পারেন। আপনার অ্যাডমিনিস্ট্রেটরকে নিরাপত্তা তদন্ত টুলে OAuth লগ ইভেন্টগুলি পরীক্ষা করতে বলুন।

টুল রেফারেন্স

গুগল চ্যাট এমসিপি সার্ভারের জন্য নিম্নলিখিত টুলগুলো উপলব্ধ রয়েছে:

• search_conversations
• list_messages

গুরুত্বপূর্ণ নিরাপত্তা বিবেচনা: পরোক্ষ প্রম্পট ইনজেকশন

যখন আপনি কোনো ল্যাঙ্গুয়েজ মডেলকে অবিশ্বস্ত ডেটার সংস্পর্শে আনেন, তখন একটি পরোক্ষ প্রম্পট ইনজেকশন আক্রমণের ঝুঁকি থাকে। যেহেতু Gemini CLI-এর মতো MCP ক্লায়েন্টগুলো Google Chat MCP সার্ভারের মাধ্যমে শক্তিশালী টুলস এবং API-গুলোতে অ্যাক্সেস পায়, তাই তারা আপনার Google অ্যাকাউন্টের ডেটা পড়তে, পরিবর্তন করতে এবং মুছে ফেলতে পারে।

এই ঝুঁকিগুলো প্রশমিত করতে নিম্নলিখিত সর্বোত্তম পদ্ধতিগুলো অনুসরণ করুন:

• শুধুমাত্র বিশ্বস্ত টুল ব্যবহার করুন। গুগল চ্যাট এমসিপি সার্ভারকে কখনও অবিশ্বস্ত বা যাচাইবিহীন অ্যাপ্লিকেশনের সাথে সংযুক্ত করবেন না।
• অবিশ্বস্ত ইনপুটের ক্ষেত্রে সতর্ক থাকুন। আপনার এমসিপি ক্লায়েন্টকে যাচাইবিহীন উৎস থেকে বার্তা বা অন্যান্য রিসোর্স প্রসেস করতে বলা থেকে বিরত থাকুন। এই ইনপুটগুলিতে লুকানো নির্দেশাবলী থাকতে পারে যা আপনার সেশন হাইজ্যাক করতে পারে, যার ফলে একজন আক্রমণকারী আপনার ডেটা পরিবর্তন, চুরি বা মুছে ফেলতে পারে।
• সমস্ত কার্যকলাপ পর্যালোচনা করুন। আপনার পক্ষে আপনার এআই ক্লায়েন্টের গৃহীত পদক্ষেপগুলি সঠিক এবং আপনার উদ্দেশ্যের সাথে সামঞ্জস্যপূর্ণ কিনা তা নিশ্চিত করতে সর্বদা সতর্কতার সাথে পর্যালোচনা করুন।

সম্পর্কিত বিভাগ

• ক্যালেন্ডার এমসিপি সার্ভার কনফিগার করুন
• জিমেইল এমসিপি সার্ভার কনফিগার করুন
• ড্রাইভ এমসিপি সার্ভার কনফিগার করুন
• পিপল এপিআই এমসিপি সার্ভার কনফিগার করুন