শীটস এমসিপি সার্ভার কনফিগার করুন

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

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

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

পূর্বশর্ত

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

  • একটি এমসিপি ক্লায়েন্ট, যেমন গুগল অ্যান্টিগ্র্যাভিটি ।

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

    ক্লাউড শেল

    আগে থেকে সেট আপ করা gcloud CLI সহ একটি অনলাইন টার্মিনাল ব্যবহার করতে, ক্লাউড শেল সক্রিয় করুন:

    ক্লাউড শেল সক্রিয় করুন

    স্থানীয় শেল

    স্থানীয় উন্নয়ন পরিবেশ ব্যবহার করতে, এই ধাপগুলো অনুসরণ করুন:

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

গুগল শীটস এমসিপি সার্ভার কনফিগার করুন

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

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

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

  • গুগল শীটস এপিআই

সিএলআই 

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

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

কনসোল

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

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

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

Google Sheets-এর জন্য MCP কম্পোনেন্টগুলো সক্রিয় করতে, আপনাকে আপনার Google Cloud প্রজেক্টে নিম্নলিখিত সার্ভিসটি সক্রিয় করতে হবে:

  • গুগল শীটস এমসিপি এপিআই

সিএলআই 

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

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

কনসোল

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

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

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

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

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

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

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

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/spreadsheets.readonly

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

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

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

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

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

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

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

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

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

        agy

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

        /mcp

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

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

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

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

ক্লদ

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

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

অন্যান্য

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

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

গুগল শীটস এমসিপি সার্ভার পরীক্ষা করুন

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

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

  • গুগল শিট abcd123 থেকে Sheet1 শিটটি পড়ুন।

    ক্লায়েন্ট sheets.get_values ​​ব্যবহার করে গ্রিডের মানগুলো সংগ্রহ করে।

  • Google Sheet abcd123 এর ২ নং কলাম সূচকে একটি কলাম যুক্ত করুন।

    ক্লায়েন্ট কলাম পরিবর্তন করার জন্য sheets.insert_dimension ব্যবহার করে।

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

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

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

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

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

  • get_values
  • get_spreadsheet
  • update_spreadsheet
  • update_values
  • update_formulas
  • insert_dimension

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

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

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

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