Workspace-এর জন্য Universal Search MCP সার্ভারের মাধ্যমে AI এজেন্টকে Workspace জুড়ে সার্চ করতে দিন

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

Google Workspace-এর জন্য ইউনিভার্সাল সার্চ MCP সার্ভার মডেল কন্টেক্সট প্রোটোকল (MCP) স্ট্যান্ডার্ড ব্যবহার করে যাতে AI এজেন্ট আপনার Workspace আর্টিফ্যাক্ট সার্চ করতে পারে। এই সার্ভার একটি টুল ব্যবহার করে Gmail মেসেজ, Google Drive ফাইল, Google Calendar ইভেন্ট এবং Google Chat স্পেস ও মেসেজ সহ একাধিক Google Workspace প্রোডাক্ট জুড়ে সার্চ করার সুবিধা প্রদান করে।

Universal Search MCP Server, AI এজেন্টদের জন্য একটি স্ট্যান্ডার্ডাইজড পদ্ধতি প্রদান করে যার মাধ্যমে তারা আপনার সম্পূর্ণ Google Workspace অ্যাকাউন্ট জুড়ে তথ্য সার্চ করতে পারে, এর জন্য তাদের আলাদা আলাদা প্রোডাক্ট-নির্দিষ্ট টুল কল করতে হয় না।

পূর্বশর্ত

• Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রাম-এর মেম্বারশিপ।

• একটি Google Cloud প্রোজেক্ট। প্রোজেক্ট তৈরি করতে, প্রোজেক্ট তৈরি করুন বিকল্প দেখুন।

• Google Antigravity-এর মতো একটি MCP ক্লায়েন্ট।

• এই পৃষ্ঠায় কমান্ড রান করতে, নিম্নলিখিত ডেভেলপমেন্ট এনভায়রনমেন্টের মধ্যে কোনও একটিতে gcloud CLI সেট-আপ করুন:

  Cloud Shell

  gcloud CLI আগে থেকেই সেট-আপ করা আছে এমন অনলাইন টার্মিনাল ব্যবহার করতে, Cloud Shell অ্যাক্টিভেট করুন:

  Cloud Shell চালু করুন

  লোকাল শেল

  লোকাল ডেভেলপমেন্ট এনভায়রনমেন্ট ব্যবহার করতে, এই ধাপগুলি অনুসরণ করুন:

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

ইউনিভার্সাল সার্চ MCP সার্ভার কনফিগার করুন

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

API চালু করুন

Universal Search MCP সার্ভার ব্যবহার করতে, আপনার Google Cloud প্রোজেক্টে Google Workspace MCP API চালু করুন:

CLI

gcloud services enable workspacemcp.googleapis.com \
  --project=PROJECT_ID

PROJECT_ID-এর জায়গায় আপনার Google Cloud প্রোজেক্ট আইডি লিখুন।

কনসোল

Google Cloud কনসোলে API চালু করুন:

API চালু করুন

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

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

আপনি যদি ইতিমধ্যেই অন্যান্য MCP সার্ভারের জন্য OAuth সম্মতি স্ক্রিন কনফিগার করে থাকেন, তাহলে নিশ্চিত করুন যে আপনি Universal Search MCP সার্ভারের জন্য প্রয়োজনীয় স্কোপ যোগ করেছেন।

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

যেমন, আপনি যদি নিম্নলিখিত সবকটি স্কোপের মাধ্যমে যাচাই করেন:

• https://www.googleapis.com/auth/gmail.readonly
• https://www.googleapis.com/auth/drive.readonly
• https://www.googleapis.com/auth/calendar.readonly
• https://www.googleapis.com/auth/chat.messages.readonly
• https://www.googleapis.com/auth/chat.spaces.readonly
• https://www.googleapis.com/auth/chat.memberships.readonly

Universal Search MCP Server, Gmail, Google Drive, Google Calendar ও Google Chat জুড়ে সার্চ করবে।

তবে, আপনি যদি https://www.googleapis.com/auth/gmail.readonly বাদ দিয়ে শুধু https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.spaces.readonly এবং https://www.googleapis.com/auth/chat.memberships.readonly-এ অ্যাক্সেস দেন, তাহলে ইউনিভার্সাল সার্চ শুধু Google Drive, Google Calendar এবং Google Chat থেকে ফলাফল দেখায়। এটি আপনার ইমেল সার্চ করে না বা Gmail ফলাফল দেখায় না।

1. Google Cloud কনসোলে, Google Auth Platform > ডেটা অ্যাক্সেস বিকল্পে যান।
2. স্কোপ যোগ করুন বা সরান বিকল্পে ক্লিক করুন।

