অ্যান্টিগ্র্যাভিটিতে গুগল ওয়ার্কস্পেস এমসিপি সার্ভার

১. ভূমিকা

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

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

আপনি যা করবেন

  • আপনার গুগল ক্লাউড প্রোজেক্টে গুগল ওয়ার্কস্পেস এমসিপি পরিষেবাগুলি সক্রিয় করুন।
  • এই MCP পরিষেবাগুলি অ্যাক্সেস করার জন্য Antigravity কনফিগার করুন।
  • মজাদার ও দরকারি কিছু প্রম্পটের মাধ্যমে ইন্টিগ্রেশনটি পরীক্ষা করুন, যেগুলো আপনার গুগল ওয়ার্কস্পেস ডেটার সাথে ইন্টারঅ্যাক্ট করে।

আপনার যা যা লাগবে

  • ক্রোমের মতো একটি ওয়েব ব্রাউজার
  • একটি গুগল ক্লাউড প্রকল্প
  • একটি গুগল ওয়ার্কস্পেস অ্যাকাউন্ট
  • আপনার স্থানীয় মেশিনে অ্যান্টিগ্র্যাভিটি ইনস্টল করা আছে

এই কোডল্যাবে সহজে প্রবেশ করা যায়

qr_code.png

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

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

গুগল ক্লাউড কনসোলে , একটি গুগল ক্লাউড প্রজেক্ট নির্বাচন করুন বা তৈরি করুন ।

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

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

  • জিমেইল এবং চ্যাটের জন্য এখনও তাদের স্ট্যান্ডার্ড এপিআই প্রয়োজন।
  • কিছু নির্দিষ্ট টুলের জন্য ড্রাইভে স্ট্যান্ডার্ড এপিআই প্রয়োজন হয়।
  • ক্যালেন্ডার সক্রিয় করার জন্য স্ট্যান্ডার্ড এপিআই চালু করার প্রয়োজন নেই।
  • People API সাধারণ অ্যাক্সেস এবং MCP উভয় কার্যকারিতাই পরিচালনা করে, তাই এটি সক্রিয় করার জন্য কোনো পৃথক MCP পরিষেবা নেই।

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

এরপরে, পণ্যগুলির জন্য নির্দিষ্ট MCP পরিষেবাগুলি সক্রিয় করুন।

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

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

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

  1. চ্যাট অ্যাপটি সেট আপ করুন:
    • অ্যাপের নামের ফিল্ডে Chat MCP লিখুন।
    • Avatar URL ফিল্ডে https://developers.google.com/chat/images/quickstart-app-avatar.png লিখুন।
    • Description- এ Chat MCP server লিখুন।
    • ফাংশনালিটি- এর অধীনে, ‘এনেবল ইন্টারেক্টিভ ফিচারস’ বন্ধ করুন।
    • লগস-এর অধীনে, ত্রুটি লগ করার বিকল্পটি লগিং-এ নির্বাচন করুন।
  2. সংরক্ষণ করুন- এ ক্লিক করুন।

chat_app.png

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

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

গুগল ওয়ার্কস্পেস এমসিপি সার্ভারগুলো প্রমাণীকরণের জন্য OAuth 2.0 ব্যবহার করে। আপনাকে প্রথমে সম্মতি স্ক্রিনটি কনফিগার করতে হবে।

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

oauth_consent_screen.png

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

  1. Google Auth Platform > Clients > Create Client- এ যান।
  2. অ্যাপ্লিকেশনের ধরণ হিসেবে ওয়েব অ্যাপ্লিকেশন নির্বাচন করুন।
  3. এর নাম দিন Antigravity ।
  4. অনুমোদিত রিডাইরেক্ট ইউআরআই (Authorized redirect URIs)- এর অধীনে, + ইউআরআই যোগ করুন (+ Add URI)- এ ক্লিক করুন এবং তারপর https://antigravity.google/oauth-callback লিখুন।
  5. Create-এ ক্লিক করুন এবং Client ID ও Client Secret কপি করুন। পরবর্তী ধাপে আপনার এগুলি প্রয়োজন হবে।

oauth_client.png

৪. অ্যান্টিগ্র্যাভিটি কনফিগার করুন

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

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

  1. এডিটরের এজেন্ট প্যানেলের শীর্ষে থাকা ... ড্রপডাউনের মাধ্যমে এমসিপি সার্ভারগুলো খুলুন।

open_mcp_servers.png

  1. ম্যানেজ এমসিপি সার্ভারস-এ ক্লিক করুন, তারপর ভিউ র কনফিগ-এ ক্লিক করুন ।

