Google Developer Knowledge MCP सर्वर, एआई की मदद से काम करने वाले डेवलपमेंट टूल को सीधे तौर पर इन प्रॉडक्ट के आधिकारिक Google डेवलपर दस्तावेज़ों को खोजने और उन्हें वापस पाने की सुविधा देता है: Firebase, Google Cloud, Android, Google Maps Platform वगैरह. कोडिंग असिस्टेंट को Google की आधिकारिक लाइब्रेरी से कनेक्ट करने पर, आपको वेब पर मैन्युअल तरीके से खोज करने, पुराना कॉन्टेक्स्ट इस्तेमाल करने, और स्क्रैपिंग करने की ज़रूरत नहीं पड़ती.
अगर आपको आईडीई के बजाय, अपने ऐप्लिकेशन या एजेंट कोड से डेवलपर नॉलेज एमसीपी सर्वर से कनेक्ट करना है, तो एमसीपी एसडीके का इस्तेमाल करके कनेक्ट करना लेख पढ़ें.
एमसीपी सर्वर की क्षमताएं
Google Developer Knowledge MCP सर्वर, कोडिंग में मदद करने वाले आपके एआई असिस्टेंट को तीन मुख्य टूल उपलब्ध कराता है:
| टूल का नाम | ब्यौरा |
|---|---|
search_documents |
Google डेवलपर के दस्तावेज़ों को खोजता है और सबसे काम के पेज के अंश दिखाता है. साथ ही, दस्तावेज़ों के नाम भी दिखाता है. |
get_documents |
यह फ़ंक्शन, search_documents फ़ंक्शन से मिले नामों का इस्तेमाल करके, दस्तावेज़ों का पूरा मार्कडाउन कॉन्टेंट वापस लाता है.
|
answer_query |
यह डेवलपर नॉलेज कॉर्पस से स्ट्रक्चर्ड जवाब जनरेट करता है. |
search_documents टूल, Google के दस्तावेज़ों को खोजता है, ताकि आपकी क्वेरी से मैच करने वाले सबसे काम के सेक्शन ढूंढे जा सकें. जब आप कोई सवाल पूछते हैं, तो यह टूल
आपको छोटे टेक्स्ट पैसेज दिखाता है. अगर आपके एजेंट को किसी पैसेज के आस-पास मौजूद पेज के पूरे कॉन्टेक्स्ट की ज़रूरत है, तो वह get_documents को दस्तावेज़ के रिसॉर्स का नाम पास कर सकता है, ताकि पूरा पेज वापस पाया जा सके.
जब आपको किसी सवाल का सीधा जवाब चाहिए, तो answer_query टूल का इस्तेमाल करें. यह टूल, खोज के नतीजों या पूरी Markdown फ़ाइलों के बजाय, डेवलपर नॉलेज कॉर्पस से जवाब देता है.
पुष्टि करने का तरीका चुनें
डेवलपर नॉलेज एमसीपी सर्वर, पुष्टि करने के दो तरीक़े इस्तेमाल करता है. ये तरीक़े आपके डेवलपमेंट एनवायरमेंट और एआई असिस्टेंट के हिसाब से तय होते हैं:
- एपीआई पासकोड: यह तीसरे पक्ष के आईडीई और सीएलआई एजेंट के लिए सबसे सही है. जैसे, Claude Code,
Cursor, GitHub Copilot, Codex, और अन्य रिमोट एमसीपी क्लाइंट. एचटीटीपीएस पर
X-Goog-Api-Keyहेडर में एपीआई पासकोड पास करें. - OAuth और एडीसी: यह Google Antigravity के लिए सबसे सही है. इसमें ऐप्लिकेशन डिफ़ॉल्ट क्रेडेंशियल (एडीसी) के लिए पहले से मौजूद सहायता मिलती है. इसके अलावा, यह उन एंटरप्राइज़ वर्कफ़्लो के लिए भी सबसे सही है जिनमें एपीआई पासकोड के बजाय, OAuth 2.0 बियरर टोकन या स्टैंडअलोन OAuth 2.0 क्लाइंट आईडी की ज़रूरत होती है.
चुने गए पुष्टि करने के तरीके के लिए ज़रूरी क्रेडेंशियल जनरेट करें. इससे आपका एआई असिस्टेंट या कोडिंग एजेंट, Developer Knowledge MCP सर्वर सेवा के साथ अनुरोधों की पुष्टि कर पाएगा.
अपने क्रेडेंशियल बनाने के लिए, कोई टैब चुनें:
एपीआई पासकोड
ज़रूरी शर्तें
एपीआई पासकोड बनाने से पहले, पक्का करें कि आपके पास:
- एक Google Cloud प्रोजेक्ट.
- gcloud सीएलआई इंस्टॉल किया गया हो (अगर कमांड लाइन से कॉन्फ़िगर किया जा रहा है).
एपीआई चालू करना और एपीआई पासकोड बनाना
Google Cloud Console या gcloud CLI का इस्तेमाल करके, एपीआई पासकोड जनरेट किया जा सकता है:
Google Cloud Console
- Google Cloud Console में Developer Knowledge API पेज खोलें.
- अपना Google Cloud प्रोजेक्ट चुनें और चालू करें पर क्लिक करें.
- क्रेडेंशियल पेज पर जाएं.
- क्रेडेंशियल बनाएं पर क्लिक करें और एपीआई पासकोड चुनें.
- पाबंदियां कॉन्फ़िगर करने के लिए, एपीआई पासकोड में बदलाव करें कार्रवाई पर क्लिक करें:
- एपीआई से जुड़ी पाबंदियां में जाकर, पासकोड पर पाबंदी लगाएं को चुनें.
- Developer Knowledge API को चुनें.
- अगर आपको मॉडल कॉल (जैसे कि
GEMINI_API_KEY) के लिए भी इसी पासकोड का इस्तेमाल करना है, तो Generative Language API को भी चुनें.
- सेव करें पर क्लिक करें. इसके बाद, अपना एपीआई पासकोड कॉपी करें.
gcloud सीएलआई
अपने प्रोजेक्ट में Developer Knowledge API को चालू करें. इसके लिए, PROJECT_ID की जगह अपना प्रोजेक्ट आईडी डालें:
gcloud services enable developerknowledge.googleapis.com \ --project=PROJECT_IDएपीआई पासकोड बनाएं:
gcloud services api-keys create \ --project=PROJECT_ID \ --display-name="DK API Key"यह कमांड, आपकी नई कुंजी के मेटाडेटा की जानकारी दिखाता है. कमांड के आउटपुट से, इन दोनों वैल्यू को कॉपी करके सेव करें:
keyString: यह रॉ एपीआई पासकोड है. उदाहरण के लिए,AIzaSy.... आपको इस वैल्यू को अपने आईडीई कॉन्फ़िगरेशन में चिपकाना होगा.name: यह कुंजी का संसाधन पाथ है. उदाहरण के लिए,projects/PROJECT_ID/locations/global/keys/UNIQUE_ID. अगले चरण में, इस पाथ का इस्तेमाल करके कुंजी को सीमित किया जाएगा.
एपीआई पासकोड को Developer Knowledge API तक सीमित करें, ताकि बिना अनुमति के इसका इस्तेमाल न किया जा सके. KEY_NAME को पिछले चरण से कॉपी किए गए पूरे
nameपाथ से बदलें:gcloud services api-keys update KEY_NAME \ --api-target=service=developerknowledge.googleapis.comgcloud services api-keys update KEY_NAME \ --api-target=service=developerknowledge.googleapis.com \ --api-target=service=generativelanguage.googleapis.com
OAuth और एडीसी
ज़रूरी शर्तें
OAuth या ADC को कॉन्फ़िगर करने से पहले, पक्का करें कि आपके पास ये चीज़ें हों:
एपीआई को चालू करना
अपने प्रोजेक्ट में Developer Knowledge API को चालू करने के लिए, यह कमांड चलाएं:
gcloud services enable developerknowledge.googleapis.com \
--project=PROJECT_ID
OAuth क्रेडेंशियल का टाइप चुनना
अपने टूल के लिए ज़रूरी क्रेडेंशियल का तरीका चुनें:
ADC
Google Antigravity में एडीसी की सुविधा पहले से मौजूद होती है. साथ ही, यह रीफ़्रेश टोकन अपने-आप रीफ़्रेश करता है. अन्य एमसीपी क्लाइंट, Authorization हेडर में कुछ समय के लिए मान्य धारक टोकन पास करके, एडीसी का इस्तेमाल कर सकते हैं:
अपने Google खाते से पुष्टि करें और अपना कोटा प्रोजेक्ट सेट करें:
gcloud auth application-default login \ --project=PROJECT_IDजब आपका ब्राउज़र खुले, तब अपने Google खाते से साइन इन करें और मांगी गई अनुमतियां दें.
(ज़रूरी नहीं) अगर आपको तीसरे पक्ष के ऐसे एमसीपी क्लाइंट को कॉन्फ़िगर करना है जिसमें एडीसी की सुविधा पहले से मौजूद नहीं है, तो अपने क्लाइंट के
Authorizationहेडर में इस्तेमाल करने के लिए, एक बियरर टोकन जनरेट करें. यह टोकन एक घंटे के लिए मान्य होता है:gcloud auth application-default print-access-token
OAuth क्लाइंट आईडी
अगर आपका एआई असिस्टेंट, इंटरैक्टिव OAuth फ़्लो का इस्तेमाल करता है, तो OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं. ऐसा इसलिए, क्योंकि Google के रिमोट एमसीपी सर्वर, OAuth डाइनैमिक क्लाइंट रजिस्ट्रेशन (डीसीआर) के साथ काम नहीं करते.
- ब्रैंडिंग पेज पर जाएं और अपना प्रोजेक्ट चुनें. ऐप्लिकेशन का नाम और उपयोगकर्ता सहायता के लिए ईमेल पता डालें. इसके बाद, सेव करें पर क्लिक करें.
- ऑडियंस पेज पर जाएं और उपयोगकर्ता का टाइप को बाहरी पर सेट करें.
- उसी पेज पर, टेस्ट करने वाले उपयोगकर्ता में जाकर, उपयोगकर्ता जोड़ें पर क्लिक करें. इसके बाद, अपना Google ईमेल पता डालें और सेव करें पर क्लिक करें.
- Clients पेज पर जाएं.
Create client पर क्लिक करें. इसके बाद, वह ऐप्लिकेशन टाइप चुनें जिसकी ज़रूरत आपके एमसीपी क्लाइंट को है:
- डेस्कटॉप क्लाइंट के लिए डेस्कटॉप ऐप्लिकेशन चुनें. ये क्लाइंट, क्लाइंट आईडी और सीक्रेट (जैसे, VS Code) के लिए प्रॉम्प्ट करते हैं.
- वेब ऐप्लिकेशन चुनें और अपने क्लाइंट का रीडायरेक्ट यूआरआई जोड़ें. यह उन क्लाइंट के लिए ज़रूरी है जिन्हें स्टैटिक OAuth रीडायरेक्ट कॉलबैक की ज़रूरत होती है. जैसे, Cursor या Claude Code के कस्टम कनेक्टर. उसी रीडायरेक्ट यूआरआई का इस्तेमाल करें जो आपके क्लाइंट के दस्तावेज़ों में मौजूद है. कस्टम रीडायरेक्ट यूआरआई का इस्तेमाल नहीं किया जा सकता. क्लाइंट के हिसाब से रीडायरेक्ट यूआरआई के लिए, एआई ऐप्लिकेशन में एमसीपी को कॉन्फ़िगर करना लेख पढ़ें.
- Create पर क्लिक करें. इसके बाद, अपना Client ID और Client secret कॉपी करें या JSON क्लाइंट क्रेडेंशियल फ़ाइल डाउनलोड करें.
OAuth के दायरे
डेवलपर नॉलेज एमसीपी सर्वर, इन OAuth स्कोप को स्वीकार करता है:
https://www.googleapis.com/auth/cloud-platform: यह डिफ़ॉल्ट स्कोप है. इसका इस्तेमाल ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (एडीसी) और gcloud सीएलआई करते हैं.https://www.googleapis.com/auth/devprofiles.full_control: इस स्कोप का इस्तेमाल, OAuth 2.0 क्लाइंट आईडी के लिए सहमति लेने वाले फ़्लो और एमसीपी सर्वर की खोज के लिए किया जाता है.https://www.googleapis.com/auth/developerprofiles.readonly: रीड-ओनली स्कोप, उन सेवा खातों और क्रेडेंशियल के लिए काम करता है जिनके लिए एंड-यूज़र OAuth सहमति स्क्रीन की ज़रूरत नहीं होती.
अपने आईडीई या कोडिंग एजेंट को कॉन्फ़िगर करना
अपने क्रेडेंशियल पाने के बाद, अपने कोडिंग एनवायरमेंट के लिए सेटअप करने के निर्देशों का पालन करें. हर कोडिंग एनवायरमेंट के लिए दिए गए निर्देशों में, पुष्टि करने के इन तरीकों के बारे में बताया गया है:
| कोडिंग एनवायरमेंट | पुष्टि करने के तरीके |
|---|---|
| Google Antigravity | पहले से मौजूद Google क्रेडेंशियल (एडीसी) या एपीआई पासकोड |
| Claude Code, Cursor, GitHub Copilot, Codex | एपीआई पासकोड |
| अन्य | एपीआई पासकोड, एडीसी धारक टोकन या OAuth 2.0 क्लाइंट आईडी |
Claude Code, Cursor, GitHub Copilot या Codex के साथ एडीसी धारक टोकन या OAuth 2.0 क्लाइंट आईडी का इस्तेमाल करने के लिए, अन्य टैब में दिए गए निर्देशों का पालन करें.
इस्तेमाल किए जा रहे टेंप्लेट के हिसाब से, इन प्लेसहोल्डर को बदलें:
- एपीआई पासकोड (
YOUR_API_KEY): इसे अपने रॉ एपीआई पासकोड की स्ट्रिंग से बदलें. - प्रोजेक्ट आईडी (
PROJECT_ID): इसे अपने Google Cloud प्रोजेक्ट आईडी से बदलें. ऐक्सेस टोकन (
ACCESS_TOKEN): इसेgcloud auth application-default print-access-tokenसे मिले बियरर टोकन से बदलें.
Google Antigravity
Antigravity IDE और एक्सटेंशन
Antigravity IDE या Antigravity एक्सटेंशन (जैसे, VS Code) में एमसीपी सर्वर को कॉन्फ़िगर करने के लिए, पुष्टि करने का तरीका चुनें:
Google क्रेडेंशियल
एक क्लिक में सेटअप करने की सुविधा का इस्तेमाल करके, एमसीपी सर्वर इंस्टॉल करने के लिए:
- एजेंट पैनल में, ज़्यादा विकल्प () मेन्यू पर क्लिक करें. इसके बाद, एमसीपी सर्वर को चुनें.
- Google Developer Knowledge खोजें.
- इंस्टॉल करें () आइकॉन पर क्लिक करें. Antigravity, सर्वर को अपने-आप कॉन्फ़िगर करता है और आपके चालू Google क्रेडेंशियल का इस्तेमाल करके कनेक्ट करता है.
एपीआई पासकोड
Antigravity IDE या Antigravity एक्सटेंशन में एपीआई पासकोड कॉन्फ़िगर करने के लिए:
- एजेंट पैनल में, ज़्यादा विकल्प
() मेन्यू >
एमसीपी सर्वर > एमसीपी सर्वर मैनेज करें > रॉ कॉन्फ़िगरेशन देखें पर क्लिक करें
(या
.agents/mcp_config.jsonखोलें). सर्वर का यह कॉन्फ़िगरेशन जोड़ें:
{ "mcpServers": { "google-developer-knowledge": { "serverUrl": "https://developerknowledge.googleapis.com/mcp", "headers": { "X-Goog-Api-Key": "YOUR_API_KEY" } } } }
Antigravity CLI
अपने प्रोजेक्ट की .agents/mcp_config.json फ़ाइल में एमसीपी सर्वर को कॉन्फ़िगर करें. इसके अलावा, इसे ~/.gemini/config/mcp_config.json में भी कॉन्फ़िगर किया जा सकता है:
Google क्रेडेंशियल
{
"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"
}
}
}
}
Claude Code
अपने टर्मिनल में यह कमांड चलाएं:
claude mcp add google-developer-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
Workspace की सेटिंग
किसी खास फ़ाइल फ़ोल्डर के लिए, 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 फ़ाइल फ़ोल्डर में उपलब्ध कराने के लिए, कमांड पैलेट खोलें. इसके बाद, MCP: Open User Configuration को चलाएं और अपनी उपयोगकर्ता की प्रोफ़ाइल में मौजूद mcp.json फ़ाइल में यह जोड़ें:
{
"servers": {
"google-developer-knowledge": {
"url": "https://developerknowledge.googleapis.com/mcp",
"headers": {
"X-Goog-Api-Key": "YOUR_API_KEY"
}
}
}
}
Codex
Codex CLI या Codex एजेंट को कॉन्फ़िगर करने के लिए, सर्वर कॉन्फ़िगरेशन को ~/.codex/config.toml (या अपने प्रोजेक्ट के .codex/config.toml) में जोड़ें:
[mcp_servers.google-developer-knowledge]
url = "https://developerknowledge.googleapis.com/mcp"
http_headers = { "X-Goog-Api-Key" = "YOUR_API_KEY" }
अन्य
किसी अन्य रिमोट एमसीपी क्लाइंट (जैसे, JetBrains AI Assistant, Windsurf, Cline, Zed, Continue या Claude Desktop) को कॉन्फ़िगर करने के लिए या तीसरे पक्ष के क्लाइंट में एडीसी बेयरर टोकन या OAuth 2.0 क्लाइंट आईडी का इस्तेमाल करने के लिए, पुष्टि करने का तरीका चुनें:
एपीआई पासकोड
एचटीटीपी ट्रांसपोर्ट सर्वर को इन सेटिंग के साथ कॉन्फ़िगर करें:
- सर्वर का यूआरएल:
https://developerknowledge.googleapis.com/mcp - एचटीटीपी हेडर:
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"
}
}
}
}
एडीसी धारक टोकन
अगर आपके एमसीपी क्लाइंट में एडीसी की सुविधा पहले से मौजूद नहीं है, तो एडीसी की मदद से पुष्टि की जा सकती है. इसके लिए, अनुरोध हेडर में gcloud auth application-default print-access-token से बियरर टोकन और Google Cloud प्रोजेक्ट का आईडी पास करें:
{
"mcpServers": {
"google-developer-knowledge": {
"url": "https://developerknowledge.googleapis.com/mcp",
"headers": {
"Authorization": "Bearer ACCESS_TOKEN",
"X-Goog-User-Project": "PROJECT_ID"
}
}
}
}
X-Goog-User-Project हेडर के लिए, प्रोजेक्ट पर serviceusage.services.use अनुमति की ज़रूरत होती है. प्रोजेक्ट के मालिकों और एडिटर के पास यह अनुमति होती है. अन्य उपयोगकर्ताओं को ऐसी भूमिका की ज़रूरत होती है जिसमें यह शामिल हो. जैसे, सेवा उपयोग के उपभोक्ता (roles/serviceusage.serviceUsageConsumer).
OAuth क्लाइंट आईडी
स्टैंडअलोन OAuth 2.0 क्लाइंट आईडी और सीक्रेट का इस्तेमाल करके पुष्टि करने के लिए:
एपीआई पासकोड हेडर के बिना, एमसीपी सर्वर के एंडपॉइंट को अपने क्लाइंट कॉन्फ़िगरेशन में जोड़ें:
{ "mcpServers": { "google-developer-knowledge": { "url": "https://developerknowledge.googleapis.com/mcp" } } }अपने क्लाइंट के लिए OAuth सेटअप करें:
- इंटरैक्टिव प्रॉम्प्ट (जैसे, VS Code): एजेंट को टेस्ट प्रॉम्प्ट भेजें. जब आपको यह सूचना मिले कि Dynamic Client Registration की सुविधा काम नहीं करती, तो आगे बढ़ें और अपना क्लाइंट आईडी और क्लाइंट सीक्रेट डालें. इसके बाद, अपने Google खाते से साइन इन करें.
- स्टैटिक OAuth कॉन्फ़िगरेशन (जैसे, Cursor या Claude Code): अपने क्लाइंट की OAuth सेटिंग में, OAuth क्लाइंट आईडी, क्लाइंट सीक्रेट, और रीडायरेक्ट यूआरआई दें. क्लाइंट के हिसाब से निर्देश पाने के लिए, एआई ऐप्लिकेशन में एमसीपी को कॉन्फ़िगर करना लेख पढ़ें.
अगर आपका क्लाइंट आपसे OAuth के दायरे तय करने के लिए कहता है, तो
https://www.googleapis.com/auth/devprofiles.full_controlका इस्तेमाल करें.
इस कॉन्फ़िगरेशन में, आपको Google Cloud प्रोजेक्ट आईडी डालने की ज़रूरत नहीं है. अनुरोधों को उस प्रोजेक्ट से एट्रिब्यूट किया जाता है जिसके पास आपका OAuth क्लाइंट आईडी होता है.
कनेक्शन की पुष्टि करना
कॉन्फ़िगर करने के बाद, एआई असिस्टेंट को रीस्टार्ट करें या उसके एमसीपी सर्वर फिर से लोड करें. इसके बाद, टूल इंटिग्रेशन की पुष्टि करने के लिए, एक टेस्ट प्रॉम्प्ट भेजें:
How do I list Cloud Storage buckets using the Google Cloud Python SDK?
अगर एजेंट search_documents या answer_query को शुरू करता है और Google के दस्तावेज़ से जानकारी दिखाता है, तो इसका मतलब है कि आपका सर्वर कनेक्ट है और चालू है.
डेवलपर नॉलेज एजेंट स्किल का इस्तेमाल करना
आधिकारिक retrieving-developer-knowledge एजेंट स्किल इंस्टॉल करें, ताकि आपके असिस्टेंट को यह पता चल सके कि Developer Knowledge एमसीपी सर्वर से मिलने वाले मुख्य टूल का इस्तेमाल कब और कैसे करना है.
एजेंट स्किल, निर्देशों का एक सेट होता है. कोडिंग में मदद करने वाला आपका एआई असिस्टेंट, कोई टास्क शुरू करने से पहले इन निर्देशों को पढ़ता है. retrieving-developer-knowledge स्किल, ऐसे किसी भी असिस्टेंट के साथ काम करती है जो ओपन एजेंट स्किल स्टैंडर्ड के साथ काम करता है. साथ ही, यह आपकी असिस्टेंट को ये काम करने में मदद करता है:
- सही टूल चुनना: इससे आपकी Assistant को यह पता चलता है कि
answer_queryका इस्तेमाल "कैसे करें" से जुड़े सामान्य सवालों और तुलनाओं के लिए करना है. साथ ही,search_documentsका इस्तेमाल (दो से पाँच फ़ोकस किए गए कीवर्ड के साथ) तब करना है, जब सटीक सीएलआई फ़्लैग, आईएएम अनुमतियाँ या कोड सिंटैक्स खोजनी हो. - जवाब देने से पहले गड़बड़ियों की जांच करें: इससे आपके असिस्टेंट को यह पक्का करने के लिए कहा जाता है कि जवाब लिखने से पहले, दस्तावेज़ की खोज वाकई पूरी हो गई हो. इससे, एपीआई पासकोड या कोटा से जुड़ी गड़बड़ी को दस्तावेज़ न होने की गड़बड़ी समझने की गलती नहीं होती. इसके अलावा, पुराने ट्रेनिंग डेटा से अनुमान लगाने की ज़रूरत नहीं पड़ती.
- REST API का इस्तेमाल करना: अगर आपका एडिटर, एमसीपी सर्वर के साथ काम नहीं करता है या एमसीपी कनेक्शन काम नहीं करता है, तो यह आपके असिस्टेंट को
curlनिर्देश देता है, ताकि वह Developer Knowledge API को सीधे कॉल कर सके.
एजेंट की स्किल इंस्टॉल करना
अपनी प्रोजेक्ट डायरेक्ट्री में retrieving-developer-knowledge स्किल इंस्टॉल करने के लिए, कोडिंग में मदद चुनें:
Google Antigravity
npx skills add google/skills --skill retrieving-developer-knowledge \
--agent=antigravity
Claude Code
npx skills add google/skills --skill retrieving-developer-knowledge \
--agent=claude-code
कर्सर
npx skills add google/skills --skill retrieving-developer-knowledge \
--agent=cursor
Codex
npx skills add google/skills --skill retrieving-developer-knowledge \
--agent=codex
अन्य
एजेंट की क्षमताओं के लिए ओपन स्टैंडर्ड का इस्तेमाल करने वाले अन्य एआई असिस्टेंट के लिए, यह कमांड चलाएं:
npx skills add google/skills --skill retrieving-developer-knowledge
इंस्टॉल की गई स्किल को नए वर्शन में अपडेट करने के लिए, यह कमांड चलाएं:
npx skills update
स्किल से जुड़े सभी निर्देश और रेफ़रंस गाइड देखने के लिए, GitHub पर retrieving-developer-knowledge डायरेक्ट्री देखें.
कॉन्टेक्स्ट विंडो और टोकन के इस्तेमाल को ऑप्टिमाइज़ करना
एआई मॉडल की कॉन्टेक्स्ट विंडो में पूरे दस्तावेज़ के पेजों को वापस लाने में, काफ़ी टोकन खर्च होते हैं. कई बड़े दस्तावेज़ों को अपलोड करने से, टोकन की लागत बढ़ सकती है, इंतज़ार का समय बढ़ सकता है, और कॉन्टेक्स्ट विंडो ओवरफ़्लो हो सकती है.
जवाबों को तेज़ी से और कम खर्च में पाने के लिए, प्रॉम्प्ट इंजीनियरिंग के इन सबसे सही तरीकों को अपनाएं:
एजेंट स्किल इंस्टॉल करें (सुझाया गया):
retrieving-developer-knowledgeएजेंट स्किल इंस्टॉल करें, ताकि आपका असिस्टेंट अपने-आप सही सर्च टूल (answer_queryयाsearch_documents) चुन सके. साथ ही, छोटे कीवर्ड सर्च का इस्तेमाल कर सके और सिर्फ़ ज़रूरत पड़ने पर पूरे पेज डाउनलोड कर सके.दो चरणों में जानकारी पाने की सुविधा का इस्तेमाल करें: इससे एजेंट,
search_documentsको कॉल करके बातचीत शुरू कर पाएगा. इससे फ़ोकस किए गए स्निपेट (टुकड़े) मिलते हैं. इनमें अक्सर वही सिंटैक्स या एपीआई सिग्नेचर होता है जिसकी आपको ज़रूरत होती है. इसके लिए, पूरे पेज के टोकन इस्तेमाल नहीं करने पड़ते. अपने एजेंट को निर्देश दें कि वहget_documentsको सिर्फ़ तब कॉल करे, जब आस-पास की जानकारी देना बहुत ज़रूरी हो.कॉन्सेप्ट से जुड़े सवालों के लिए
answer_queryका इस्तेमाल करें: जब आपको जनरेट की गई जानकारी या डिज़ाइन की तुलना करनी हो, तो अपने एजेंट कोanswer_queryका इस्तेमाल करने के लिए कहें. यह टूल, डेवलपर नॉलेज कॉर्पस से सीधे जवाब जनरेट करता है. इसमें पूरे रॉ मार्कडाउन पेज नहीं दिखाए जाते.किसी खास विषय के बारे में प्रॉम्प्ट लिखें: ऐसे प्रॉम्प्ट लिखने से बचें जिनमें बहुत ज़्यादा जानकारी मांगी गई हो. जैसे, "Firebase के बारे में पूरी जानकारी दो". इसके बजाय, टारगेट किए गए प्रॉडक्ट, प्लैटफ़ॉर्म, और भाषा के बारे में बताएं:
How do I write a Firestore transaction in Dart with error handling?एजेंट के लिए कस्टम नियम जोड़ें: अगर
retrieving-developer-knowledgeस्किल का इस्तेमाल नहीं किया जा रहा है, तो अपने असिस्टेंट के निर्देश वाली फ़ाइलों (उदाहरण के लिए,.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.
सुरक्षा और सुरक्षित रहने से जुड़े वैकल्पिक कॉन्फ़िगरेशन
एमसीपी टूल की मदद से कई तरह की कार्रवाइयां की जा सकती हैं. इसलिए, एमसीपी से सुरक्षा से जुड़े नए जोखिम और समस्याएं पैदा हो सकती हैं. इन जोखिमों को कम करने और मैनेज करने के लिए, Google Cloud डिफ़ॉल्ट सेटिंग और पसंद के मुताबिक बनाई जा सकने वाली नीतियां उपलब्ध कराता है. इनकी मदद से, Google Cloud संगठन या प्रोजेक्ट में एमसीपी टूल के इस्तेमाल को कंट्रोल किया जा सकता है.
एमसीपी की सुरक्षा और गवर्नेंस के बारे में ज़्यादा जानने के लिए, एआई की सुरक्षा और बचाव लेख पढ़ें.
Model Armor का इस्तेमाल करना
Model Armor, Google Cloud की एक सेवा है. इसे आपके एआई ऐप्लिकेशन की सुरक्षा को बेहतर बनाने के लिए डिज़ाइन किया गया है. यह एलएलएम के प्रॉम्प्ट और जवाबों की पहले से ही जांच करता है. इससे, अलग-अलग जोखिमों से सुरक्षा मिलती है और रिस्पॉन्सिबल एआई के सिद्धांतों का पालन करने में मदद मिलती है. चाहे एआई को अपने क्लाउड एनवायरमेंट में डिप्लॉय किया जा रहा हो या बाहरी क्लाउड प्रोवाइडर पर, Model Armor आपको नुकसान पहुंचाने वाले इनपुट को रोकने, कॉन्टेंट की सुरक्षा की पुष्टि करने, संवेदनशील डेटा को सुरक्षित रखने, नियमों का पालन करने, और एआई की सुरक्षा और सुरक्षा से जुड़ी नीतियों को लगातार लागू करने में मदद कर सकता है.
जब Model Armor को लॉगिंग चालू है के साथ चालू किया जाता है, तो Model Armor पूरे पेलोड को लॉग करता है. इससे आपके लॉग में मौजूद संवेदनशील जानकारी का पता चल सकता है.
एमसीपी अनुरोध को Model Armor पर रूट किया जा रहा है
Model Armor कुछ इलाकों में उपलब्ध है. अगर Model Armor की सुविधा चालू है और आपने किसी ऐसे देश या इलाके में एमसीपी सर्वर का इस्तेमाल किया है जहाँ Model Armor की सुविधा काम नहीं करती, तो कॉल को रूट करने का तरीका अलग-अलग एमसीपी सर्वर के लिए अलग-अलग हो सकता है. साथ ही, इस्तेमाल किए जा रहे और ट्रांसफ़र किए जा रहे डेटा के लिए, डेटा रेज़िडेंसी के नियमों का पालन नहीं किया जा सकता. अलग-अलग एमसीपी सर्वर के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, Model Armor के साथ काम करने वाले प्रॉडक्ट देखें.Model Armor को चालू करना
Model Armor को चालू करने के लिए, Google और Google Cloud के एमसीपी सर्वर के साथ इंटिग्रेट करें में दिया गया तरीका अपनाएं.
रिमोट एमसीपी सर्वर के लिए सुरक्षा कॉन्फ़िगर करना
एमसीपी टूल को किए गए कॉल और उनसे मिले जवाबों को सुरक्षित रखने के लिए, Model Armor की फ़्लोर सेटिंग का इस्तेमाल किया जा सकता है. फ़्लोर सेटिंग से, प्रोजेक्ट पर लागू होने वाले सुरक्षा फ़िल्टर की कम से कम संख्या तय होती है. यह कॉन्फ़िगरेशन, प्रोजेक्ट में मौजूद सभी एमसीपी टूल कॉल और जवाबों पर फ़िल्टर का एक जैसा सेट लागू करता है.
एमसीपी सैनिटाइज़ेशन की सुविधा चालू करके, Model Armor के लिए फ़्लोर सेटिंग सेट अप करें. ज़्यादा जानकारी के लिए, Model Armor की फ़्लोर सेटिंग कॉन्फ़िगर करना लेख पढ़ें.
उदाहरण के तौर पर दिया गया यह निर्देश देखें:
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 की जगह अपना Google Cloud प्रोजेक्ट आईडी डालें.
इन सेटिंग का ध्यान रखें:
INSPECT_AND_BLOCK: नीति उल्लंघन ठीक करने का ऐसा तरीका जो Google एमसीपी सर्वर के लिए कॉन्टेंट की जांच करता है. साथ ही, फ़िल्टर से मैच होने वाले प्रॉम्प्ट और जवाबों को ब्लॉक करता है.ENABLED: वह सेटिंग जो किसी फ़िल्टर या नीति उल्लंघन ठीक करने के तरीके को चालू करती है.MEDIUM_AND_ABOVE: ज़िम्मेदार एआई - खतरनाक कॉन्टेंट के लिए फ़िल्टर की सेटिंग के लिए कॉन्फ़िडेंस लेवल. इस सेटिंग में बदलाव किया जा सकता है. हालांकि, कम वैल्यू सेट करने पर, सुरक्षित साइटों को असुरक्षित बताने की ज़्यादा गलतियां हो सकती हैं. ज़्यादा जानकारी के लिए, Model Armor के कॉन्फ़िडेंस लेवल देखें.
Model Armor की मदद से, एमसीपी ट्रैफ़िक को स्कैन करने की सुविधा बंद करना
प्रोजेक्ट की फ़्लोर सेटिंग के आधार पर, 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 की जगह Google Cloud प्रोजेक्ट आईडी डालें. Model Armor, इस प्रोजेक्ट की फ़्लोर सेटिंग में तय किए गए नियमों को Google के किसी भी एमसीपी सर्वर ट्रैफ़िक पर अपने-आप लागू नहीं करता.
Model Armor की फ़्लोर सेटिंग और सामान्य कॉन्फ़िगरेशन का असर, एमसीपी के अलावा अन्य चीज़ों पर भी पड़ सकता है. Model Armor, Vertex AI जैसी सेवाओं के साथ इंटिग्रेट होता है. इसलिए, फ़्लोर सेटिंग में किए गए किसी भी बदलाव का असर, इंटिग्रेट की गई सभी सेवाओं में ट्रैफ़िक स्कैनिंग और सुरक्षा से जुड़े व्यवहार पर पड़ सकता है. यह असर सिर्फ़ एमसीपी पर नहीं पड़ता.
मॉडल आर्मर की सेटिंग में बदलाव करना
अगर अपने ऐप्लिकेशन को सुरक्षित रखने के लिए Model Armor का इस्तेमाल किया जा रहा है, तो आपको कुछ क्वेरी के लिए 403 PERMISSION_DENIED गड़बड़ियां दिख सकती हैं. डेवलपर नॉलेज एमसीपी सर्वर, Google के भरोसेमंद सोर्स से सिर्फ़ सार्वजनिक दस्तावेज़ दिखाता है. इसलिए, हमारा सुझाव है कि आप प्रॉम्प्ट इंजेक्शन और जेलब्रेक (पीआईजे़बी) फ़िल्टर को HIGH_AND_ABOVE कॉन्फ़िडेंस लेवल पर सेट करें, ताकि फ़ॉल्स पॉज़िटिव को कम किया जा सके.
अगर आपके इस्तेमाल के उदाहरण में निजी या संवेदनशील डेटा को ऐक्सेस करने वाले अन्य टूल शामिल नहीं हैं, तो पीआईजेबी फ़िल्टर बंद किए जा सकते हैं.
समस्या का हल
अगर आपको Developer Knowledge के एमसीपी सर्वर से कनेक्ट करने या उसमें क्वेरी करने में समस्याएं आ रही हैं, तो यहां दी गई टेबल में अपनी समस्या या गड़बड़ी का मैसेज ढूंढें.
सेटअप और कनेक्शन से जुड़ी गड़बड़ियां
| समस्या या गड़बड़ी | संभावित वजह | रिज़ॉल्यूशन |
|---|---|---|
/mcp एंडपॉइंट पर 404 NOT_FOUND |
आपके प्रोजेक्ट के लिए, एपीआई चालू नहीं है. |
Google Cloud Console में जाकर, Developer Knowledge API को चालू करें या gcloud services enable developerknowledge.googleapis.com चलाएं.
|
403 PERMISSION_DENIED:
Developer Knowledge API has not been used
|
Google Cloud प्रोजेक्ट में Developer Knowledge API चालू नहीं है. |
Google Cloud Console में जाकर एपीआई को चालू करें या gcloud services enable developerknowledge.googleapis.com चलाएं.
|
| एमसीपी टूल मौजूद नहीं हैं या कनेक्शन नहीं हो पा रहा है | आपका कोडिंग टूल, रिमोट एचटीटीपी एमसीपी सर्वर के साथ काम नहीं करता या सर्वर से कनेक्ट नहीं हो सकता. |
retrieving-developer-knowledge एजेंट स्किल इंस्टॉल करें. इससे आपके असिस्टेंट को पता चलता है कि एमसीपी टूल उपलब्ध न होने पर, curl का इस्तेमाल करके Developer Knowledge API के REST एंडपॉइंट पर कैसे वापस जाना है.
|
एपीआई पासकोड से जुड़ी गड़बड़ियां
| समस्या या गड़बड़ी | संभावित वजह | रिज़ॉल्यूशन |
|---|---|---|
400 Bad Request: API key not valid |
एपीआई पासकोड की स्ट्रिंग मौजूद नहीं है, अमान्य है या गलत है. |
पुष्टि करें कि एपीआई पासकोड को सही तरीके से कॉपी किया गया हो. साथ ही, उसे X-Goog-Api-Key कुंजी के साथ headers ऑब्जेक्ट में कॉन्फ़िगर किया गया हो.
एपीआई पासकोड को यूआरएल में क्वेरी पैरामीटर के तौर पर पास न करें.
|
403 PERMISSION_DENIED: API target restriction |
एपीआई पासकोड से जुड़ी पाबंदियों की सूची में, Developer Knowledge API शामिल नहीं है. | Google Cloud Console के क्रेडेंशियल पेज पर जाकर, एपीआई पासकोड से जुड़ी पाबंदियों को अपडेट करें, ताकि Developer Knowledge API को शामिल किया जा सके. |
OAuth और एडीसी से जुड़ी गड़बड़ियां
| समस्या या गड़बड़ी | संभावित वजह | रिज़ॉल्यूशन |
|---|---|---|
401 UNAUTHENTICATED या एडीसी क्रेडेंशियल मौजूद नहीं हैं |
ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल या एडीसी धारक टोकन की समयसीमा खत्म हो गई है या उन्हें शुरू नहीं किया गया है. |
लोकल क्रेडेंशियल रीफ़्रेश करने के लिए, gcloud auth application-default login --project=PROJECT_ID चलाएं या नया धारक टोकन जनरेट करने के लिए, gcloud auth application-default print-access-token चलाएं.
|
403 PERMISSION_DENIED:
API requires a quota project, which is not set by default
|
अनुरोध में, X-Goog-User-Project हेडर के बिना एडीसी धारक टोकन का इस्तेमाल किया गया है.
|
अपने एमसीपी क्लाइंट कॉन्फ़िगरेशन में, X-Goog-User-Project हेडर के साथ अपना Google Cloud प्रोजेक्ट आईडी जोड़ें.
|
403 PERMISSION_DENIED में X-Goog-User-Project हेडर मौजूद है
|
आपके खाते के पास, हेडर में मौजूद प्रोजेक्ट के लिए serviceusage.services.use
की अनुमति नहीं है.
|
प्रोजेक्ट एडमिन से कहें कि वह आपको सेवा उपयोग के उपभोक्ता की भूमिका (roles/serviceusage.serviceUsageConsumer) असाइन करे.
|
403 access_denied /
"ऐक्सेस ब्लॉक किया गया: अनुमति देने में गड़बड़ी हुई"
|
OAuth के लिए सहमति देने वाली स्क्रीन, टेस्टिंग मोड में बाहरी उपयोगकर्ता टाइप का इस्तेमाल करती है. साथ ही, आपका खाता टेस्ट उपयोगकर्ता के तौर पर सूची में शामिल नहीं है. | Google Cloud console > Auth Platform > ऑडियंस में जाकर, टेस्ट उपयोगकर्ता में अपना ऐक्टिव Google ईमेल पता जोड़ें. |
| OAuth क्लाइंट से जुड़ी गड़बड़ी या अमान्य रीडायरेक्ट यूआरआई | OAuth क्लाइंट को ऐसे ऐप्लिकेशन टाइप के साथ बनाया गया था जो काम नहीं करता या रीडायरेक्ट यूआरआई मौजूद नहीं है. | इंटरैक्टिव प्रॉम्प्ट वाले क्लाइंट (जैसे, VS Code) के लिए, डेस्कटॉप ऐप्लिकेशन का इस्तेमाल करें. इसके अलावा, अपने क्लाइंट के लिए अनुमति पा चुके रीडायरेक्ट यूआरआई (जैसे, Cursor या Claude Code) के साथ वेब ऐप्लिकेशन का इस्तेमाल करें. |
कोटा और सुरक्षा फ़िल्टर से जुड़ी गड़बड़ियां
| समस्या या गड़बड़ी | संभावित वजह | रिज़ॉल्यूशन |
|---|---|---|
429 RESOURCE_EXHAUSTED |
आपने अपने प्रोजेक्ट के लिए तय कोटा पूरा कर लिया है. | Google Cloud Console में, Developer Knowledge API के कोटे वाले पेज पर जाकर, अपने इस्तेमाल की जानकारी देखें. सीमाओं के बारे में जानने और उन्हें बढ़ाने का अनुरोध करने के लिए, Developer Knowledge API का कोटा लेख पढ़ें. |
Model Armor के साथ 403 PERMISSION_DENIED |
Model Armor के PIJB फ़िल्टर ने, सुरक्षित क्वेरी को गलत तरीके से ब्लॉक कर दिया. |
Model Armor टेंप्लेट की सेटिंग में, PIJB फ़िल्टर के कॉन्फ़िडेंस लेवल को HIGH_AND_ABOVE पर सेट करें.
|
शामिल दस्तावेज़
Google के उन सभी प्रॉडक्ट और दस्तावेज़ों की पूरी सूची देखने के लिए, कॉर्पस रेफ़रंस देखें जिन्हें सर्वर ने इंडेक्स किया है.
सीमाएं
- सिर्फ़ सार्वजनिक दस्तावेज़: सर्वर सिर्फ़ सार्वजनिक तौर पर उपलब्ध उन दस्तावेज़ों को इंडेक्स करता है जो कॉर्पस रेफ़रंस में मौजूद हैं. इसमें संगठन के अंदरूनी दस्तावेज़, निजी रिपॉज़िटरी, और तीसरे पक्ष के संसाधन शामिल नहीं होते.
- अंग्रेज़ी भाषा: सर्वर, दस्तावेज़ को सिर्फ़ अंग्रेज़ी में इंडेक्स करता है और दिखाता है.
- नेटवर्क की निर्भरता और वीपीसी सर्विस कंट्रोल: DeveloperKnowledge एमसीपी सर्वर, रिमोट होस्ट की गई सेवा है. इसलिए, आपके क्लाइंट के पास
https://developerknowledge.googleapis.comतक पहुंचने के लिए नेटवर्क कनेक्टिविटी होनी चाहिए.- Google Cloud वीपीसी नेटवर्क के अंदर: पब्लिक इंटरनेट इग्रेस की ज़रूरत नहीं होती. प्राइवेट Google ऐक्सेस (
private.googleapis.com/199.36.153.8/30) याall-apisबंडल को टारगेट करने वाले Private Service Connect (पीएससी) एंडपॉइंट का इस्तेमाल करके, ट्रैफ़िक को रूट किया जा सकता है. इससे, बाहरी आईपी पतों या Cloud NAT के बिना, निजी तौर परdeveloperknowledge.googleapis.comको ऐक्सेस किया जा सकता है. - वीपीसी सर्विस कंट्रोल (वीपीसी-एससी):
developerknowledge.googleapis.comयह प्रतिबंधित वीआईपी (restricted.googleapis.com/199.36.153.4/30) या पीएससीvpc-scएंडपॉइंट पर काम नहीं करता. अगर आपका वीपीसी,*.googleapis.comकोrestricted.googleapis.comपर रूट करता है, तोdeveloperknowledge.googleapis.comके लिए Cloud DNS की रिस्पॉन्स पॉलिसी या निजी डीएनएस रिकॉर्ड को कॉन्फ़िगर करें, ताकिprivate.googleapis.com(199.36.153.8/30) को रिज़ॉल्व किया जा सके.
- Google Cloud वीपीसी नेटवर्क के अंदर: पब्लिक इंटरनेट इग्रेस की ज़रूरत नहीं होती. प्राइवेट Google ऐक्सेस (