Google Workspace MCP ও Gemini CLI ব্যবহার শুরু করা

১. ভূমিকা

মনে রাখবেন: আপনি কি এখনও Gemini CLI ব্যবহার করছেন? পরিবর্তে Antigravity CLI-এর মাধ্যমে Google Workspace MCP সার্ভার সেট-আপ করার ব্যাপারে জানতে এই কোডল্যাব দেখুন। ট্রানজিশন সম্পর্কে আরও তথ্য এই অফিসিয়াল ব্লগ পোস্টে পাওয়া যাবে।

এই কোডল্যাবে, আপনি শিখবেন কীভাবে মডেল কনটেক্সট প্রোটোকল (MCP) ব্যবহার করে Gemini CLI-কে আপনার Google Workspace ডেটা-র সাথে কানেক্ট করতে হয়। MCP হল একটি ওপেন স্ট্যান্ডার্ড যা AI মডেলকে রিমোট সার্ভার দ্বারা প্রদান করা টুল নিরাপদে ব্যবহার করতে দেয়। আপনি কোনও কোড না লিখেই Gmail, Google Drive, Google Calendar, Google Chat এবং People API-এর সাথে ইন্টার‍্যাক্ট করার জন্য আপনার ক্লায়েন্ট হিসেবে Gemini CLI ব্যবহার করবেন!

আপনি কী করবেন

• আপনার Google Cloud প্রোজেক্টে Google Workspace MCP পরিষেবা চালু করুন।
• এইসব MCP পরিষেবা ব্যবহার করতে Gemini CLI কনফিগার করুন।
• আপনার Google Workspace ডেটার সাথে ইন্টার‍্যাক্ট করে এমন মজাদার ও উপযোগী প্রম্পট দিয়ে ইন্টিগ্রেশন পরীক্ষা করুন।

আপনার কী প্রয়োজন হবে

• Chrome-এর মতো ওয়েব ব্রাউজার
• একটি Google Cloud প্রোজেক্ট
• একটি Google Workspace অ্যাকাউন্ট
• আপনার লোকাল মেশিনে Gemini CLI ইনস্টল করা আছে

এই কোডল্যাব সম্পূর্ণ করতে প্রায় ৩০ মিনিট সময় লাগবে।

এই কোডল্যাবে সহজে অ্যাক্সেস

২. শুরু করার আগে

Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রাম: Google Workspace MCP সার্ভারের অ্যাক্সেস পাবলিক ডেভেলপার প্রিভিউ প্রোগ্রামের অংশ। আপনি আগে থেকে সাইন-আপ না করে থাকলে, সাইন-আপ করুন এবং https://developers.google.com/workspace/preview লিঙ্কে গিয়ে আপনার অ্যাকাউন্ট প্রোগ্রামে গৃহীত হয়েছে কিনা তা নিশ্চিত করুন।

Google Cloud প্রোজেক্ট তৈরি বা বেছে নিন

Google Cloud Console-এ, Google Cloud প্রোজেক্ট বেছে নিন বা তৈরি করুন।

API চালু করুন

Google Workspace MCP সার্ভার ব্যবহার করতে, আপনাকে অবশ্যই স্ট্যান্ডার্ড Google Workspace API চালু করতে হবে। কিছু MCP সার্ভার স্বাধীনভাবে কাজ করলেও, অন্যদের এখনও অন্তর্নিহিত স্ট্যান্ডার্ড API চালু করতে হয়:

• Gmail এবং Chat-এর জন্য এখনও স্ট্যান্ডার্ড API প্রয়োজন।
• নির্দিষ্ট কিছু টুলের জন্য Drive-এর স্ট্যান্ডার্ড API প্রয়োজন।
• Calendar-এর জন্য স্ট্যান্ডার্ড API চালু করার প্রয়োজন নেই।
• People API স্ট্যান্ডার্ড অ্যাক্সেস ও MCP কার্যকারিতা, দুটিই ম্যানেজ করে, তাই এটি চালু করার জন্য আলাদা কোনও MCP পরিষেবা নেই।

API চালু করুন

MCP পরিষেবা চালু করুন

এরপর, প্রোডাক্টের জন্য নির্দিষ্ট MCP পরিষেবা চালু করুন।