3. নিম্নলিখিত এক বা একাধিক স্কোপ যোগ করুন:

   • https://www.googleapis.com/auth/gmail.readonly
   • https://www.googleapis.com/auth/drive.readonly
   • https://www.googleapis.com/auth/calendar.readonly
   • https://www.googleapis.com/auth/chat.messages.readonly
   • https://www.googleapis.com/auth/chat.spaces.readonly
   • https://www.googleapis.com/auth/chat.memberships.readonly

   https://www.googleapis.com/auth/chat.spaces.readonly এবং https://www.googleapis.com/auth/chat.memberships.readonly অন্তর্ভুক্ত করুন যাতে সার্ভার বলতে পারে যে প্রতিটি Google Chat কথোপকথনে কে কে আছেন। এগুলি ছাড়া, Google Chat-এর ফলাফল এক্সটার্নাল ডোমেনে শেয়ার করা হিসেবে বিবেচনা করা হয় এবং এর জন্য ব্যবহারকারীর কনফার্মেশন প্রয়োজন হতে পারে অথবা ফিল্টার করে বাদ দেওয়া হতে পারে।

4. আপডেট করুন এবং তারপর সেভ করুন বিকল্পে ক্লিক করুন।

সম্মতি সংক্রান্ত স্ক্রিন সেট-আপ করার ব্যাপারে বিস্তারিত নির্দেশাবলীর জন্য, Google Workspace MCP সার্ভার কনফিগার করুন দেখুন।

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

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

Universal Search MCP সার্ভারকে কল করা ব্যবহারকারী-প্রতিনিধি OAuth 2.0 ক্লায়েন্ট আইডিতে Google Auth Platform > Clients-এ AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিতে হবে। আগে থেকে থাকা OAuth 2.0 ক্লায়েন্ট আইডি আপডেট করতে, Google Auth প্ল্যাটফর্ম > ক্লায়েন্ট-এ গিয়ে এই সেটিং বেছে নিন, যেমনটি OAuth ক্লায়েন্ট ম্যানেজ করুন-এ বর্ণনা করা হয়েছে। আপনি যদি আগে থেকে থাকা ক্লায়েন্টে এই সেটিং পরিবর্তন করতে না পারেন অথবা ক্লায়েন্ট যদি এজেন্ট নয় এমন ফিচারও সাপোর্ট করে, তাহলে আপনার AI এজেন্টের জন্য নতুন OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করুন। প্রত্যাখ্যাত অনুরোধ, ডোমেন-ওয়াইড ডেলিগেশন সহ পরিষেবা অ্যাকাউন্ট বা Google Apps Script-এর জন্য, সমস্যার সমাধানকরণ দেখুন।

Antigravity

Antigravity-তে ইউনিভার্সাল সার্চ MCP সার্ভার যোগ করতে, আপনার mcp_config.json ফাইলে সার্ভার কনফিগারেশন যোগ করুন। এই নির্দেশাবলী Antigravity 2.0, Antigravity IDE ও Antigravity CLI-এর ক্ষেত্রে প্রযোজ্য।

1. ওয়েব অ্যাপ্লিকেশন ধরনের OAuth 2.0 ক্লায়েন্ট আইডি ও সিক্রেট তৈরি করুন। অনুমোদিত রিডাইরেক্ট URI বিভাগে, + URI যোগ করুন বিকল্পে ক্লিক করুন এবং তারপরে URI ফিল্ডে https://antigravity.google/oauth-callback যোগ করুন। AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন। নির্দেশাবলীর জন্য, Google Workspace MCP সার্ভার কনফিগার করুন দেখুন।

2. কনফিগারেশন ফাইল ~/.gemini/config/mcp_config.json খুলুন বা তৈরি করুন।

