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

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

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

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

পূর্বশর্ত

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

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

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

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

  • জিমেইল এপিআই

সিএলআই 

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

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

কনসোল

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

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

এমসিপি পরিষেবাগুলি সক্রিয় করুন

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

  • জিমেইল এমসিপি এপিআই

সিএলআই 

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

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

কনসোল

গুগল ক্লাউড কনসোলে এমসিপি পরিষেবাগুলি সক্রিয় করুন:

এমসিপি পরিষেবাগুলি সক্রিয় করুন

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

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

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

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

    1. অ্যাপ ইনফরমেশন-এর অধীনে অ্যাপ নেম-এর জায়গায় Gmail 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’- এর অধীনে, Gmail MCP সার্ভারের জন্য স্কোপগুলো পেস্ট করুন:

      • https://www.googleapis.com/auth/gmail.readonly
      • https://www.googleapis.com/auth/gmail.compose

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

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

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

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

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

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

Antigravity-তে Gmail রিমোট 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": {
    "gmail": {
      "serverUrl": "https://gmailmcp.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. তালিকা থেকে gmail খুঁজুন, ‘Authenticate’-এ ক্লিক করুন, আপনার গুগল অ্যাকাউন্টে সাইন ইন করুন, অনুমোদন কোডটি কপি করে ইনপুট ডায়ালগে পেস্ট করুন এবং ‘Submit’-এ ক্লিক করুন।

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

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

        agy

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

        /mcp

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

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

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

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

ক্লদ

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

Claude-এ Gmail রিমোট 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. জিমেইল প্রোডাক্টের সংযোগের বিবরণ লিখুন:
      • সার্ভারের নাম : Gmail ।
      • রিমোট এমসিপি সার্ভার ইউআরএল : https://gmailmcp.googleapis.com/mcp/v1
    4. অ্যাডভান্সড সেটিংসে , আপনার OAuth ক্লায়েন্ট আইডি এবং OAuth ক্লায়েন্ট সিক্রেট লিখুন।
    5. যোগ করুন-এ ক্লিক করুন।

অন্যান্য

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

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

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

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

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

  • আমাদের মার্কেটিং পরিকল্পনা সম্পর্কে এরিয়েল তার শেষ ইমেইলে কী বলেছিল?

    ক্লায়েন্ট gmail.search_threads ব্যবহার করে এরিয়েলের ইমেলগুলো ফিল্টার করে, gmail.get_thread দিয়ে সর্বশেষ থ্রেডের বিষয়বস্তু সংগ্রহ করে এবং তারপর আপনার জন্য সেটির সারসংক্ষেপ তৈরি করে।

  • ariel@example.com-কে একটি ইমেল পাঠান, যেখানে বলা থাকবে যে আমি মার্কেটিং প্ল্যানটি অনুমোদন করছি।

    ক্লায়েন্ট আপনার ড্রাফটস ফোল্ডারে একটি ইমেল তৈরি করতে gmail.create_draft ব্যবহার করে, যা আপনাকে জিমেইল থেকে সেটি পর্যালোচনা ও পাঠানোর সুযোগ দেয়।

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

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

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

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

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

  • create_draft
  • get_thread
  • label_message
  • label_thread
  • list_drafts
  • list_labels
  • search_threads
  • unlabel_message
  • unlabel_thread

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

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

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

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