MCP পরিষেবা চালু করুন

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

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

1. Google Cloud কনসোলে, Google Chat API সার্চ করুন এবং Google Chat API > ম্যানেজ করুন > কনফিগারেশন বিকল্পে ক্লিক করুন।Google Chat API-তে যান
2. Chat অ্যাপ সেট-আপ করুন:
   • অ্যাপের নাম ফিল্ডে, Chat MCP লিখুন।
   • অবতার URL ফিল্ডে, https://developers.google.com/chat/images/quickstart-app-avatar.png লিখুন।
   • বিবরণ-এ, Chat MCP server লিখুন।
   • ফাংশনালিটি বিকল্পের মধ্যে, ইন্টার‍্যাক্টিভ ফিচার চালু করুন বিকল্প বন্ধ করুন।
   • লগ বিকল্পের অধীনে, লগিংয়ে লগ সংক্রান্ত সমস্যা বিকল্প বেছে নিন।
3. সেভ করুন বিকল্পে ক্লিক করুন।

৩. OAuth সম্মতি ও ক্লায়েন্ট কনফিগার করুন

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

OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন সেট-আপ করা

Google Workspace MCP সার্ভার যাচাইকরণের জন্য OAuth 2.0 ব্যবহার করে। আপনাকে প্রথমে সম্মতি সংক্রান্ত স্ক্রিন কনফিগার করতে হবে।

1. Google Cloud কনসোলে, Google Auth Platform > ব্র্যান্ডিং বিকল্পে যান। কনফিগার করা না থাকলে, শুরু করুন বিকল্পে ক্লিক করুন।
2. অ্যাপের তথ্য কনফিগার করুন:
   • অ্যাপের নাম: Google Workspace MCP Servers
   • ব্যবহারকারী সহায়তা ইমেল: আপনার ইমেল বেছে নিন।
3. দর্শক কনফিগার করুন: ইন্টার্নাল (অথবা ইন্টার্নাল উপলভ্য না থাকলে এক্সটার্নাল) বেছে নিন।
4. যোগাযোগের তথ্য কনফিগার করুন: আপনার ইমেল আইডি লিখুন।
5. ব্যবহারকারীর ডেটা সংক্রান্ত নীতি পর্যালোচনা করে সম্মতি জানান, তারপর তৈরি করুন বিকল্পে ক্লিক করুন।
6. আপনি এক্সটার্নাল বেছে নিলে, দর্শক বিকল্পে যান এবং টেস্ট ব্যবহারকারী বিকল্পের অধীনে আপনার ইমেল যোগ করুন।
7. ডেটা অ্যাক্সেস > স্কোপ যোগ করুন বা সরান বিকল্পে যান। ম্যানুয়ালি স্কোপ যোগ করুন বিকল্পের অধীনে, আপনি যেসব সার্ভার ব্যবহার করতে চান সেগুলির জন্য নিম্নলিখিত তথ্য যোগ করুন:
   • Google Calendar: https://www.googleapis.com/auth/calendar.calendarlist.readonly, https://www.googleapis.com/auth/calendar.events.freebusy, https://www.googleapis.com/auth/calendar.events.readonly
   • Google Chat: 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
   • Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • People API: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
8. টেবিলে যোগ করুন, তারপর আপডেট করুন এবং শেষে সেভ করুন বিকল্পে ক্লিক করুন।

OAuth ক্লায়েন্ট আইডি তৈরি করুন

Google Workspace MCP সার্ভারের জন্য OAuth 2.0 ক্লায়েন্ট কনফিগার করার সময়, আপনাকে অবশ্যই AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিয়ে এজেন্টিক ক্লাসিফিকেশন সেটিং (is_agentic) চালু করতে হবে। এই সেটিং চালু না করা OAuth ক্লায়েন্টদের Google Workspace MCP এন্ডপয়েন্টে কল করা থেকে ব্লক করা হয়।

