ডেভেলপার নলেজ MCP সার্ভারের সাথে সংযোগ করুন

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

এমসিপি সার্ভারের সক্ষমতা

গুগল ডেভেলপার নলেজ এমসিপি সার্ভার আপনার এআই কোডিং অ্যাসিস্ট্যান্টকে তিনটি মূল টুল প্রদান করে:

টুলের নাম	বর্ণনা
search_documents	গুগল ডেভেলপার ডকুমেন্টেশন অনুসন্ধান করে এবং ডকুমেন্টের নামসহ সবচেয়ে প্রাসঙ্গিক পৃষ্ঠার অংশবিশেষ প্রদর্শন করে।
get_documents	search_documents দ্বারা প্রাপ্ত নামগুলো ব্যবহার করে ডকুমেন্টগুলোর সম্পূর্ণ মার্কডাউন কন্টেন্ট পুনরুদ্ধার করে।
answer_query	ডেভেলপার নলেজ কর্পাসের উপর ভিত্তি করে সুসংগঠিত ও সংশ্লেষিত উত্তর তৈরি করে।

` search_documents টুলটি আপনার কোয়েরির সাথে মেলে এমন সবচেয়ে প্রাসঙ্গিক অংশগুলো খুঁজে বের করার জন্য গুগলের ডকুমেন্টেশনে অনুসন্ধান করে। আপনি যখন কোনো প্রশ্ন করেন, তখন টুলটি সংক্ষিপ্ত টেক্সট অংশ ফেরত দেয়। যদি আপনার এজেন্টের কোনো একটি অংশের চারপাশের সম্পূর্ণ পৃষ্ঠার প্রেক্ষাপটের প্রয়োজন হয়, তবে সে পুরো পৃষ্ঠাটি পুনরুদ্ধার করার জন্য get_documents এ ডকুমেন্টটির রিসোর্স নামটি পাস করতে পারে।

যখন আপনি সরাসরি সার্চ রেজাল্ট বা সম্পূর্ণ মার্কডাউন ফাইলের পরিবর্তে ডেভেলপার নলেজ কর্পাস থেকে সংশ্লেষিত কোনো প্রশ্নের সরাসরি উত্তর চান, তখন answer_query টুলটি ব্যবহার করুন।

আপনার প্রমাণীকরণ পদ্ধতি বেছে নিন

আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট এবং এআই অ্যাসিস্ট্যান্টের উপর নির্ভর করে ডেভেলপার নলেজ এমসিপি সার্ভার দুটি অথেনটিকেশন পদ্ধতি সমর্থন করে:

• এপিআই কী (API key) : এটি ক্লড কোড (Claude Code), কার্সর (Cursor), গিটহাব কপাইলট (GitHub Copilot), কোডেক্স (Codex) এবং অন্যান্য রিমোট এমসিপি (MCP) ক্লায়েন্টের মতো থার্ড-পার্টি আইডিই (IDE) এবং সিএলআই (CLI) এজেন্টের জন্য সবচেয়ে ভালো। HTTPS-এর মাধ্যমে X-Goog-Api-Key হেডারে এপিআই কী-টি পাস করুন।
• OAuth এবং ADC : গুগল অ্যান্টিগ্র্যাভিটি অথবা এন্টারপ্রাইজ ওয়ার্কফ্লো-এর জন্য সর্বোত্তম, যেগুলো অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়ালস (ADC) বা একটি স্বতন্ত্র OAuth 2.0 ক্লায়েন্ট আইডি ব্যবহার করে।

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

আপনার পরিচয়পত্র তৈরি করতে একটি ট্যাব নির্বাচন করুন:

এপিআই কী

পূর্বশর্ত

এপিআই কী তৈরি করার আগে, নিশ্চিত করুন যে আপনার কাছে নিম্নলিখিত জিনিসগুলো আছে:

• একটি গুগল ক্লাউড প্রকল্প ।
• gcloud CLI ইনস্টল করা আছে (যদি কমান্ড লাইন থেকে কনফিগার করা হয়)।

এপিআই সক্রিয় করুন এবং একটি এপিআই কী তৈরি করুন।

আপনি গুগল ক্লাউড কনসোল অথবা gcloud CLI ব্যবহার করে একটি API কী তৈরি করতে পারেন:

গুগল ক্লাউড কনসোল

1. গুগল ক্লাউড কনসোলে ডেভেলপার নলেজ এপিআই পৃষ্ঠাটি খুলুন।
2. আপনার গুগল ক্লাউড প্রজেক্টটি নির্বাচন করুন এবং 'সক্ষম করুন'- এ ক্লিক করুন।
3. ক্রেডেনশিয়াল পৃষ্ঠায় যান।
4. Create credentials-এ ক্লিক করুন এবং API key নির্বাচন করুন।
5. বিধিনিষেধ কনফিগার করতে 'Edit API key' অ্যাকশনটিতে ক্লিক করুন:
   • API বিধিনিষেধের অধীনে, 'কী সীমাবদ্ধ করুন' (Restrict key ) বিকল্পটি বেছে নিন।
   • ডেভেলপার নলেজ এপিআই নির্বাচন করুন।
   • আপনি যদি মডেল কলের জন্য এই একই কী (যেমন GEMINI_API_KEY ) ব্যবহার করার পরিকল্পনা করেন, তাহলে জেনারেটিভ ল্যাঙ্গুয়েজ এপিআই (Generative Language API )-ও নির্বাচন করুন।
6. সেভ-এ ক্লিক করুন, তারপর আপনার এপিআই কী কপি করুন।

gcloud CLI

1. আপনার প্রোজেক্টে ডেভেলপার নলেজ এপিআই (Developer Knowledge API) সক্রিয় করুন, এখানে PROJECT_ID এর জায়গায় আপনার প্রোজেক্ট আইডি বসান:

   gcloud services enable developerknowledge.googleapis.com \
     --project=PROJECT_ID
   

2. একটি এপিআই কী তৈরি করুন:

   gcloud services api-keys create \
     --project=PROJECT_ID \
     --display-name="DK API Key"
   

   এই কমান্ডটি আপনার নতুন কী-এর মেটাডেটা বিবরণ ফেরত দেয়। কমান্ড আউটপুট থেকে নিচের দুটি মানই কপি করে সংরক্ষণ করুন:

   • keyString : এটি হলো মূল API কী (উদাহরণস্বরূপ, AIzaSy... )। আপনাকে এই মানটি আপনার IDE কনফিগারেশনে পেস্ট করতে হবে।
   • name : এটি হলো কী-টির রিসোর্স পাথ (উদাহরণস্বরূপ, projects/PROJECT_ID/locations/global/keys/UNIQUE_ID )। পরবর্তী ধাপে কী-টিকে সীমাবদ্ধ করতে আপনি এই পাথটি ব্যবহার করবেন।

3. অননুমোদিত ব্যবহার রোধ করতে ডেভেলপার নলেজ এপিআই-এর জন্য কী-টি সীমাবদ্ধ করুন। পূর্ববর্তী ধাপ থেকে কপি করা সম্পূর্ণ name পাথ দিয়ে KEY_NAME প্রতিস্থাপন করুন:

   gcloud services api-keys update KEY_NAME \
     --api-target=service=developerknowledge.googleapis.com
   

   গুরুত্বপূর্ণ: যদি আপনি আপনার এআই ক্লায়েন্টের সাধারণ মডেল কলগুলির জন্য এই একই কী ব্যবহার করার পরিকল্পনা করেন (উদাহরণস্বরূপ, GEMINI_API_KEY ), তাহলে আপনাকে অবশ্যই জেনারেটিভ ল্যাঙ্গুয়েজ এপিআই-কেও অনুমতি দিতে হবে:

   gcloud services api-keys update KEY_NAME \
     --api-target=service=developerknowledge.googleapis.com \
     --api-target=service=generativelanguage.googleapis.com
   

OAuth এবং ADC

পূর্বশর্ত

OAuth কনফিগার করার আগে, নিশ্চিত করুন যে আপনার কাছে নিম্নলিখিত জিনিসগুলো আছে:

• একটি গুগল ক্লাউড প্রকল্প ।
• gcloud CLI ইনস্টল করা হয়েছে ।

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

আপনার প্রোজেক্টে ডেভেলপার নলেজ এপিআই (Developer Knowledge API) সক্রিয় করতে নিম্নলিখিত কমান্ডটি চালান:

gcloud services enable developerknowledge.googleapis.com \
  --project=PROJECT_ID

আপনার OAuth ক্রেডেনশিয়াল টাইপ বেছে নিন

আপনার টুলের জন্য প্রয়োজনীয় ক্রেডেনশিয়াল পদ্ধতিটি নির্বাচন করুন:

অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল

যদি আপনার এআই অ্যাসিস্ট্যান্ট ADC সমর্থন করে (যেমন গুগল অ্যান্টিগ্র্যাভিটি):

1. আপনার গুগল অ্যাকাউন্ট দিয়ে প্রমাণীকরণ করুন এবং আপনার কোটা প্রকল্প সেট করুন:

   gcloud auth application-default login \
     --project=PROJECT_ID
   

2. আপনার ব্রাউজারটি খুললে, আপনার গুগল অ্যাকাউন্ট দিয়ে সাইন ইন করুন এবং অনুরোধ করা অনুমতিগুলো প্রদান করুন।

OAuth ক্লায়েন্ট আইডি

যদি আপনার এআই অ্যাসিস্ট্যান্টের একটি স্বতন্ত্র OAuth ক্লায়েন্ট আইডি এবং সিক্রেট প্রয়োজন হয়:

1. OAuth সম্মতি স্ক্রিনটি খুলুন।
2. ব্যবহারকারীর ধরন ‘এক্সটার্নাল’ হিসেবে সেট করুন, প্রয়োজনীয় অ্যাপের নাম ও সাপোর্ট ইমেল পূরণ করুন এবং ‘সেভ অ্যান্ড কন্টিনিউ’-তে ক্লিক করুন।
3. অডিয়েন্স পেজে , টেস্ট ইউজার্স-এর অধীনে অ্যাড ইউজার্স- এ ক্লিক করুন, আপনার গুগল ইমেল অ্যাড্রেসটি লিখুন এবং সেভ-এ ক্লিক করুন।
4. ক্লায়েন্ট পেজে যান, 'ক্রিয়েট ক্লায়েন্ট'-এ ক্লিক করুন এবং 'অ্যাপ্লিকেশন টাইপ' হিসেবে 'ডেস্কটপ অ্যাপ' সেট করুন।
5. Create-এ ক্লিক করুন, তারপর JSON ক্লায়েন্ট ক্রেডেনশিয়াল ফাইলটি ডাউনলোড করুন।

আপনার IDE বা কোডিং এজেন্ট কনফিগার করুন

আপনার পরিচয়পত্র পাওয়ার পর, সেটআপ নির্দেশাবলী দেখতে আপনার পছন্দের কোডিং পরিবেশ নির্বাচন করুন।

আপনার নির্বাচিত প্রমাণীকরণ পদ্ধতির উপর নির্ভর করে, কনফিগারেশন টেমপ্লেটগুলিতে থাকা প্লেসহোল্ডারগুলি নিম্নরূপভাবে প্রতিস্থাপন করুন:

• এপিআই কী প্রমাণীকরণ : YOUR_API_KEY আপনার মূল এপিআই কী স্ট্রিং দিয়ে প্রতিস্থাপন করুন।

• OAuth বা ADC প্রমাণীকরণ : PROJECT_ID জায়গায় আপনার Google Cloud প্রজেক্ট আইডি বসান:

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

অ্যান্টিগ্র্যাভিটি আইডিই এবং এক্সটেনশন

Antigravity IDE বা Antigravity এক্সটেনশনে (যেমন VS Code-এ) MCP সার্ভার কনফিগার করতে, আপনার প্রমাণীকরণ পদ্ধতি নির্বাচন করুন:

গুগল পরিচয়পত্র

ওয়ান-ক্লিক সেটআপ ব্যবহার করে এমসিপি সার্ভার ইনস্টল করতে:

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

এপিআই কী

Antigravity IDE বা Antigravity এক্সটেনশনে একটি API কী কনফিগার করতে:

1. এজেন্ট প্যানেলে, অতিরিক্ত বিকল্প ( ) মেনুতে ক্লিক করুন > MCP সার্ভার > MCP সার্ভার পরিচালনা করুন > মূল কনফিগারেশন দেখুন (অথবা .agents/mcp_config.json খুলুন)।

2. নিম্নলিখিত সার্ভার কনফিগারেশন যোগ করুন:

   {
     "mcpServers": {
       "google-developer-knowledge": {
         "serverUrl": "https://developerknowledge.googleapis.com/mcp",
         "headers": {
           "X-Goog-Api-Key": "YOUR_API_KEY"
         }
       }
     }
   }
   

অ্যান্টিগ্র্যাভিটি সিএলআই

আপনার প্রোজেক্টের .agents/mcp_config.json ফাইলে (অথবা বিশ্বব্যাপী ~/.gemini/config/mcp_config.json ফাইলে) MCP সার্ভারটি কনফিগার করুন:

গুগল পরিচয়পত্র

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
      },
      "timeout": 30000,
      "headers": {
        "X-goog-user-project": "PROJECT_ID"
      }
    }
  }
}

এপিআই কী

{
  "mcpServers": {
    "google-developer-knowledge": {
      "serverUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

পরামর্শ: আপনি যদি স্বতন্ত্র Antigravity 2.0 অ্যাপ্লিকেশনটি ব্যবহার করেন, তাহলে Settings > Customizations- এ যান এবং আপনার কনফিগারেশন যোগ করতে Installed MCP Servers-এর অধীনে Open MCP Config-এ ক্লিক করুন।

ক্লদ কোড

আপনার টার্মিনালে নিম্নলিখিত কমান্ডটি চালান:

claude mcp add google-dev-knowledge \
  --transport http https://developerknowledge.googleapis.com/mcp \
  --header "X-Goog-Api-Key: YOUR_API_KEY"

কার্সার

Cursor কনফিগার করতে, আপনার প্রজেক্ট রুটে থাকা .cursor/mcp.json এডিট করুন, অথবা গ্লোবাল অ্যাক্সেসের জন্য ~/.cursor/mcp.json এডিট করুন:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

গিটহাব কোপাইলট

দ্রষ্টব্য: আপনি যদি GitHub Copilot-এর পরিবর্তে VS Code-এ Antigravity এক্সটেনশনটি ব্যবহার করেন, তাহলে Google Antigravity ট্যাবটি নির্বাচন করুন।

কর্মক্ষেত্রের সেটিংস

একটি নির্দিষ্ট ওয়ার্কস্পেসের জন্য VS Code-এ GitHub Copilot কনফিগার করতে, .vscode/mcp.json তৈরি বা সম্পাদনা করুন:

{
  "servers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

বিশ্বব্যাপী ব্যবহারকারীর সেটিংস

সমস্ত VS Code ওয়ার্কস্পেসে সার্ভারটি উপলব্ধ করতে, আপনার ইউজার সেটিংস (JSON) খুলুন এবং "mcp" কী-এর অধীনে নিম্নলিখিতটি যোগ করুন:

{
  "mcp": {
    "servers": {
      "google-developer-knowledge": {
        "url": "https://developerknowledge.googleapis.com/mcp",
        "headers": {
          "X-Goog-Api-Key": "YOUR_API_KEY"
        }
      }
    }
  }
}

কোডেক্স

Codex CLI অথবা Codex এজেন্ট কনফিগার করতে, সার্ভার কনফিগারেশনটি ~/.codex/config.json (বা আপনার প্রোজেক্টের .codex/config.json )-এ যোগ করুন:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

অন্যান্য

অন্য কোনো রিমোট এমসিপি ক্লায়েন্ট (যেমন JetBrains AI Assistant, Windsurf, Cline, Zed, Continue, বা Claude Desktop) কনফিগার করতে, নিম্নলিখিত সেটিংস সহ একটি HTTP ট্রান্সপোর্ট সার্ভার কনফিগার করুন:

• সার্ভার ইউআরএল : https://developerknowledge.googleapis.com/mcp
• HTTP হেডার : X-Goog-Api-Key: YOUR_API_KEY

স্ট্যান্ডার্ড JSON কনফিগারেশন টেমপ্লেট:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

সংযোগ যাচাই করুন

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

How do I list Cloud Storage buckets using the Google Cloud Python SDK?

যদি এজেন্ট search_documents বা answer_query কল করে এবং গুগল ডকুমেন্টেশন থেকে তথ্য ফেরত দেয়, তাহলে আপনার সার্ভার সংযুক্ত এবং সক্রিয় আছে।

কনটেক্সট উইন্ডো এবং টোকেন ব্যবহার অপ্টিমাইজ করুন

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

দ্রুত ও সাশ্রয়ী প্রতিক্রিয়া নিশ্চিত করতে, এই তাৎক্ষণিক প্রকৌশলগত সর্বোত্তম অনুশীলনগুলো অনুসরণ করুন:

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

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

• সুনির্দিষ্ট ও পরিসরভিত্তিক প্রশ্ন লিখুন : "ফায়ারবেস সম্পর্কে সবকিছু ব্যাখ্যা করুন"-এর মতো অতি সাধারণ প্রশ্ন পরিহার করুন। এর পরিবর্তে, নির্দিষ্ট পণ্য, প্ল্যাটফর্ম এবং ভাষা উল্লেখ করুন:

  How do I write a Firestore transaction in Dart with error handling?
  

• কাস্টম এজেন্ট নিয়ম যোগ করুন : স্বয়ংক্রিয়ভাবে সম্পূর্ণ পৃষ্ঠা আনার প্রক্রিয়া সীমিত করতে আপনার অ্যাসিস্ট্যান্টের নির্দেশনা ফাইলগুলিতে (যেমন, .cursorrules , CLAUDE.md , বা .github/copilot-instructions.md ) প্রোজেক্ট-স্তরের নির্দেশিকা যোগ করুন:

  When searching Google developer documentation, inspect search_documents
  snippets first. Do not call get_documents unless the snippet lacks
  necessary code context.
  

ঐচ্ছিক নিরাপত্তা এবং সুরক্ষা কনফিগারেশন

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

এমসিপি নিরাপত্তা এবং পরিচালনা সম্পর্কে আরও তথ্যের জন্য, এআই নিরাপত্তা ও সুরক্ষা দেখুন।

মডেল আর্মার ব্যবহার করুন

মডেল আর্মার হলো একটি গুগল ক্লাউড পরিষেবা, যা আপনার এআই অ্যাপ্লিকেশনগুলির নিরাপত্তা ও সুরক্ষা বাড়ানোর জন্য ডিজাইন করা হয়েছে। এটি সক্রিয়ভাবে এলএলএম (LLM) প্রম্পট এবং প্রতিক্রিয়াগুলি স্ক্রিনিং করার মাধ্যমে কাজ করে, যা বিভিন্ন ঝুঁকি থেকে সুরক্ষা দেয় এবং দায়িত্বশীল এআই অনুশীলনকে সমর্থন করে। আপনি আপনার ক্লাউড পরিবেশে বা বাহ্যিক ক্লাউড সরবরাহকারীদের কাছে এআই স্থাপন করুন না কেন, মডেল আর্মার আপনাকে ক্ষতিকারক ইনপুট প্রতিরোধ করতে, বিষয়বস্তুর নিরাপত্তা যাচাই করতে, সংবেদনশীল ডেটা সুরক্ষিত করতে, নিয়ম মেনে চলতে এবং আপনার বৈচিত্র্যময় এআই পরিমণ্ডলে ধারাবাহিকভাবে আপনার এআই সুরক্ষা ও নিরাপত্তা নীতিগুলি প্রয়োগ করতে সাহায্য করতে পারে।

যখন লগিং চালু থাকা অবস্থায় মডেল আর্মার সক্রিয় করা হয়, তখন এটি সম্পূর্ণ পেলোডটি লগ করে। এর ফলে আপনার লগে সংবেদনশীল তথ্য প্রকাশিত হতে পারে।

মডেল আর্মার-এ এমসিপি অনুরোধ রাউটিং

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

মডেল আর্মার সক্রিয় করুন

Model Armor সক্রিয় করতে, Google এবং Google Cloud MCP সার্ভারগুলির সাথে ইন্টিগ্রেট করার ধাপগুলি অনুসরণ করুন।

রিমোট এমসিপি সার্ভারগুলির জন্য সুরক্ষা কনফিগার করুন

আপনার MCP টুলের কল এবং রেসপন্স সুরক্ষিত রাখতে আপনি মডেল আর্মার ফ্লোর সেটিংস ব্যবহার করতে পারেন। একটি ফ্লোর সেটিং প্রজেক্ট জুড়ে প্রযোজ্য ন্যূনতম নিরাপত্তা ফিল্টারগুলো নির্ধারণ করে। এই কনফিগারেশনটি প্রজেক্টের মধ্যে থাকা সমস্ত MCP টুলের কল এবং রেসপন্সের উপর একটি সামঞ্জস্যপূর্ণ ফিল্টার সেট প্রয়োগ করে।

পরামর্শ: আপনার MCP ট্র্যাফিকে স্বাভাবিক ভাষার ডেটা না থাকলে প্রম্পট ইনজেকশন এবং জেলব্রেক ফিল্টার সক্রিয় করবেন না।

MCP স্যানিটাইজেশন সক্রিয় করে একটি মডেল আর্মার ফ্লোর সেটিং সেট আপ করুন। আরও তথ্যের জন্য, মডেল আর্মার ফ্লোর সেটিংস কনফিগার করুন দেখুন।

দ্রষ্টব্য: যদি এজেন্ট এবং এমসিপি সার্ভার ভিন্ন ভিন্ন প্রজেক্টে থাকে, তাহলে আপনি উভয় প্রজেক্টেই (ক্লায়েন্ট প্রজেক্ট এবং রিসোর্স প্রজেক্ট) ফ্লোর সেটিংস তৈরি করতে পারেন। এক্ষেত্রে, মডেল আর্মার দুইবার কল করা হবে, প্রতিটি প্রজেক্টের জন্য একবার করে।

নিম্নলিখিত উদাহরণ কমান্ডটি দেখুন:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

PROJECT_ID আপনার দিয়ে প্রতিস্থাপন করুন প্রকল্প আইডি।

নিম্নলিখিত সেটিংসগুলো লক্ষ্য করুন:

• INSPECT_AND_BLOCK : এটি এমন এক ধরনের প্রয়োগ ব্যবস্থা যা গুগল এমসিপি সার্ভারের জন্য কন্টেন্ট যাচাই করে এবং ফিল্টারের সাথে মিলে যাওয়া প্রম্পট ও রেসপন্স ব্লক করে দেয়।
• ENABLED : যে সেটিংটি কোনো ফিল্টার বা প্রয়োগ সক্ষম করে।
• MEDIUM_AND_ABOVE : দায়িত্বশীল এআই - বিপজ্জনক ফিল্টার সেটিংসের জন্য আত্মবিশ্বাসের স্তর। আপনি এই সেটিংটি পরিবর্তন করতে পারেন, যদিও কম মানের ফলে আরও বেশি ফলস পজিটিভ হতে পারে। আরও তথ্যের জন্য, মডেল আর্মার কনফিডেন্স লেভেল দেখুন।

মডেল আর্মার দিয়ে MCP ট্র্যাফিক স্ক্যানিং নিষ্ক্রিয় করুন

প্রজেক্টের ফ্লোর সেটিংসের উপর ভিত্তি করে Google MCP সার্ভার থেকে এবং সার্ভারে আসা ট্র্যাফিক স্বয়ংক্রিয়ভাবে স্ক্যান করা থেকে Model Armor-কে বিরত রাখতে, নিম্নলিখিত কমান্ডটি চালান:

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

PROJECT_ID কে দিয়ে প্রতিস্থাপন করুন প্রজেক্ট আইডি। মডেল আর্মার এই প্রজেক্টের ফ্লোর সেটিংসে সংজ্ঞায়িত নিয়মগুলি কোনো গুগল এমসিপি সার্ভার ট্র্যাফিকের ক্ষেত্রে স্বয়ংক্রিয়ভাবে প্রয়োগ করে না।

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

মডেল আর্মার সেটিংস সামঞ্জস্য করুন

আপনি যদি আপনার অ্যাপ্লিকেশন সুরক্ষিত করতে মডেল আর্মার ব্যবহার করেন, তাহলে কিছু কোয়েরির ক্ষেত্রে আপনি 403 PERMISSION_DENIED এররের সম্মুখীন হতে পারেন। যেহেতু ডেভেলপার নলেজ এমসিপি সার্ভার শুধুমাত্র বিশ্বস্ত গুগল উৎস থেকে পাবলিক ডকুমেন্টেশন ফেরত দেয়, তাই ফলস পজিটিভ কমাতে আমরা প্রম্পট ইনজেকশন অ্যান্ড জেলব্রেক (PIJB) ফিল্টারগুলোকে HIGH_AND_ABOVE কনফিডেন্স লেভেলে সেট করার পরামর্শ দিই। যদি আপনার ব্যবহারের ক্ষেত্রে এমন কোনো টুল জড়িত না থাকে যা ব্যক্তিগত বা সংবেদনশীল ডেটা অ্যাক্সেস করে, তাহলে আপনি PIJB ফিল্টারগুলো নিষ্ক্রিয় করার কথাও বিবেচনা করতে পারেন।

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

ডেভেলপার নলেজ এমসিপি সার্ভারে সংযোগ করতে বা কোয়েরি করতে সমস্যা হলে, নিম্নলিখিত ট্রাবলশুটিং ম্যাট্রিক্স এবং সমাধানের ধাপগুলো দেখুন:

সমস্যা সমাধান ম্যাট্রিক্স

লক্ষণ বা ত্রুটি	সম্ভাব্য কারণ	সমাধান
400 Bad Request: API key not valid	এপিআই কী স্ট্রিংটি অনুপস্থিত, অবৈধ বা ত্রুটিপূর্ণ।	যাচাই করুন যে এপিআই কী-টি সঠিকভাবে কপি করা হয়েছে এবং headers অবজেক্টে X-Goog-Api-Key কী-টির সাথে কনফিগার করা হয়েছে।
403 PERMISSION_DENIED : Developer Knowledge API has not been used	গুগল ক্লাউড প্রজেক্টে ডেভেলপার নলেজ এপিআই সক্রিয় করা নেই।	Google Cloud কনসোলে API-টি সক্রিয় করুন অথবা gcloud services enable developerknowledge.googleapis.com চালান।
403 PERMISSION_DENIED: API target restriction	এপিআই কী সীমাবদ্ধতা তালিকা থেকে ডেভেলপার নলেজ এপিআই বাদ দেওয়া হয়েছে।	ডেভেলপার নলেজ এপিআই অন্তর্ভুক্ত করতে গুগল ক্লাউড কনসোলের ক্রেডেনশিয়ালস পৃষ্ঠায় আপনার এপিআই কী বিধিনিষেধ আপডেট করুন।
401 UNAUTHENTICATED অথবা অনুপস্থিত ADC ক্রেডেনশিয়াল	অ্যাপ্লিকেশনের ডিফল্ট ক্রেডেনশিয়ালগুলোর মেয়াদ শেষ হয়ে গেছে অথবা সেগুলো ইনিশিয়ালাইজ করা হয়নি।	স্থানীয় ক্রেডেনশিয়াল রিফ্রেশ করতে gcloud auth application-default login --project=PROJECT_ID চালান।
403 access_denied / "অ্যাক্সেস ব্লক করা হয়েছে: অনুমোদন ত্রুটি"	OAuth সম্মতিতে আপনার অ্যাকাউন্টটি অনুমোদিত পরীক্ষামূলক ব্যবহারকারী হিসেবে তালিকাভুক্ত নয়।	Google Cloud কনসোল > Auth Platform > Audience- এ, Test users-এর অধীনে আপনার ইমেল ঠিকানা যোগ করুন।
OAuth ক্লায়েন্ট ত্রুটি বা অবৈধ পুনঃনির্দেশ URI	OAuth ক্লায়েন্টটি একটি অসমর্থিত অ্যাপ্লিকেশন টাইপ দিয়ে তৈরি করা হয়েছিল।	টাইপটি ‘ডেস্কটপ অ্যাপ’ হিসেবে সেট করে আপনার OAuth ক্লায়েন্ট আইডি পুনরায় তৈরি করুন।
/mcp এন্ডপয়েন্টে 404 NOT_FOUND	আপনার প্রোজেক্টের জন্য এপিআইটি সক্রিয় করা নেই।	গুগল ক্লাউড কনসোলে ডেভেলপার নলেজ এপিআই (Developer Knowledge API) সক্রিয় করুন অথবা gcloud services enable developerknowledge.googleapis.com চালান।
429 RESOURCE_EXHAUSTED	আপনি আপনার প্রকল্পের কোটার সীমায় পৌঁছে গেছেন।	কনসোলে আপনার ডেভেলপার নলেজ এপিআই কোটার ব্যবহার পরীক্ষা করুন এবং প্রয়োজনে কোটা বৃদ্ধির জন্য অনুরোধ করুন।
403 PERMISSION_DENIED	মডেল আর্মার পিআইজেবি ফিল্টারের একটি ফলস পজিটিভ একটি নিরাপদ কোয়েরিকে ব্লক করে দিয়েছে।	আপনার মডেল আর্মার টেমপ্লেট সেটিংসে PIJB ফিল্টার কনফিডেন্স HIGH_AND_ABOVE এ সেট করুন।

প্রমাণীকরণ এবং সম্মতি ত্রুটিগুলি সমাধান করুন

• এপিআই কী হেডার কনফিগারেশন : যাচাই করুন যে আপনার MCP JSON কনফিগারেশনের headers সেকশনে "X-Goog-Api-Key" অন্তর্ভুক্ত আছে। ইউআরএল-এ কোয়েরি প্যারামিটার হিসেবে এপিআই কী পাস করবেন না।

• OAuth সম্মতি স্ক্রিন টেস্ট ব্যবহারকারী : টেস্টিং মোডে এক্সটার্নাল ইউজার টাইপ সহ কোনো প্রজেক্টে ডেস্কটপ OAuth ক্লায়েন্ট তৈরি করার সময়, Google টেস্ট ইউজারদের তালিকায় নেই এমন অ্যাকাউন্টগুলির অ্যাক্সেস ব্লক করে দেয়। নিশ্চিত করুন যে আপনার সক্রিয় Google ইমেল ঠিকানাটি Google Cloud কনসোলের Audience > Test users-এর অধীনে যোগ করা আছে।

• কোটা এবং রেট লিমিট : আপনার দৈনিক এবং প্রতি মিনিটের ব্যবহার নিরীক্ষণ করতে, Google Cloud কনসোলে IAM & Admin > Quotas & System Limits- এ যান এবং Developer Knowledge API দ্বারা ফিল্টার করুন।

অন্তর্ভুক্ত নথিপত্র

সার্ভার দ্বারা সূচিবদ্ধ গুগল পণ্য এবং ডকুমেন্টেশন রিপোজিটরিগুলোর সম্পূর্ণ তালিকার জন্য কর্পাস রেফারেন্স দেখুন।

জ্ঞাত সীমাবদ্ধতা

• শুধুমাত্র সর্বজনীন ডকুমেন্টেশন : সার্ভারটি কেবল কর্পাস রেফারেন্সে তালিকাভুক্ত সর্বজনীনভাবে উপলব্ধ ডকুমেন্টেশনই সূচীবদ্ধ করে। অভ্যন্তরীণ নথি, ব্যক্তিগত সংগ্রহস্থল এবং তৃতীয় পক্ষের রিসোর্স অন্তর্ভুক্ত নয়।
• ইংরেজি ভাষা : সার্ভারটি শুধুমাত্র ইংরেজিতেই ডকুমেন্টেশন সূচীবদ্ধ করে এবং ফেরত দেয়।
• নেটওয়ার্ক নির্ভরতা : https://developerknowledge.googleapis.com পৌঁছানোর জন্য সার্ভারটির সক্রিয় ইন্টারনেট সংযোগ প্রয়োজন।