Docs একটি রিমোট মডেল কন্টেক্সট প্রোটোকল (MCP) সার্ভার অফার করে যা AI এজেন্টদের Docs ডেটার সাথে নিরাপদে ইন্টার্যাক্ট করার অনুমতি দেয়। Docs MCP সার্ভার কনফিগার করার মাধ্যমে, আপনি Google Antigravity এবং Claude-এর মতো AI অ্যাপ্লিকেশনগুলিকে Docs-এ অ্যাকশন পারফর্ম করার অনুমতি দেন।
Docs MCP সার্ভার AI এজেন্টদের জন্য একটি স্ট্যান্ডার্ডাইজড উপায় প্রদান করে যার মাধ্যমে:
- ডেটা পড়া: ডকুমেন্টের স্ট্রাকচারাল তথ্য ও টেক্সট কন্টেন্ট পড়া।
- অ্যাকশন নিন: ব্যাচ আপডেট ব্যবহার করে ডকুমেন্টের স্টাইলিং ও স্ট্রাকচার আপডেট করুন।
- নিরাপত্তা সংক্রান্ত নিয়ম মেনে চলা: ব্যবহারকারীর মতো একই অনুমতি ও ডেটা গভর্নেন্স কন্ট্রোল ব্যবহার করা।
পূর্বশর্ত
Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রাম-এর মেম্বারশিপ।
একটি Google Cloud প্রোজেক্ট। প্রোজেক্ট তৈরি করতে, প্রোজেক্ট তৈরি করুন দেখুন।
একটি MCP হোস্ট, যা একটি AI অ্যাপ্লিকেশন যেমন Google Antigravity বা Claude। AI অ্যাপ্লিকেশন প্রতিটি MCP সার্ভারের জন্য একটি MCP ক্লায়েন্ট কানেকশন তৈরি করে।
এই পৃষ্ঠায় কমান্ড রান করতে, নিম্নলিখিত ডেভেলপমেন্ট এনভায়রনমেন্টের মধ্যে কোনও একটিতে gcloud CLI সেট-আপ করুন:
Cloud Shell
gcloud CLI আগে থেকেই সেট-আপ করা আছে এমন অনলাইন টার্মিনাল ব্যবহার করতে, Cloud Shell অ্যাক্টিভেট করুন:
লোকাল শেল
লোকাল ডেভেলপমেন্ট এনভায়রনমেন্ট ব্যবহার করতে, এই ধাপগুলি অনুসরণ করুন:
- Google Cloud CLI ইনস্টল করুন।
আপনি আগে gcloud CLI ইনস্টল করে থাকলে,
gcloud components updateরান করে লেটেস্ট ভার্সন আছে কিনা তা নিশ্চিত করুন। - আপনি যদি কোনও এক্সটার্নাল পরিচয় প্রদানকারী (IdP) ব্যবহার করেন, তাহলে আপনার ফেডারেটেড পরিচয় দিয়ে gcloud CLI-তে সাইন-ইন করুন। আরও তথ্যের জন্য, আপনার ফেডারেটেড আইডেন্টিটি ব্যবহার করে gcloud CLI-তে সাইন-ইন করুন দেখুন।
- gcloud CLI শুরু করুন।
- Google Cloud CLI ইনস্টল করুন।
আপনি আগে gcloud CLI ইনস্টল করে থাকলে,
Docs MCP সার্ভার কনফিগার করুন
Docs MCP সার্ভার ব্যবহার করতে, আপনার Google Cloud প্রোজেক্টে এটি চালু করুন এবং এটির সাথে কানেক্ট করার জন্য আপনার AI অ্যাপ্লিকেশন কনফিগার করুন।
API চালু করুন
Docs MCP সার্ভার ব্যবহার করতে, আপনার Google Cloud প্রোজেক্টে নিম্নলিখিত API চালু করুন:
Google Docs API
CLI
gcloud services enable docs.googleapis.com --project=PROJECT_ID
আপনার Google Cloud প্রোজেক্ট আইডি দিয়ে PROJECT_ID
প্রতিস্থাপন করুন।
কনসোল
Google Cloud কনসোলে API চালু করুন:
MCP পরিষেবা চালু করুন
Docs-এর জন্য MCP কম্পোনেন্ট চালু করতে, আপনার Google Cloud প্রোজেক্টে নিম্নলিখিত পরিষেবা চালু করুন:
Docs MCP API
CLI
gcloud services enable docsmcp.googleapis.com --project=PROJECT_ID
আপনার Google Cloud প্রোজেক্ট আইডি দিয়ে PROJECT_ID
প্রতিস্থাপন করুন।
কনসোল
Google Cloud কনসোলে MCP পরিষেবা চালু করুন:
OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন সেট-আপ করা
Docs MCP সার্ভার যাচাইকরণ ও অনুমোদনের জন্য OAuth 2.0 ব্যবহার করে। OAuth ক্লায়েন্ট আইডি তৈরি করার আগে আপনাকে অবশ্যই OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন কনফিগার করতে হবে।
Google Cloud কনসোলে, Google Auth Platform > ব্র্যান্ডিং বিকল্পে যান।
আপনি যদি আগে থেকেই Google Auth প্ল্যাটফর্ম কনফিগার করে থাকেন, তাহলে ব্র্যান্ডিং, দর্শক, এবং ডেটা অ্যাক্সেস-এ নিম্নলিখিত OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন সেটিংস কনফিগার করতে পারবেন। আপনি যদি Google Auth Platform এখনও কনফিগার করা হয়নি মেসেজটি দেখতে পান, তাহলে শুরু করুন বিকল্পে ক্লিক করুন:
- অ্যাপের তথ্য বিকল্পের মধ্যে, অ্যাপের নাম-এ
Docs MCP Serverটাইপ করুন। - ব্যবহারকারী সহায়তা ইমেল-এ, আপনার ইমেল আইডি বা উপযুক্ত Google Group বেছে নিন।
- পরবর্তী বিকল্পে ক্লিক করুন।
- দর্শক বিকল্পের অধীনে, ইন্টার্নাল বিকল্প বেছে নিন। আপনি যদি ইন্টার্নাল বেছে নিতে না পারেন, তাহলে এক্সটার্নাল বেছে নিন।
- পরবর্তী বিকল্পে ক্লিক করুন।
- যোগাযোগের তথ্য বিকল্পের মধ্যে, এমন একটি ইমেল আইডি লিখুন যেখানে আপনার প্রোজেক্টে কোনও পরিবর্তন হলে আপনাকে বিজ্ঞপ্তি পাঠানো যেতে পারে।
- পরবর্তী বিকল্পে ক্লিক করুন।
- শেষ করুন বিকল্পের অধীনে, Google API পরিষেবা সংক্রান্ত ব্যবহারকারীর ডেটা নীতি পর্যালোচনা করুন এবং আপনি সম্মত হলে, আমি Google API পরিষেবা: ব্যবহারকারীর ডেটা নীতিতে সম্মতি জানাচ্ছি বিকল্প বেছে নিন।
- চালিয়ে যান বিকল্পে ক্লিক করুন।
- তৈরি করুন বিকল্পে ক্লিক করুন।
- ব্যবহারকারীর ধরন হিসেবে এক্সটার্নাল বেছে নিলে, টেস্ট ব্যবহারকারী যোগ করুন:
- দর্শক বিকল্পে ক্লিক করুন।
- টেস্ট ব্যবহারকারী বিকল্পের অধীনে, ব্যবহারকারী যোগ করুন বিকল্পে ক্লিক করুন।
- আপনার ইমেল আইডি এবং অন্য কোনও অনুমোদিত টেস্ট ব্যবহারকারীর ইমেল আইডি লিখুন, তারপর সেভ করুন বিকল্পে ক্লিক করুন।
- অ্যাপের তথ্য বিকল্পের মধ্যে, অ্যাপের নাম-এ
ডেটা অ্যাক্সেস > স্কোপ যোগ করুন বা সরান বিকল্পে ক্লিক করুন। আপনার Google Cloud প্রোজেক্টে চালু করা প্রতিটি API-এর জন্য স্কোপের তালিকা সহ একটি প্যানেল দেখানো হয়।
ম্যানুয়ালি স্কোপ যোগ করুন বিকল্পের অধীনে, Docs MCP সার্ভারের জন্য স্কোপ পেস্ট করুন:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/documents.readonlyhttps://www.googleapis.com/auth/documents
টেবিলে যোগ করুন বিকল্পে ক্লিক করুন।
আপডেট করুন বিকল্পে ক্লিক করুন।
আপনার অ্যাপের জন্য প্রয়োজনীয় স্কোপ বেছে নেওয়ার পরে, ডেটা অ্যাক্সেস পৃষ্ঠায়, সেভ করুন বিকল্পে ক্লিক করুন।
আপনার AI অ্যাপ্লিকেশন কনফিগার করুন
আপনার AI অ্যাপ্লিকেশনে Docs রিমোট MCP সার্ভার যোগ করতে, আপনার অ্যাপ্লিকেশনের জন্য নির্দেশাবলী অনুসরণ করুন।
Docs MCP সার্ভারকে কল করে এমন ব্যবহারকারী-প্রতিনিধি OAuth 2.0 ক্লায়েন্ট আইডিতে অবশ্যই Google Auth প্ল্যাটফর্ম > ক্লায়েন্ট-এ AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিতে হবে। আগে থেকে থাকা OAuth 2.0 ক্লায়েন্ট আইডি আপডেট করতে, Google Auth প্ল্যাটফর্ম > ক্লায়েন্ট-এ গিয়ে এই সেটিং বেছে নিন, যেমন OAuth ক্লায়েন্ট ম্যানেজ করুন-এ বর্ণনা করা হয়েছে। আপনি যদি আগে থেকে থাকা ক্লায়েন্টে এই সেটিং পরিবর্তন করতে না পারেন, অথবা ক্লায়েন্ট যদি এজেন্ট-বিহীন ফিচারও সাপোর্ট করে, তাহলে আপনার AI এজেন্টের জন্য একটি নতুন OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করুন। বাতিল করা অনুরোধ, ডোমেন-ওয়াইড ডেলিগেশন সহ পরিষেবা অ্যাকাউন্ট বা Google Apps Script-এর জন্য, সমস্যার সমাধানকরণ দেখুন।
Antigravity
Antigravity-তে Docs রিমোট MCP সার্ভার যোগ করতে,
আপনার mcp_config.json ফাইলে সার্ভার কনফিগারেশন যোগ করুন। এই
নির্দেশাবলী Antigravity 2.0, Antigravity IDE ও Antigravity CLI-এর ক্ষেত্রে প্রযোজ্য।
OAuth 2.0 ক্লায়েন্ট আইডি ও সিক্রেট তৈরি করুন:
Google Cloud কনসোলে, Google Auth প্ল্যাটফর্ম > ক্লায়েন্ট > ক্লায়েন্ট তৈরি করুন বিকল্পে যান।
অ্যাপ্লিকেশনের ধরন হিসেবে ওয়েব অ্যাপ্লিকেশন বেছে নিন।
নাম লিখুন।
অনুমোদিত রিডাইরেক্ট URI বিভাগে, + URI যোগ করুন বিকল্পে ক্লিক করুন, এবং তারপর URI ফিল্ডে
https://antigravity.google/oauth-callbackযোগ করুন।AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন।
তৈরি করুন বিকল্পে ক্লিক করে আপনার ক্লায়েন্ট আইডি ও ক্লায়েন্ট সিক্রেট কপি করুন।
কনফিগারেশন ফাইল
~/.gemini/config/mcp_config.jsonখুলুন বা তৈরি করুন।mcp_config.json-এmcpServersকনফিগারেশন যোগ করুন:{ "mcpServers": { "docs": { "serverUrl": "https://docsmcp.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)-এর জন্য:
- আপনার সেটিংস স্ক্রিন খুলুন (যেমন, নিচে বাঁদিকে সেটিংস বিকল্পে ক্লিক করুন অথবা Antigravity ব্যবহারকারীর সেটিংস খুলুন)।
- কাস্টমাইজেশন বিকল্পে যান।
- ইনস্টল করা MCP সার্ভার বিকল্পের অধীনে, রিফ্রেশ করুন বিকল্পে ক্লিক করুন।
- তালিকায়
docsখুঁজে নিন, যাচাই করুন বিকল্পে ক্লিক করুন, আপনার Google অ্যাকাউন্টে সাইন-ইন করুন, অনুমোদনের কোড কপি করুন, ইনপুট ডায়ালগে এটি পেস্ট করুন এবং জমা দিন বিকল্পে ক্লিক করুন।
Antigravity CLI-এর জন্য:
Antigravity CLI চালু করুন:
agyএটি রান করে ইন্টার্যাক্টিভ MCP ম্যানেজমেন্ট প্যানেল খুলুন:
/mcpতীরচিহ্ন ব্যবহার করে
docsবেছে নিন, যাচাইকরণ অ্যাকশনে যান এবং Enter প্রেস করুন। আপনার ব্রাউজারে সাইন-ইন ফ্লো সম্পূর্ণ করুন, অনুমোদন কোড কপি করুন, টার্মিনাল প্রম্পটে এটি পেস্ট করুন এবং Enter প্রেস করুন।
সার্ভার সঠিকভাবে কনফিগার করা হয়েছে এবং চলছে কিনা তা যাচাই করুন:
- Antigravity IDE বা GUI-এর জন্য: কাস্টমাইজেশন > ইনস্টল করা MCP সার্ভার বিকল্পের অধীনে সার্ভারের পাশে সাইন-আউট করুন বোতাম দেখানো হয়।
- Antigravity CLI-এর জন্য: আপনার কনফিগার করা MCP সার্ভার দেখতে
/mcpপ্যানেল খুলুন। যাচাই ও অথেন্টিকেট করা সার্ভার ইন্টার্যাক্টিভ TUI প্যানেলের মধ্যে তাদের নামের পাশে Authed দেখায়। আপনি ড্যাশবোর্ড ভিউ থেকে যেকোনও সার্ভার বেছে নিয়ে সেটির স্ট্যাটাস পরীক্ষা করতে এবং উপলভ্য সব টুলের তালিকা দেখতে পারবেন।
Antigravity-তে রিমোট MCP সার্ভার ব্যবহার করার জন্য রেডি।
Claude
Claude.ai বা Claude Desktop-এর সাথে Docs রিমোট MCP সার্ভার ব্যবহার করতে, আপনার Claude Enterprise, Pro, Max বা Team প্ল্যান থাকতে হবে।
Claude-এ Docs রিমোট MCP সার্ভার যোগ করতে, OAuth ক্লায়েন্ট আইডি ও সিক্রেট সহ কাস্টম কানেক্টর কনফিগার করুন।
OAuth 2.0 ক্লায়েন্ট আইডি ও সিক্রেট তৈরি করুন:
Google Cloud কনসোলে, Google Auth প্ল্যাটফর্ম > ক্লায়েন্ট > ক্লায়েন্ট তৈরি করুন বিকল্পে যান।
অ্যাপ্লিকেশনের ধরন হিসেবে ওয়েব অ্যাপ্লিকেশন বেছে নিন।
নাম লিখুন।
অনুমোদিত রিডাইরেক্ট URI বিভাগে, + URI যোগ করুন বিকল্পে ক্লিক করুন, এবং তারপর URI ফিল্ডে
https://claude.ai/api/mcp/auth_callbackযোগ করুন।AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন।
তৈরি করুন বিকল্পে ক্লিক করে আপনার ক্লায়েন্ট আইডি ও ক্লায়েন্ট সিক্রেট কপি করুন।
Claude-এ MCP সার্ভার কনফিগার করুন:
- Claude.ai বা Claude Desktop-এ, সেটিংস > কানেক্টর অথবা অ্যাডমিন সেটিংস > কানেক্টর বিকল্পে যান।
- কাস্টম কানেক্টর যোগ করুন বিকল্পে ক্লিক করুন।
- Docs প্রোডাক্টের জন্য কানেকশন সংক্রান্ত বিবরণ লিখুন:
- সার্ভারের নাম:
Docs. - রিমোট MCP সার্ভার URL:
https://docsmcp.googleapis.com/mcp/v1
- সার্ভারের নাম:
- উন্নত সেটিংস-এ আপনার OAuth ক্লায়েন্ট আইডি এবং OAuth ক্লায়েন্ট সিক্রেট লিখুন।
- যোগ করুন বিকল্পে ক্লিক করুন।
অন্যান্য
অনেক AI অ্যাপ্লিকেশনে রিমোট MCP সার্ভারের সাথে কানেক্ট করার উপায় আছে। সাধারণত আপনাকে সার্ভারের নাম, এন্ডপয়েন্ট, ট্রান্সপোর্ট প্রোটোকল ও যাচাইকরণ পদ্ধতির মতো সার্ভার সম্পর্কিত তথ্য লিখতে হয়। Docs রিমোট MCP সার্ভারের জন্য, নিম্নলিখিত তথ্য লিখুন:
সার্ভারের নাম:
docsসার্ভার URL:
https://docsmcp.googleapis.com/mcp/v1ট্রান্সপোর্ট: স্ট্রিমেবল HTTP
যাচাইকরণ: Docs রিমোট MCP সার্ভার OAuth 2.0 ব্যবহার করে। আপনার OAuth 2.0 ক্লায়েন্ট তৈরি করার সময়, AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন। বিস্তারিত জানতে, যাচাইকরণ ও অনুমোদন সম্পর্কে জানুন।
ওয়েব অ্যাপ্লিকেশন OAuth ক্লায়েন্টের সাথে প্রতি ঘণ্টায় সাইন-ইন প্রম্পট এড়াতে,
access_type=offlineবাoffline_accessস্কোপ ব্যবহার করে অফলাইন অ্যাক্সেসের অনুরোধ করার জন্য আপনার MCP ক্লায়েন্ট কনফিগার করুন। বিস্তারিত জানতে, প্রতি ঘণ্টায় বারবার সাইন-ইন করার প্রম্পট দেখুন।
বিভিন্ন ধরনের AI অ্যাপ্লিকেশন কানেক্ট করার ব্যাপারে আরও জানতে, AI অ্যাপ্লিকেশনে MCP কনফিগার করুন দেখুন।
Docs MCP সার্ভার টেস্ট করুন
আপনার AI অ্যাপ্লিকেশন কনফিগার করার পরে, আপনি কিছু টেস্ট প্রম্পট রান করে কানেকশন যাচাই করতে পারবেন।
আপনার AI অ্যাপ্লিকেশনকে নিম্নলিখিত প্রশ্নগুলি জিজ্ঞাসা করে দেখুন:
"আমাকে Google Doc
abcd123-এর স্ট্রাকচারাল কন্টেন্ট দেখাও।"ক্লায়েন্ট
docs.read_docব্যবহার করে ডকুমেন্টের স্ট্রাকচার ও কন্টেন্ট ফেচ করে।"Google Doc
abcd123-এ 'আমার মার্কেটিং প্ল্যান' শীর্ষকটি যোগ করো।"স্ট্রাকচারাল এলিমেন্ট আপডেট করতে এবং টেক্সট যোগ করতে ক্লায়েন্ট
docs.update_docপারফর্ম করে।
টুলগুলি সঠিকভাবে কাজ করলে এবং আপনি প্রাসঙ্গিক উত্তর পেলে, আপনার Docs MCP সার্ভার সঠিকভাবে কনফিগার করা হয়েছে।
সমস্যার সমাধান
Docs MCP সার্ভারের সাথে সাধারণ যাচাইকরণ ও কানেকশন সংক্রান্ত সমস্যা সমাধান করতে নিম্নলিখিত বিভাগ ব্যবহার করুন।
OAuth লগ ইভেন্ট চেক করুন
MCP সার্ভারে কানেক্ট করার সময় কোনও সমস্যা হলে, OAuth লগে কোনও সমস্যা আছে কিনা তা চেক করুন। আপনার Google Workspace অ্যাডমিনিস্ট্রেটরকে নিরাপত্তা তদন্ত টুল-এ OAuth লগ ইভেন্ট পর্যালোচনা করতে বলুন।
ব্যবহারকারীর-প্রতিনিধি OAuth ক্লায়েন্ট থেকে প্রত্যাখ্যান করা অনুরোধ
MCP সার্ভারে আপনার অনুরোধ বাতিল করা হলে, আপনার ৩-লেগড OAuth ফ্লোর জন্য ব্যবহারকারী-প্রতিনিধিত্ব করা OAuth 2.0 ক্লায়েন্ট আইডিতে Google Auth প্ল্যাটফর্ম > ক্লায়েন্ট-এ AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নেওয়া হয়েছে কিনা তা যাচাই করুন:
- আগে থেকে থাকা ক্লায়েন্ট সেটিং সাপোর্ট করে: আপনার আগে থেকে থাকা OAuth ক্লায়েন্টে AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন।
- আগে থেকে থাকা ক্লায়েন্ট আপডেট করা যাবে না: AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিয়ে নতুন OAuth ক্লায়েন্ট তৈরি করুন এবং এটি ব্যবহার করার জন্য আপনার অ্যাপ আপডেট করুন।
- আগে থেকে থাকা ক্লায়েন্ট নন-এজেন্ট ফিচারও সাপোর্ট করে: AI এজেন্টের জন্য আলাদা OAuth ক্লায়েন্ট তৈরি করুন এবং আপনার নন-এজেন্ট ফিচারের জন্য আগে থেকে থাকা ক্লায়েন্ট ব্যবহার করুন।
নির্দেশাবলীর জন্য, আপনার AI অ্যাপ্লিকেশন কনফিগার করুন এবং OAuth ক্লায়েন্ট ম্যানেজ করুন দেখুন।
ডোমেন-ওয়াইড ডেলিগেশন সহ পরিষেবা অ্যাকাউন্ট
আপনার অ্যাপ যদি ২-লেগড OAuth-এর জন্য ডোমেন-ওয়াইড ডেলিগেশন সহ একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করে, তাহলে আপনি AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্পটি বেছে নিতে পারবেন না কারণ পরিষেবা অ্যাকাউন্টগুলি Google Auth প্ল্যাটফর্ম > ক্লায়েন্ট-এ ম্যানেজ করা হয় না:
- অ্যাক্সেস কন্ট্রোল: এজেন্ট সেটিং না থাকার কারণে এইসব পরিষেবা অ্যাকাউন্ট থেকে MCP সার্ভারে করা অনুরোধ বাতিল করা হয় না। পরিবর্তে, অ্যাক্সেস ডোমেন-ওয়াইড ডেলিগেশন সেটিংস দ্বারা পরিচালিত হয় যা আপনার Google Workspace অ্যাডমিনিস্ট্রেটর ম্যানেজ করেন। অ্যাডমিনিস্ট্রেটর সেটিংস সম্পর্কে বিস্তারিত জানতে, ডোমেন-জুড়ে প্রতিনিধিদলের সাথে API অ্যাক্সেস নিয়ন্ত্রণ করুন দেখুন।
- সংবেদনশীল অ্যাকশন: Google Workspace MCP সার্ভার এখনও ডোমেন-ওয়াইড ডেলিগেশন ব্যবহারকারীর ছদ্মবেশের মাধ্যমে করা সংবেদনশীল টুল কলের হিউম্যান-ইন-দ্য-লুপ কনফার্মেশনের জন্য ফর্ম এলিসিটেশন প্রম্পট রিটার্ন করে।
Apps Script থেকে পাওয়া অনুরোধ
আপনি Apps Script থেকে MCP সার্ভার কল করলে, ডিফল্ট OAuth ক্লায়েন্টে AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিতে পারবেন না, যা Apps Script আপনার স্ক্রিপ্টের জন্য তৈরি ও ম্যানেজ করে। আপনার স্ক্রিপ্ট স্ট্যান্ডার্ড Google Cloud প্রোজেক্ট ব্যবহার করলেও এটি প্রযোজ্য হয়।
Apps Script থেকে MCP সার্ভার কল করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
- Google Cloud কনসোলে, Google Auth প্ল্যাটফর্ম > ক্লায়েন্ট বিকল্পে যান, একটি OAuth ক্লায়েন্ট তৈরি করুন, এবং AI-পরিচালিত এজেন্টের জন্য এই ক্লায়েন্ট ব্যবহার করুন বিকল্প বেছে নিন।
- আপনার স্ক্রিপ্টে, Apps Script-এর জন্য OAuth2 লাইব্রেরি ব্যবহার করে সেই OAuth ক্লায়েন্টের মাধ্যমে ব্যবহারকারীদের অনুমোদন দিন।
- আপনি MCP সার্ভার কল করলে,
ScriptApp.getOAuthTokenথেকে পাওয়া টোকেনের পরিবর্তে লাইব্রেরি থেকে ফেরত পাওয়া অ্যাক্সেস টোকেন পাঠান।
Google Workspace MCP সার্ভার কল করে না এমন Apps Script প্রোজেক্ট প্রভাবিত হয় না।
প্রতি ঘণ্টায় সাইন-ইন প্রম্পট দেখানো হয়েছে
আপনাকে যদি প্রতি এক ঘণ্টা অন্তর আবার সাইন-ইন করতে বলা হয়, তাহলে আপনার MCP ক্লায়েন্ট রিফ্রেশ টোকেন পাচ্ছে না বা ব্যবহার করছে না। সাধারণত নিম্নলিখিত পরিস্থিতিতে এটি ঘটে:
- ওয়েব অ্যাপ্লিকেশন OAuth ক্লায়েন্টে অফলাইন অ্যাক্সেস নেই: ডেস্কটপ অ্যাপ OAuth ক্লায়েন্টের মতো নয়, ওয়েব অ্যাপ্লিকেশন OAuth ক্লায়েন্ট ডিফল্ট হিসেবে
অনলাইন অ্যাক্সেস করে। রিফ্রেশ টোকেনের অনুরোধ করতে,
access_type=offlineঅন্তর্ভুক্ত করুন অথবা অন্তত একটি API স্কোপের পাশাপাশি OpenID Connect (OIDC)offline_accessস্কোপ অন্তর্ভুক্ত করুন এবংaccess_type=onlineসেট করবেন না। - আগে থেকেই সম্মতি দেওয়া অ্যাপকে আবার অনুমতি দেওয়া: Google-এর OAuth 2.0 সার্ভার
ব্যবহারকারী প্রথমবার অফলাইন অ্যাক্সেসের অনুমতি দিলে রিফ্রেশ টোকেন ইস্যু করে। কোনও
ব্যবহারকারী যদি অফলাইন অ্যাক্সেস ছাড়াই আপনার OAuth ক্লায়েন্টকে আগে থেকেই অনুমতি দিয়ে থাকেন অথবা
আপনার MCP ক্লায়েন্ট যদি তার স্টোর করা রিফ্রেশ টোকেন হারিয়ে ফেলে, তাহলে পরবর্তী সাইন-ইনগুলি
নতুন রিফ্রেশ টোকেন নাও ফেরত দিতে পারে। অনুমোদনের অনুরোধে
prompt=consentঅন্তর্ভুক্ত করুন অথবা Google অ্যাকাউন্ট কানেকশন থেকে অ্যাপের অ্যাক্সেস সরিয়ে দিন এবং আবার সাইন-ইন করুন। - স্ট্যাটিক বিয়ারার টোকেন: আপনি যদি
Authorizationহেডারে একটি র অ্যাক্সেস টোকেন পাস করেন, যেমনgcloud auth print-access-tokenথেকে আউটপুট, তাহলে আপনার ক্লায়েন্ট এটি রিফ্রেশ না করলে এক ঘণ্টা পরে টোকেনের মেয়াদ শেষ হয়ে যায়।
আরও জানতে, অ্যাক্সেস টোকেন রিফ্রেশ করুন দেখুন।
টুল রেফারেন্স
Docs MCP সার্ভারের জন্য নিম্নলিখিত টুল উপলভ্য। ইনপুট ও আউটপুট স্কিমার জন্য, Docs MCP রেফারেন্স দেখুন:
নিরাপত্তা সংক্রান্ত গুরুত্বপূর্ণ বিষয়: ইনডাইরেক্ট প্রম্পট ইঞ্জেকশন
আপনি যখন কোনও ল্যাঙ্গুয়েজ মডেলকে এমন ডেটার সাথে ব্যবহার করেন যা বিশ্বস্ত নয়, তখন ইনডাইরেক্ট প্রম্পট ইঞ্জেকশন অ্যাটাকের ঝুঁকি থাকে। Google Antigravity-এর মতো AI অ্যাপ্লিকেশনগুলি Docs MCP সার্ভারের মাধ্যমে শক্তিশালী টুল এবং API অ্যাক্সেস করতে পারে, তাই তারা আপনার Google অ্যাকাউন্টের ডেটা পড়তে, পরিবর্তন করতে এবং মুছে ফেলতে পারে।
এইসব ঝুঁকি কমাতে, আপনাকে অবশ্যই ক্ষতিকর কন্টেন্ট বা প্রম্পট ইঞ্জেকশন অ্যাটাকের জন্য প্রম্পট ও উত্তর স্ক্রিন করতে হবে। আপনি Google-এর প্রদান করা Model Armor ব্যবহার করতে পারেন অথবা আপনার নিজস্ব সমাধান ব্যবহার করতে পারেন, যদি আপনি এটি ডকুমেন্ট করেন যাতে ব্যবহারকারীরা সেই ঝুঁকি গ্রহণ করতে পারেন। নির্দেশাবলীর জন্য, Google Workspace MCP সার্ভারের জন্য নিরাপত্তা কনফিগার করুন দেখুন।
এইসব পেশাদার পদ্ধতি অনুসরণ করুন:
- শুধুমাত্র বিশ্বস্ত টুল ব্যবহার করুন। Docs MCP সার্ভারকে কখনও অবিশ্বস্ত বা যাচাই না করা অ্যাপ্লিকেশনের সাথে কানেক্ট করবেন না।
- অবিশ্বস্ত ইনপুট সম্পর্কে সতর্ক থাকুন। আপনার AI অ্যাপ্লিকেশনকে যাচাই না করা সোর্স থেকে ডকুমেন্ট বা অন্যান্য রিসোর্স প্রসেস করতে বলবেন না। এইসব ইনপুটে লুকানো নির্দেশাবলী থাকতে পারে যা আপনার সেশন হাইজ্যাক করতে পারে এবং কোনও আক্রমণকারীকে আপনার ডেটা পরিবর্তন, চুরি বা মুছে ফেলার অনুমতি দিতে পারে।
- সব অ্যাকশন পর্যালোচনা করুন। আপনার AI অ্যাপ্লিকেশন আপনার হয়ে যেসব অ্যাকশন নিয়েছে সেগুলি সবসময় ভালোভাবে পর্যালোচনা করুন যাতে নিশ্চিত হতে পারেন যে সেগুলি সঠিক এবং আপনার উদ্দেশ্য অনুযায়ী হয়েছে।