1. Google Auth প্ল্যাটফর্ম > ক্লায়েন্ট > ক্লায়েন্ট তৈরি করুন (অথবা API ও পরিষেবা > ক্রেডেনশিয়াল > ক্রেডেনশিয়াল তৈরি করুন > OAuth ক্লায়েন্ট আইডি) বিকল্পে যান।
2. অ্যাপ্লিকেশনের ধরন হিসেবে ডেস্কটপ অ্যাপ বেছে নিন।
3. এটির নাম Gemini CLI দিন।
4. OAuth ক্লায়েন্টে is_agentic ক্লাসিফিকেশন ফ্ল্যাগ চালু করতে, AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন।
5. তৈরি করুন বিকল্পে ক্লিক করে ক্লায়েন্ট আইডি ও ক্লায়েন্ট সিক্রেট কপি করুন। পরবর্তী ধাপে আপনার এগুলি প্রয়োজন হবে।

৪. Gemini CLI কনফিগার করা

এখন এই এন্ডপয়েন্টগুলি ব্যবহার করার জন্য Gemini CLI কনফিগার করা যাক। আপনার Gemini CLI ইনস্টল করা না থাকলে, Gemini CLI ওয়েবসাইট থেকে ইনস্টলেশন সংক্রান্ত নির্দেশাবলী অনুসরণ করুন।

লোকাল এনভায়রনমেন্ট প্রয়োজন: এই ধাপের জন্য Cloud Shell ব্যবহার করবেন না। OAuth যাচাইকরণের জন্য Gemini CLI-এর একটি লোকাল ব্রাউজার প্রয়োজন। আপনার লোকাল মেশিনের টার্মিনাল ব্যবহার করুন। আরও তথ্যের জন্য ব্রাউজার রিডাইরেক্ট সংক্রান্ত প্রয়োজনীয়তা দেখুন।

কনফিগারেশন ফাইল তৈরি করুন

আপনার হোম ডিরেক্টরিতে ~/.gemini/settings.json খুলুন বা তৈরি করুন এবং নিম্নলিখিত কনফিগারেশন যোগ করুন। প্লেসহোল্ডারের জায়গায় আপনার OAuth ক্রেডেনশিয়াল লিখুন।

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_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"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

৫. MCP সার্ভার যাচাই ও কনফার্ম করা

MCP সার্ভার ব্যবহার করার আগে, আপনাকে অবশ্যই সেগুলি কানেক্ট করা আছে কিনা তা যাচাই করতে হবে।

Gemini CLI শুরু করুন

Gemini CLI চালু করতে আপনার টার্মিনালে নিম্নলিখিত কমান্ড রান করুন:

gemini

যাচাইকরণ করুন

Gemini CLI-তে সংশ্লিষ্ট কমান্ড রান করে আপনি যে পরিষেবা পরীক্ষা করতে চান সেটি যাচাই করুন। এই কোডল্যাবে আপনি যে পরিষেবা ব্যবহার করার পরিকল্পনা করছেন, শুধুমাত্র সেটির সাথে যাচাইকরণ করতে হবে।

Calendar

/mcp auth calendar

চ্যাট

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

লোকজন

/mcp auth people

প্রতিটি পরিষেবা অনুমোদিত করতে আপনার ব্রাউজারে প্রম্পট অনুসরণ করুন।

কানেকশন যাচাই করুন

টুল লোড করা হয়েছে এবং রেডি আছে কিনা তা যাচাই করুন:

/mcp list

আপনি আউটপুট দেখতে পাবেন যা থেকে বোঝা যাবে যে পরিষেবাগুলি তাদের টুল সহ Ready।

৬. MCP সার্ভার পরীক্ষা করুন

এখন আপনি ন্যাচারাল ল্যাঙ্গুয়েজ ব্যবহার করে আপনার Google Workspace ডেটার সাথে ইন্টার‍্যাক্ট করতে পারবেন। প্রতিটি পরিষেবার জন্য এখানে কিছু প্রম্পটের উদাহরণ দেওয়া হল।

মনে রাখবেন: নিচের প্রম্পটে বন্ধনীতে থাকা প্লেসহোল্ডার (যেমন, [NAME], [FILE_NAME]) আপনার Google Workspace ডেটার আসল ভ্যালু দিয়ে পরিবর্তন করুন।

Google Calendar

আপনার শিডিউল সম্পর্কে Gemini-কে জিজ্ঞাসা করে দেখুন:

• "এই সপ্তাহে আমার আসন্ন মিটিংগুলি কী কী?"
• "আগামীকাল বিকেলে আমার কি কোনও ফ্রি টাইম আছে?"

