আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

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

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

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

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

পূর্বশর্ত

Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রাম-এর মেম্বারশিপ।
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 কনসোলে API চালু করুন:

API চালু করুন

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

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

ব্র্যান্ডিং বিকল্পে যান
আপনি যদি আগে থেকেই Google Auth Platform কনফিগার করে থাকেন, তাহলে ব্র্যান্ডিং, দর্শক এবং ডেটা অ্যাক্সেস বিকল্পে গিয়ে নিম্নলিখিত OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন সেটিংস কনফিগার করতে পারবেন। আপনি যদি Google Auth Platform এখনও কনফিগার করা হয়নি মেসেজটি দেখতে পান, তাহলে শুরু করুন বিকল্পে ক্লিক করুন:
1. অ্যাপের তথ্য বিকল্পের মধ্যে, অ্যাপের নাম-এ People API MCP Server টাইপ করুন।
2. ব্যবহারকারীর সহায়তা সংক্রান্ত ইমেল বিকল্পে, আপনার ইমেল আইডি বা উপযুক্ত Google গ্রুপ বেছে নিন।
3. পরবর্তী বিকল্পে ক্লিক করুন।
4. দর্শক বিকল্পের অধীনে, ইন্টার্নাল বিকল্প বেছে নিন। আপনি ইন্টার্নাল বিকল্প বেছে নিতে না পারলে, এক্সটার্নাল বিকল্প বেছে নিন।
5. পরবর্তী বিকল্পে ক্লিক করুন।
6. যোগাযোগের তথ্য বিকল্পের মধ্যে, এমন একটি ইমেল আইডি লিখুন যেখানে আপনার প্রোজেক্টে কোনও পরিবর্তন হলে আপনাকে জানানো যাবে।
7. পরবর্তী বিকল্পে ক্লিক করুন।
8. শেষ করুন বিকল্পের অধীনে, Google API পরিষেবা সংক্রান্ত ব্যবহারকারীর ডেটা নীতি পর্যালোচনা করুন এবং আপনি সম্মত হলে, আমি Google API পরিষেবা সংক্রান্ত ব্যবহারকারীর ডেটা নীতিতে সম্মতি জানাচ্ছি বিকল্প বেছে নিন।
9. চালিয়ে যান বিকল্পে ক্লিক করুন।
10. তৈরি করুন বিকল্পে ক্লিক করুন।
11. ব্যবহারকারীর ধরন হিসেবে এক্সটার্নাল বেছে নিলে, টেস্ট ব্যবহারকারী যোগ করুন:
  1. দর্শক বিকল্পে ক্লিক করুন।
  2. টেস্ট ব্যবহারকারী বিকল্পের মধ্যে, ব্যবহারকারী যোগ করুন বিকল্পে ক্লিক করুন।
  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-এর ক্ষেত্রে প্রযোজ্য।

OAuth 2.0 ক্লায়েন্ট আইডি ও সিক্রেট তৈরি করুন:
1. Google Cloud কনসোলে, Google Auth Platform > ক্লায়েন্ট > ক্লায়েন্ট তৈরি করুন বিকল্পে যান
  
  ক্লায়েন্ট তৈরি করুন বিকল্পে যান
2. অ্যাপ্লিকেশনের ধরন হিসেবে ওয়েব অ্যাপ্লিকেশন বেছে নিন।
3. নাম লিখুন।
4. অনুমোদিত রিডাইরেক্ট URI বিভাগে, + URI যোগ করুন বিকল্পে ক্লিক করুন, এবং তারপর URI ফিল্ডে https://antigravity.google/oauth-callback যোগ করুন।
5. AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন।
6. তৈরি করুন বিকল্পে ক্লিক করুন এবং আপনার ক্লায়েন্ট আইডি ও ক্লায়েন্ট সিক্রেট কপি করুন।
কনফিগারেশন ফাইল ~/.gemini/config/mcp_config.json খুলুন বা তৈরি করুন।
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: আপনার তৈরি করা ক্লায়েন্ট সিক্রেট।
mcp_config.json সেভ করুন।
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 টিপুন।
সার্ভার সঠিকভাবে কনফিগার করা হয়েছে এবং চলছে কিনা তা যাচাই করুন:
- Antigravity IDE বা GUI-এর জন্য: কাস্টমাইজেশন > ইনস্টল করা MCP সার্ভার বিকল্পের অধীনে সার্ভারের পাশে সাইন-আউট করুন বোতাম দেখানো হয়।
- Antigravity CLI-এর জন্য: আপনার কনফিগার করা MCP সার্ভার দেখতে /mcp প্যানেল খুলুন। যাচাই ও প্রমাণীকরণ করা সার্ভার ইন্ট্যার‍্যাক্টিভ TUI প্যানেলে নামের পাশে অনুমোদিত হিসেবে দেখানো হয়। ড্যাশবোর্ড ভিউ থেকে যেকোনও সার্ভার বেছে নিয়ে আপনি সেটির স্ট্যাটাস চেক করতে এবং উপলভ্য সব টুল দেখতে পারবেন।

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

Claude

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

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

OAuth 2.0 ক্লায়েন্ট আইডি ও সিক্রেট তৈরি করুন:
1. Google Cloud কনসোলে, Google Auth Platform > ক্লায়েন্ট > ক্লায়েন্ট তৈরি করুন বিকল্পে যান
  
  'ক্লায়েন্ট তৈরি করুন' বিকল্পে যান
2. অ্যাপ্লিকেশনের ধরন হিসেবে ওয়েব অ্যাপ্লিকেশন বেছে নিন।
3. নাম লিখুন।
4. অনুমোদিত রিডাইরেক্ট URI বিভাগে, + URI যোগ করুন বিকল্পে ক্লিক করুন, এবং তারপর URI ফিল্ডে https://claude.ai/api/mcp/auth_callback যোগ করুন।
5. AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন।
6. তৈরি করুন বিকল্পে ক্লিক করে আপনার ক্লায়েন্ট আইডি ও ক্লায়েন্ট সিক্রেট কপি করুন।
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 ব্যবহার করে। আপনার OAuth 2.0 ক্লায়েন্ট তৈরি করার সময়, AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন। বিস্তারিত জানতে, যাচাইকরণ ও অনুমোদন সম্পর্কে জানুন।

বিভিন্ন ধরনের ক্লায়েন্ট কানেক্ট করা সম্পর্কে আরও বিবরণের জন্য, 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-এর প্রদান করা Model Armor ব্যবহার করতে পারেন অথবা আপনার নিজস্ব সমাধান ব্যবহার করতে পারেন, যদি আপনি এটি ডকুমেন্ট করেন যাতে ব্যবহারকারীরা সেই ঝুঁকি গ্রহণ করতে পারেন। আরও তথ্যের জন্য, Google Workspace MCP সার্ভারের জন্য নিরাপত্তা কনফিগার করুন দেখুন।

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

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