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

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

People API একটি রিমোট মডেল কনটেক্সট প্রোটোকল (MCP) সার্ভার প্রদান করে, যা এআই এজেন্টদেরকে Google Workspace প্রোফাইল এবং কন্ট্যাক্ট ডেটার সাথে নিরাপদে ইন্টারঅ্যাক্ট করার সুযোগ দেয়। People API MCP সার্ভারটি কনফিগার করার মাধ্যমে, আপনি Gemini CLI, Claude, বা IDE-এর মতো এআই অ্যাপ্লিকেশনগুলোকে People API ব্যবহার করে বিভিন্ন অ্যাকশন সম্পাদন করতে সক্ষম করেন।

পিপল এপিআই এমসিপি সার্ভার এআই এজেন্টদের জন্য একটি প্রমিত পদ্ধতি প্রদান করে:

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

পূর্বশর্ত

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

• একটি MCP ক্লায়েন্ট, যেমন Gemini CLI ।

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

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

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

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

API এবং MCP পরিষেবা সক্রিয় করুন

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

• পিপল এপিআই

সিএলআই

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

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

কনসোল

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

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

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

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

1. Google Cloud কনসোলে, Google Auth Platform > Branding- এ যান।

   ব্র্যান্ডিং-এ যান

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

   1. অ্যাপ ইনফরমেশন-এর অধীনে, অ্যাপ নেম-এর জায়গায় People API MCP Server টাইপ করুন।
   2. ব্যবহারকারী সহায়তা ইমেল- এ, আপনার ইমেল ঠিকানা অথবা একটি উপযুক্ত গুগল গ্রুপ নির্বাচন করুন।
   3. পরবর্তী ধাপে যান।
   4. Audience-এর অধীনে, Internal নির্বাচন করুন। যদি আপনি Internal নির্বাচন করতে না পারেন, তাহলে External নির্বাচন করুন।
   5. পরবর্তী ধাপে যান।
   6. যোগাযোগের তথ্যের অধীনে, একটি ইমেল ঠিকানা লিখুন যেখানে আপনার প্রকল্পের যেকোনো পরিবর্তন সম্পর্কে আপনাকে জানানো যাবে।
   7. পরবর্তী ধাপে যান।
   8. Finish-এর অধীনে, Google API Services ব্যবহারকারীর ডেটা নীতি পর্যালোচনা করুন এবং যদি আপনি সম্মত হন, তাহলে I agree to the Google API Services: User Data Policy নির্বাচন করুন।
   9. চালিয়ে যান-এ ক্লিক করুন।
   10. তৈরি করুন- এ ক্লিক করুন।
   11. যদি আপনি ব্যবহারকারীর ধরন হিসেবে 'এক্সটার্নাল' নির্বাচন করে থাকেন, তাহলে পরীক্ষামূলক ব্যবহারকারী যোগ করুন:
       1. দর্শকবৃন্দে ক্লিক করুন।
       2. টেস্ট ইউজার্স-এর অধীনে, অ্যাড ইউজার্স-এ ক্লিক করুন।
       3. আপনার ইমেল ঠিকানা এবং অন্য কোনো অনুমোদিত পরীক্ষামূলক ব্যবহারকারীর তথ্য প্রবেশ করান, তারপর সেভ-এ ক্লিক করুন।

3. ডেটা অ্যাক্সেস > স্কোপ যোগ বা অপসারণ-এ ক্লিক করুন। একটি প্যানেল প্রদর্শিত হবে, যেখানে আপনার গুগল ক্লাউড প্রজেক্টে সক্রিয় করা প্রতিটি এপিআই-এর স্কোপের একটি তালিকা থাকবে।

   1. ‘Manually add scopes’- এর অধীনে, 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 ক্লায়েন্টে People API রিমোট MCP সার্ভার যোগ করতে, আপনার ক্লায়েন্টের জন্য দেওয়া নির্দেশাবলী অনুসরণ করুন।

জেমিনি সিএলআই

আপনার Gemini CLI-তে People API রিমোট MCP সার্ভার যোগ করতে, আপনার settings.json ফাইলে সার্ভার কনফিগারেশনটি যোগ করুন।

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

   1. Google Cloud কনসোলে, Google Auth Platform > Clients > Create Client- এ যান।

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

   2. অ্যাপ্লিকেশনের ধরন হিসেবে ডেস্কটপ অ্যাপ নির্বাচন করুন।

   3. একটি নাম লিখুন।

   4. Create-এ ক্লিক করুন এবং আপনার Client ID ও Client Secret কপি করুন।