Google Chat

Gemini-কে মেসেজ সার্চ করতে বলে দেখুন:

• "‘[SPACE_NAME]'-এ ‘[KEYWORD]' আছে এমন মেসেজ খোঁজো"

Google Drive

Gemini-কে ফাইল খুঁজতে বা পড়তে বলে দেখুন:

• "আমার Google Drive-এ ‘[KEYWORD]' আছে এমন ফাইল সার্চ করো।"
• "আমার এডিট করা সবচেয়ে সাম্প্রতিক ডকুমেন্টগুলির তালিকা দেখাও।"
• "আমার ‘[FILE_NAME]' ডকুমেন্টের কন্টেন্ট পড়ে মূল লক্ষ্যগুলির সারসংক্ষেপ করো।"

Gmail

Gemini-কে আপনার ইমেল সার্চ বা ম্যানেজ করতে বলে দেখুন:

• "আমার পাওয়া শেষ ৫টি ইমেলের সারসংক্ষেপ করো।"
• "‘[PROJECT_NAME]' প্রোজেক্টের আপডেট চেয়ে ‘[EMAIL_ADDRESS]' আইডিতে পাঠানোর জন্য একটি ইমেল ড্রাফ্ট করো।"

People API

আপনার প্রোফাইল বা পরিচিতি সম্পর্কে Gemini-কে জিজ্ঞাসা করে দেখুন:

• "আমার Google প্রোফাইল অনুযায়ী, আমার নাম কী?"
• "‘[NAME]'-এর পরিচিতির তথ্য খোঁজো।"

একাধিক পরিষেবা একত্রিত করা

Gemini যখন একাধিক পরিষেবা জুড়ে টাস্ক অর্কেস্ট্রেট করে তখন MCP-এর আসল ক্ষমতা বোঝা যায়। ক্রস-সার্ভিস ক্ষমতা প্রদর্শন করে এমন এইসব প্রম্পট ব্যবহার করে দেখুন:

• "Drive-এ ‘[PROJECT_NAME] মাইলস্টোন আপডেট' সম্পর্কিত ফাইল সার্চ করো, সেগুলির কন্টেন্টের সারসংক্ষেপ তৈরি করো, ‘[NAME]'-এর ইমেল আইডি খুঁজে বের করো এবং সারসংক্ষেপ সহ তাদের জন্য একটি Gmail ড্রাফ্ট তৈরি করো।"

আরও টুল এক্সপ্লোর করুন

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

৭. অপ্রয়োজনীয়গুলি মুছুন

আপনার প্রোজেক্ট না মুছেই ক্লিন-আপ করতে, আপনি চালু করা API এবং MCP পরিষেবা বন্ধ করতে পারেন:

1. Google Cloud Console-এ, API ও পরিষেবা ড্যাশবোর্ড-এ যান।
2. আপনার চালু করা প্রতিটি Google Workspace এবং MCP API-তে (যেমন, Calendar MCP, Chat MCP) ক্লিক করুন এবং API বন্ধ করুন বিকল্পে ক্লিক করুন।

আপনি যদি আর OAuth ক্লায়েন্ট ক্রেডেনশিয়াল ব্যবহার করতে না চান, তাহলে Google Auth Platform কনসোল থেকে সেটি মুছে দিন।

৮. অভিনন্দন

অভিনন্দন! আপনি Gemini CLI ব্যবহার করে অফিসিয়াল Google Workspace MCP সার্ভার কনফিগার ও টেস্ট করেছেন।

আপনি যা শিখেছেন

• Google Cloud-এ Google Workspace MCP পরিষেবা কীভাবে চালু করতে হয়।
• MCP-এর জন্য কীভাবে OAuth ক্লায়েন্ট কনফিগার করতে হয়।
• স্ট্যান্ডার্ড টুল ব্যবহার করে Google Workspace ডেটার সাথে ইন্টার‍্যাক্ট করতে কীভাবে Gemini CLI ব্যবহার করবেন।

রেফারেন্স ডকুমেন্ট

• Model Context Protocol (MCP) সম্পর্কে প্রাথমিক তথ্য
• Google Workspace MCP সার্ভার কনফিগার করুন
• OAuth-এর সম্মতি কনফিগার করুন