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

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

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

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

পূর্বশর্ত

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

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

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

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

  • পিপল এপিআই

সিএলআই 

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

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

কনসোল

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

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

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 সার্ভার যোগ করতে, আপনার ক্লায়েন্টের জন্য দেওয়া নির্দেশাবলী অনুসরণ করুন।

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

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

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

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

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

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

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

    4. Authorized redirect URIs সেকশনে, + Add URI-তে ক্লিক করুন এবং তারপরে URIs ফিল্ডে https://antigravity.google/oauth-callback যোগ করুন।

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

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

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

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

        agy

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

        /mcp

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

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

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

রিমোট এমসিপি সার্ভারটি অ্যান্টিগ্র্যাভিটিতে ব্যবহারের জন্য প্রস্তুত।

ক্লদ

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.get_user_profile ব্যবহার করে।

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

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

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

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

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

  • get_user_profile
  • search_contacts
  • search_directory_people

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

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

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

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