3. mcp_config.json-এ workspace-universal কনফিগারেশন যোগ করুন:

   {
     "mcpServers": {
       "workspace-universal": {
         "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       }
     }
   }
   

   নিম্নলিখিতগুলি পরিবর্তন করুন:

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

4. mcp_config.json সেভ করুন।

5. MCP সার্ভার যাচাই করুন। আপনি GUI সেটিংস বা CLI ব্যবহার করে যাচাই করতে পারবেন:

   • Antigravity IDE বা GUI (Antigravity 2.0)-এর জন্য:

     1. আপনার সেটিংস স্ক্রিন খুলুন (যেমন, নিচে-বাঁদিকে সেটিংস বিকল্পে ক্লিক করুন অথবা Antigravity ব্যবহারকারীর সেটিংস খুলুন)।
     2. কাস্টমাইজেশন বিকল্পে যান।
     3. ইনস্টল করা MCP সার্ভার বিকল্পের মধ্যে, রিফ্রেশ করুন বিকল্পে ক্লিক করুন।
     4. তালিকায় workspace-universal খুঁজে নিন, যাচাই করুন বিকল্পে ক্লিক করুন, আপনার Google অ্যাকাউন্টে সাইন-ইন করুন, অনুমোদনের কোড কপি করুন, ইনপুট ডায়ালগে এটি পেস্ট করুন এবং জমা দিন বিকল্পে ক্লিক করুন।

   • Antigravity CLI-এর জন্য:

     1. Antigravity CLI চালু করুন:

        agy
        

     2. এটি রান করে ইন্টার‍্যাক্টিভ MCP ম্যানেজমেন্ট প্যানেল খুলুন:

        /mcp
        

     3. তীরচিহ্ন ব্যবহার করে workspace-universal বেছে নিন, যাচাইকরণ করুন অ্যাকশনে যান এবং Enter প্রেস করুন। আপনার ব্রাউজারে সাইন-ইন ফ্লো সম্পূর্ণ করুন, অনুমোদন কোড কপি করুন, এটি টার্মিনাল প্রম্পটে পেস্ট করুন এবং Enter প্রেস করুন।

6. সার্ভার সঠিকভাবে কনফিগার করা হয়েছে এবং চলছে কিনা তা যাচাই করুন:

   • Antigravity IDE বা GUI-এর জন্য: কাস্টমাইজেশন > ইনস্টল করা MCP সার্ভার বিকল্পের অধীনে workspace-universal-এর পাশে সাইন-আউট করুন বোতাম দেখানো হয়।
   • Antigravity CLI-এর জন্য: আপনার কনফিগার করা MCP সার্ভার দেখতে /mcp প্যানেল খুলুন। যাচাই ও অথেন্টিকেট করা সার্ভার ইন্টার‍্যাক্টিভ TUI প্যানেলের মধ্যে তাদের নামের পাশে Authed দেখায়। আপনি ড্যাশবোর্ড ভিউতে workspace-universal সার্ভার বেছে নিয়ে সেটির স্ট্যাটাস চেক করতে এবং সেটির সব উপলভ্য টুলের তালিকা দেখতে পারবেন।

Claude

Claude-এ ইউনিভার্সাল সার্চ MCP সার্ভার যোগ করতে, কাস্টম কানেক্টর কনফিগার করুন।

1. ওয়েব অ্যাপ্লিকেশন ধরনের OAuth 2.0 ক্লায়েন্ট আইডি ও সিক্রেট তৈরি করুন এবং AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন। নির্দেশাবলীর জন্য, Google Workspace MCP সার্ভার কনফিগার করুন দেখুন।

2. Claude সেটিংসে, কাস্টম কানেক্টর যোগ করুন:

   • সার্ভারের নাম: Universal Search MCP Server
   • রিমোট MCP সার্ভার URL: https://workspacemcp.googleapis.com/mcp/v1
   • OAuth ক্লায়েন্ট আইডি এবং OAuth ক্লায়েন্ট সিক্রেট: আপনার ক্রেডেনশিয়াল লিখুন।
   • স্কোপ: অন্তর্ভুক্ত https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.spaces.readonly, এবং https://www.googleapis.com/auth/chat.memberships.readonly.

ইউনিভার্সাল সার্চ MCP সার্ভার টেস্ট করুন

আপনার MCP ক্লায়েন্টকে এমন প্রশ্ন জিজ্ঞাসা করে দেখুন যার উত্তর পেতে বিভিন্ন প্রোডাক্ট জুড়ে সার্চ করতে হয়:

• "আমার ইমেল, Docs এবং চ্যাট মেসেজ জুড়ে প্রজেক্ট X সম্পর্কিত যেকোনও কিছু খুঁজে বের করো।"
• "মার্কেটিং প্ল্যান সম্পর্কে আমার পরবর্তী মিটিং কখন এবং এই বিষয়ে লেটেস্ট নোট ও চ্যাট মেসেজ কী?"

টুলগুলি সফলভাবে কাজ করলে এবং আপনি একাধিক প্রোডাক্ট থেকে প্রাসঙ্গিক উত্তর পেলে, আপনার Universal Search MCP সার্ভার সঠিকভাবে কনফিগার করা হয়েছে।

মানানসই টুল

Universal Search MCP সার্ভার নিম্নলিখিত টুল অফার করে। ইনপুট ও আউটপুট স্কিমার জন্য, ইউনিভার্সাল সার্চ MCP রেফারেন্স দেখুন।

• search_corpus: প্রদত্ত কোয়েরির উপর ভিত্তি করে Drive, Gmail, Calendar ও Chat সহ একাধিক Google Workspace প্রোডাক্ট জুড়ে সার্চ করে।