People API MCP সার্ভার কনফিগার করা

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

People API একটি রিমোট Model Context Protocol (MCP) সার্ভার অফার করে যা AI এজেন্টদের Google Workspace প্রোফাইল এবং পরিচিতি ডেটার সাথে নিরাপদে ইন্টার‍্যাক্ট করার অনুমতি দেয়। People API MCP সার্ভার কনফিগার করার মাধ্যমে, আপনি People API ব্যবহার করে অ্যাকশন পারফর্ম করার জন্য Google Antigravity ও Claude-এর মতো AI অ্যাপ্লিকেশন চালু করেন।

People API MCP সার্ভার AI এজেন্টদের জন্য একটি স্ট্যান্ডার্ডাইজড পদ্ধতি প্রদান করে, যার মাধ্যমে তারা:

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

পূর্বশর্ত

• Google Workspace Developer Preview Program-এর মেম্বারশিপ।

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

• Google Antigravity-এর মতো কোনও MCP হোস্ট।

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

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

People API MCP সার্ভার কনফিগার করুন

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

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

People API MCP সার্ভার ব্যবহার করতে, আপনার Google Cloud প্রোজেক্টে নিম্নলিখিত পরিষেবা চালু করতে হবে:

• People API

CLI

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

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

কনসোল

Google Cloud Console-এ API চালু করুন:

API চালু করুন

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

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

1. Google Cloud কনসোলে, Google Auth Platform > ব্র্যান্ডিং বিকল্পে যান।

   ব্র্যান্ডিং বিকল্পে যান

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

   1. অ্যাপ সম্পর্কিত তথ্য বিকল্পের মধ্যে, অ্যাপের নাম বিকল্পে গিয়ে People API MCP Server টাইপ করুন।
   2. ব্যবহারকারী সহায়তা ইমেল-এ, আপনার ইমেল আইডি বা উপযুক্ত Google Group বেছে নিন।
   3. পরবর্তী বিকল্পে ক্লিক করুন।
   4. দর্শক বিকল্পের মধ্যে, ইন্টার্নাল বিকল্প বেছে নিন। আপনি ইন্টার্নাল বেছে নিতে না পারলে, এক্সটার্নাল বেছে নিন।
   5. পরবর্তী বিকল্পে ক্লিক করুন।
   6. যোগাযোগের তথ্য বিকল্পের মধ্যে, একটি ইমেল আইডি লিখুন যেখানে আপনার প্রোজেক্টে কোনও পরিবর্তন হলে আপনাকে বিজ্ঞপ্তি পাঠানো হবে।
   7. পরবর্তী বিকল্পে ক্লিক করুন।
   8. শেষ করুন বিকল্পের অধীনে, Google API পরিষেবা সংক্রান্ত ব্যবহারকারীর ডেটা নীতি পর্যালোচনা করুন এবং আপনি সম্মত হলে, আমি Google API পরিষেবা সংক্রান্ত ব্যবহারকারীর ডেটা নীতিতে সম্মতি জানাচ্ছি বিকল্প বেছে নিন।
   9. চালিয়ে যান বিকল্পে ক্লিক করুন।
   10. তৈরি করুন বিকল্পে ক্লিক করুন।
   11. ব্যবহারকারীর ধরন হিসেবে এক্সটার্নাল বেছে নিলে, টেস্ট ব্যবহারকারী যোগ করুন:
       1. দর্শক বিকল্পে ক্লিক করুন।
       2. টেস্ট ব্যবহারকারী বিকল্পের মধ্যে, ব্যবহারকারী যোগ করুন বিকল্পে ক্লিক করুন।
       3. আপনার ইমেল আইডি ও অন্য কোনও অনুমোদিত টেস্ট ব্যবহারকারীর ইমেল আইডি লিখুন, তারপর সেভ করুন বিকল্পে ক্লিক করুন।

3. ডেটা অ্যাক্সেস > স্কোপ যোগ করুন বা সরিয়ে দিন বিকল্পে ক্লিক করুন। আপনার Google Cloud প্রোজেক্টে চালু করা প্রতিটি API-এর জন্য স্কোপের তালিকা সহ একটি প্যানেল দেখা যাবে।

   1. ম্যানুয়ালি স্কোপ যোগ করুন বিকল্পের অধীনে, People API MCP সার্ভারের জন্য স্কোপ পেস্ট করুন:

      • https://www.googleapis.com/auth/directory.readonly
      • https://www.googleapis.com/auth/userinfo.profile
      • https://www.googleapis.com/auth/contacts.readonly

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

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

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

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

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