2. ~/.gemini/settings.json কনফিগারেশন ফাইলটি খুলুন অথবা তৈরি করুন।

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

   {
     "mcpServers": {
       "people": {
         "httpUrl": "https://people.googleapis.com/mcp/v1",
         "oauth": {
           "enabled": true,
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET",
           "scopes": [
             "https://www.googleapis.com/auth/directory.readonly",
             "https://www.googleapis.com/auth/userinfo.profile",
             "https://www.googleapis.com/auth/contacts.readonly"
           ]
         }
       }
     }
   }
   

   নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

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

4. settings.json সংরক্ষণ করুন।

5. জেমিনি সিএলআই শুরু করুন:

   gemini
   

6. Gemini CLI-তে, নিম্নলিখিত কমান্ডটি চালিয়ে MCP সার্ভারের সাথে প্রমাণীকরণ করুন:

   /mcp auth people
   

   1. নির্দেশিত হলে, আপনার ব্রাউজারে একটি প্রমাণীকরণ পৃষ্ঠা খুলতে 1 চাপুন। আপনি যদি SSH-এর মাধ্যমে কাজ করেন, তাহলে CLI-তে দেওয়া নির্দেশাবলী অনুসরণ করুন।
   2. আপনার গুগল অ্যাকাউন্টে সাইন ইন করুন।
   3. অনুরোধকৃত OAuth স্কোপগুলো পর্যালোচনা করুন এবং Allow-এ ক্লিক করুন।
   4. প্রমাণীকরণ সফল হয়েছে তা নিশ্চিত করে একটি বার্তা প্রদর্শিত হয়।

7. Gemini CLI-তে, আপনার কনফিগার করা MCP সার্ভার এবং সেগুলোর টুলগুলো দেখতে /mcp list চালান।

   প্রতিক্রিয়াটি নিম্নলিখিতের অনুরূপ:

   🟢 people - Ready (3 tools)
     Tools:
     - get_user_profile
     - search_contacts
     - search_directory_people
   

রিমোট এমসিপি সার্ভারটি জেমিনি সিএলআই-তে ব্যবহারের জন্য প্রস্তুত।

ক্লদ

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 > Clients > Create Client- এ যান।

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

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

   3. একটি নাম লিখুন।

   4. Authorized redirect URIs সেকশনে, + Add URI-তে ক্লিক করুন এবং তারপরে URIs ফিল্ডে https://claude.ai/api/mcp/auth_callback যোগ করুন।

   5. Create-এ ক্লিক করুন এবং আপনার Client ID ও Client Secret কপি করুন।

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

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

অন্যান্য

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

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

• সার্ভার ইউআরএল : https://people.googleapis.com/mcp/v1

• পরিবহন : HTTP

• প্রমাণীকরণ : পিপল এপিআই রিমোট এমসিপি সার্ভার OAuth 2.0 ব্যবহার করে। বিস্তারিত জানতে, প্রমাণীকরণ এবং অনুমোদন সম্পর্কে জানুন দেখুন।

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

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

এমসিপি ক্লায়েন্ট কনফিগার করার পর, আপনি কয়েকটি টেস্ট প্রম্পট চালিয়ে সংযোগটি যাচাই করতে পারেন।

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

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

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

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

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

এমসিপি সার্ভারে সংযোগ করতে সমস্যা হলে, আপনি OAuth লগগুলিতে ত্রুটি পরীক্ষা করতে পারেন। আপনার অ্যাডমিনিস্ট্রেটরকে নিরাপত্তা তদন্ত টুলে OAuth লগ ইভেন্টগুলি পরীক্ষা করতে বলুন।

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

People API MCP সার্ভারের জন্য নিম্নলিখিত টুলগুলো উপলব্ধ রয়েছে:

• get_user_profile
• search_contacts
• search_directory_people

গুরুত্বপূর্ণ নিরাপত্তা বিবেচনা: পরোক্ষ প্রম্পট ইনজেকশন

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

এই ঝুঁকিগুলো প্রশমিত করতে নিম্নলিখিত সর্বোত্তম পদ্ধতিগুলো অনুসরণ করুন:

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

সম্পর্কিত বিভাগ

• জিমেইল এমসিপি সার্ভার কনফিগার করুন
• ক্যালেন্ডার এমসিপি সার্ভার কনফিগার করুন
• ড্রাইভ এমসিপি সার্ভার কনফিগার করুন