ইউনিভার্সাল সার্চ এমসিপি সার্ভার ফর ওয়ার্কস্পেস ব্যবহার করে এআই এজেন্টদেরকে ওয়ার্কস্পেস জুড়ে অনুসন্ধান করতে দিন।

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

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

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

পূর্বশর্ত

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

• একটি এমসিপি ক্লায়েন্ট, যেমন গুগল অ্যান্টিগ্র্যাভিটি ।

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

  ক্লাউড শেল

  আগে থেকে সেট আপ করা gcloud CLI সহ একটি অনলাইন টার্মিনাল ব্যবহার করতে, ক্লাউড শেল সক্রিয় করুন:

  ক্লাউড শেল সক্রিয় করুন

  স্থানীয় শেল

  স্থানীয় উন্নয়ন পরিবেশ ব্যবহার করতে, এই ধাপগুলো অনুসরণ করুন:

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

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

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

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

ইউনিভার্সাল সার্চ এমসিপি সার্ভার ব্যবহার করতে, আপনার গুগল ক্লাউড প্রজেক্টে গুগল ওয়ার্কস্পেস এমসিপি এপিআই এবং যে প্রোডাক্টগুলো আপনি সার্চ করতে চান সেগুলোর এপিআই সক্রিয় করুন:

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

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

সিএলআই

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
workspacemcp.googleapis.com --project=PROJECT_ID

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

কনসোল

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

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

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

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

আপনি যদি অন্যান্য MCP সার্ভারগুলির জন্য ইতিমধ্যেই OAuth সম্মতি স্ক্রিনটি কনফিগার করে থাকেন, তাহলে নিশ্চিত করুন যে আপনি ইউনিভার্সাল সার্চ 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/drive.readonly , https://www.googleapis.com/auth/calendar.readonly , এবং https://www.googleapis.com/auth/chat.messages.readonly -এ অ্যাক্সেস দেন (এবং https://www.googleapis.com/auth/gmail.readonly বাদ দেন), তাহলে ইউনিভার্সাল সার্চ শুধুমাত্র গুগল ড্রাইভ, গুগল ক্যালেন্ডার এবং গুগল চ্যাট থেকে ফলাফল দেখাবে। এটি আপনার ইমেল সার্চ করবে না বা জিমেইলের ফলাফল দেখাবে না।

1. Google Cloud কনসোলে, Google Auth Platform > Data Access- এ যান।
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

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

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

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

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

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

Antigravity-তে Universal Search MCP সার্ভার যোগ করতে, আপনার mcp_config.json ফাইলে সার্ভার কনফিগারেশনটি যোগ করুন। এই নির্দেশাবলী Antigravity 2.0, Antigravity IDE, এবং Antigravity CLI সমর্থন করে।

1. ওয়েব অ্যাপ্লিকেশন টাইপের একটি OAuth 2.0 ক্লায়েন্ট আইডি এবং সিক্রেট তৈরি করুন। অথরাইজড রিডাইরেক্ট ইউআরআই (Authorized redirect URIs) সেকশনে, + অ্যাড ইউআরআই (+ Add URI)- তে ক্লিক করুন, এবং তারপর ইউআরআই (URIs) ফিল্ডে https://antigravity.google/oauth-callback যোগ করুন। নির্দেশাবলীর জন্য, গুগল ওয়ার্কস্পেস এমসিপি সার্ভার কনফিগার করুন (Configure the Google Workspace MCP servers ) দেখুন।

2. ~/.gemini/antigravity/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. আপনার সেটিংস স্ক্রিনটি খুলুন (যেমন, নীচের-বামে থাকা সেটিংস- এ ক্লিক করুন অথবা অ্যান্টিগ্র্যাভিটি ইউজার সেটিংস খুলুন)।
     2. কাস্টমাইজেশন -এ যান।
     3. Installed MCP Servers-এর অধীনে, Refresh-এ ক্লিক করুন।
     4. তালিকা থেকে workspace-universal খুঁজুন, Authenticate-এ ক্লিক করুন, আপনার Google অ্যাকাউন্টে সাইন ইন করুন, অথরাইজেশন কোডটি কপি করে ইনপুট ডায়ালগে পেস্ট করুন এবং Submit-এ ক্লিক করুন।

   • অ্যান্টিগ্র্যাভিটি সিএলআই-এর জন্য:

     1. অ্যান্টিগ্র্যাভিটি সিএলআই শুরু করুন:

        agy
        

     2. নিম্নলিখিত কমান্ডটি চালিয়ে ইন্টারেক্টিভ এমসিপি ম্যানেজমেন্ট প্যানেলটি খুলুন:

        /mcp
        

     3. অ্যারো কী ব্যবহার করে workspace-universal নির্বাচন করুন, অথেন্টিকেট অ্যাকশনে যান এবং এন্টার চাপুন। আপনার ব্রাউজারে সাইন-ইন প্রক্রিয়াটি সম্পন্ন করুন, অথরাইজেশন কোডটি কপি করে টার্মিনাল প্রম্পটে পেস্ট করুন এবং এন্টার চাপুন।

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

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

ক্লদ

Claude-এ Universal Search MCP Server যোগ করতে, একটি কাস্টম কানেক্টর কনফিগার করুন।

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

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

   • সার্ভারের নাম : Universal Search MCP Server
   • রিমোট এমসিপি সার্ভার ইউআরএল : 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 অন্তর্ভুক্ত করুন।

ইউনিভার্সাল সার্চ এমসিপি সার্ভার পরীক্ষা করুন

আপনার এমসিপি ক্লায়েন্টকে এমন প্রশ্ন জিজ্ঞাসা করার চেষ্টা করুন যার জন্য বিভিন্ন পণ্যের মধ্যে অনুসন্ধান করার প্রয়োজন হয়:

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

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

সমর্থিত সরঞ্জাম

ইউনিভার্সাল সার্চ এমসিপি সার্ভার নিম্নলিখিত টুলটি প্রদান করে:

• search_corpus : প্রদত্ত কোয়েরির উপর ভিত্তি করে একাধিক গুগল ওয়ার্কস্পেস প্রোডাক্টে (গুগল ড্রাইভ, জিমেইল, গুগল ক্যালেন্ডার এবং গুগল চ্যাট) অনুসন্ধান চালায়।