Antigravity

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

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

   1. Google Cloud কনসোলে, Google Auth Platform > ক্লায়েন্ট > ক্লায়েন্ট তৈরি করুন বিকল্পে যান

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

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

   3. নাম লিখুন।

   4. অনুমোদিত রিডাইরেক্ট URI বিভাগে, + URI যোগ করুন বিকল্পে ক্লিক করুন, এবং তারপর https://antigravity.google/oauth-callback যোগ করুন URI ফিল্ডে।

   5. তৈরি করুন বিকল্পে ক্লিক করুন এবং আপনার ক্লায়েন্ট আইডি ও ক্লায়েন্ট সিক্রেট কপি করুন।

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

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

   {
     "mcpServers": {
       "people": {
         "serverUrl": "https://people.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. তালিকায় people খুঁজে নিন, যাচাইকরণ করুন বিকল্পে ক্লিক করুন, আপনার Google অ্যাকাউন্টে সাইন-ইন করুন, অনুমোদনের কোড কপি করুন, ইনপুট ডায়ালগে এটি পেস্ট করুন এবং জমা দিন বিকল্পে ক্লিক করুন।

   • Antigravity CLI-এর জন্য:

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

        agy
        

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

        /mcp
        

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

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

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

Antigravity-তে ব্যবহার করার জন্য রিমোট MCP সার্ভার রেডি।

Claude

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

Claude-এ People API রিমোট MCP সার্ভার যোগ করতে, OAuth ক্লায়েন্ট আইডি ও সিক্রেট সহ কাস্টম কানেক্টর কনফিগার করুন।

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

   1. Google Cloud কনসোলে, Google Auth Platform > ক্লায়েন্ট > ক্লায়েন্ট তৈরি করুন বিকল্পে যান

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

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

   3. নাম লিখুন।

   4. অনুমোদিত রিডাইরেক্ট URI বিভাগে, + URI যোগ করুন বিকল্পে ক্লিক করুন, এবং তারপর https://claude.ai/api/mcp/auth_callback URI ফিল্ডে যোগ করুন।

   5. তৈরি করুন বিকল্পে ক্লিক করে আপনার ক্লায়েন্ট আইডি ও ক্লায়েন্ট সিক্রেট কপি করুন।

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

   1. Claude.ai বা Claude Desktop-এ, সেটিংস (বা অ্যাডমিন সেটিংস) > কানেক্টর বিকল্পে যান।
   2. কাস্টম কানেক্টর যোগ করুন বিকল্পে ক্লিক করুন।
   3. People API প্রোডাক্টের জন্য কানেকশনের বিবরণ লিখুন:
      • সার্ভারের নাম: people.
      • রিমোট MCP সার্ভার URL: https://people.googleapis.com/mcp/v1
   4. উন্নত সেটিংস-এ, আপনার OAuth ক্লায়েন্ট আইডি এবং OAuth ক্লায়েন্ট সিক্রেট লিখুন।
   5. যোগ করুন বিকল্পে ক্লিক করুন।

অন্যান্য

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

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

• সার্ভার URL: https://people.googleapis.com/mcp/v1

• ট্রান্সপোর্ট: স্ট্রিম করা যায় এমন HTTP

• অনুমোদন: People API রিমোট MCP সার্ভার OAuth 2.0 ব্যবহার করে। বিস্তারিত জানতে, যাচাইকরণ ও অনুমোদন সম্পর্কে জানুন।

বিভিন্ন ধরনের ক্লায়েন্ট কানেক্ট করা সম্পর্কে আরও বিবরণের জন্য, AI অ্যাপ্লিকেশনে MCP কনফিগার করুন দেখুন।

People API MCP সার্ভার পরীক্ষা করা

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

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

• "আমার Google প্রোফাইল অনুযায়ী, আমার নাম কী?"

  আপনার Google Workspace প্রোফাইল সংক্রান্ত তথ্য পেতে ক্লায়েন্ট people.get_user_profile ব্যবহার করে।

টুল সঠিকভাবে এক্সিকিউট হলে এবং আপনি প্রাসঙ্গিক উত্তর পেলে, আপনার People API MCP সার্ভার সঠিকভাবে কনফিগার করা হয়েছে।

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

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

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

People API MCP সার্ভারের জন্য নিম্নলিখিত টুল উপলভ্য:

• get_user_profile
• search_contacts
• search_directory_people

নিরাপত্তা সংক্রান্ত গুরুত্বপূর্ণ বিষয়: পরোক্ষ প্রম্পট ইঞ্জেকশন

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

এইসব ঝুঁকি কমাতে, আপনাকে অবশ্যই ক্ষতিকর কন্টেন্ট বা প্রম্পট ইনজেকশন অ্যাটাকের জন্য প্রম্পট ও উত্তর স্ক্রিন করতে হবে। আপনি Google-এর দেওয়া মডেল আর্মার ব্যবহার করতে পারেন অথবা ব্যবহারকারীদের সেই ঝুঁকি মেনে নেওয়ার জন্য আপনি নিজের সলিউশন ডকুমেন্ট করতে পারেন। আরও তথ্যের জন্য, Google Workspace MCP সার্ভারের জন্য নিরাপত্তা কনফিগার করুন দেখুন।

এইসব পেশাদার পদ্ধতি অনুসরণ করুন:

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

সম্পর্কিত বিষয়

• Google Workspace MCP সার্ভারের জন্য নিরাপত্তা কনফিগার করা
• Antigravity-তে Google Workspace MCP সার্ভার (কোডল্যাব)
• Google Workspace MCP সার্ভারের তালিকা