manage_mcp_servers.png

  1. নতুন খোলা mcp_config.json ফাইলটি নিম্নলিখিত কাস্টম MCP সার্ভার কনফিগারেশন দিয়ে পরিবর্তন করুন। এটি করার আগে, <YOUR_CLIENT_ID> এবং <YOUR_CLIENT_SECRET> প্লেসহোল্ডারগুলিকে পূর্ববর্তী ধাপে আপনার তৈরি করা OAuth ক্লায়েন্ট আইডি এবং সিক্রেট দিয়ে প্রতিস্থাপন করুন: 
{
  "mcpServers": {
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

mcp_config.png

  1. ম্যানেজ এমসিপি সার্ভারস -এ ফিরে যান, তারপর রিফ্রেশ-এ ক্লিক করুন।

configured_mcp_servers.png

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

  1. উইন্ডোর উপরের দিকে থাকা এডিটর-নির্দিষ্ট সেটিংস মেনু ড্রপডাউনের মাধ্যমে অ্যান্টিগ্র্যাভিটি ব্যবহারকারী সেটিংস খুলুন।

open_user_settings.png

  1. কাস্টমাইজেশন -এ যান।

কাস্টমাইজেশন.png

  1. ইনস্টল করা এমসিপি সার্ভারগুলির অধীনে তালিকাভুক্ত প্রতিটি সার্ভারের জন্য:
    1. প্রমাণীকরণ-এ ক্লিক করুন।

ইনস্টল করা_সার্ভার.png

  1. যে নতুন ব্রাউজার উইন্ডোটি খুলবে, সেখানে প্রমাণীকরণ প্রক্রিয়াটি সম্পন্ন করুন।
  2. সম্পূর্ণ হলে, 'ক্লিপবোর্ডে কপি করুন'-এ ক্লিক করুন।

copy_auth_code.png

  1. ব্রাউজার উইন্ডোটি বন্ধ করুন।
  2. আপনি এইমাত্র যে অথ কোডটি কপি করেছেন, সেটি অ্যান্টিগ্র্যাভিটির সেটিংসে প্রদর্শিত টেক্সট ফিল্ডে পেস্ট করুন।
  3. সাবমিট-এ ক্লিক করুন।

mcp_servers_authenticated.png

৫. পরীক্ষার সরঞ্জাম

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

গুগল ক্যালেন্ডার

আপনার সময়সূচী অনুসন্ধান করে দেখুন:

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

test_prompt.png

গুগল চ্যাট

বার্তা খোঁজার চেষ্টা করুন:

  • '[SPACE_NAME]'-এর মধ্যে '[KEYWORD]' ধারণকারী বার্তাগুলি সন্ধান করুন।

গুগল ড্রাইভ

ফাইলগুলি অনুসন্ধান বা পড়ার চেষ্টা করুন:

  • আমার গুগল ড্রাইভে এমন ফাইলগুলো খুঁজুন যেগুলোতে '[কীওয়ার্ড]' রয়েছে।
  • আমি সম্প্রতি যে নথিগুলো সম্পাদনা করেছি তার তালিকা দিন।
  • আমার '[FILE_NAME]' ডকুমেন্টটির বিষয়বস্তু পড়ুন এবং এর মূল লক্ষ্যগুলো সংক্ষেপে বর্ণনা করুন।

জিমেইল

আপনার ইমেলগুলি অনুসন্ধান বা পরিচালনা করার চেষ্টা করুন:

  • আমি শেষ যে ৫টি ইমেল পেয়েছি তার সারসংক্ষেপ করুন।
  • '[PROJECT_NAME]' প্রজেক্টের হালনাগাদ তথ্য চেয়ে '[EMAIL_ADDRESS]'-এ একটি ইমেল তৈরি করুন।

পিপল এপিআই

আপনার প্রোফাইল বা পরিচিতি অনুসন্ধান করার চেষ্টা করুন:

  • আমার গুগল প্রোফাইল অনুযায়ী আমার নাম কী?
  • '[NAME]'-এর যোগাযোগের তথ্য খুঁজুন।

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

একাধিক সার্ভিসের মধ্যে কাজ সমন্বয় করার মাধ্যমেই MCP-এর প্রকৃত শক্তি উপলব্ধি করা যায়। ক্রস-সার্ভিস সক্ষমতা প্রদর্শনকারী এই প্রম্পটগুলো ব্যবহার করে দেখুন:

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

আরও সরঞ্জাম অন্বেষণ করুন

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

৬. পরিষ্কার করুন

আপনার প্রজেক্টটি ডিলিট না করে পরিষ্কার করতে, আপনি সক্রিয় করা API এবং MCP সার্ভিসগুলো নিষ্ক্রিয় করতে পারেন:

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

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

৭. অভিনন্দন

অভিনন্দন! আপনি অ্যান্টিগ্র্যাভিটি ব্যবহার করে অফিসিয়াল গুগল ওয়ার্কস্পেস এমসিপি সার্ভারগুলো সফলভাবে কনফিগার ও পরীক্ষা করেছেন।

রেফারেন্স নথি