تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

الربط بخادم MCP الخاص بـ "قاعدة معلومات المطوّرين"

يمنح خادم بروتوكول سياق النموذج (MCP) في Google Developer Knowledge أدوات التطوير المستندة إلى الذكاء الاصطناعي إمكانية الوصول المباشر إلى مستندات المطوّرين الرسمية من Google لمنتجات مثل Firebase وGoogle Cloud وAndroid ومنصة خرائط Google والمزيد. من خلال ربط مساعدك في كتابة الرموز البرمجية بمكتبة مستندات Google الموثوقة، يمكنك تجنُّب عمليات البحث اليدوية على الويب والسياق القديم وعمليات جمع البيانات.

إمكانات خادم MCP

يوفّر خادم بروتوكول سياق النموذج (MCP) في Google Developer Knowledge ثلاثة أدوات أساسية لمساعدك في كتابة الرموز البرمجية المستند إلى الذكاء الاصطناعي:

اسم الأداة	الوصف
`search_documents`	تبحث في مستندات المطوّرين من Google وتعرض مقتطفات الصفحات الأكثر صلة إلى جانب أسماء مستنداتها.
`get_documents`	تسترد محتوى Markdown الكامل للمستندات باستخدام الأسماء التي تعرضها `search_documents`.
`answer_query`	تنشئ إجابات منظَّمة ومُركَّبة تستند إلى مجموعة بيانات Developer Knowledge.

تبحث أداة search_documents في مستندات Google للعثور على الأقسام الأكثر صلة بطلب بحثك. عندما تطرح سؤالاً، تعرض الأداة مقاطع نصية قصيرة. إذا كان الوكيل بحاجة إلى سياق الصفحة الكامل المحيط بمقطع معيّن، يمكنه تمرير اسم مورد المستند إلى get_documents لاسترداد الصفحة بأكملها.

استخدِم أداة answer_query عندما تريد الحصول على إجابة مباشرة لسؤال تم تركيبها من مجموعة بيانات Developer Knowledge بدلاً من نتائج البحث الأولية أو ملفات Markdown الكاملة.

اختيار طريقة المصادقة

يتيح خادم بروتوكول سياق النموذج (MCP) في Developer Knowledge طريقتَي مصادقة، وذلك حسب بيئة التطوير ومساعد الذكاء الاصطناعي:

مفتاح واجهة برمجة التطبيقات: هو الخيار الأفضل لبيئات التطوير المتكاملة (IDE) التابعة لجهات خارجية ووكلاء واجهة سطر الأوامر (CLI)، مثل Claude Code، Cursor وGitHub Copilot وCodex وعملاء MCP الآخرين عن بُعد. مرِّر مفتاح واجهة برمجة التطبيقات في عنوان X-Goog-Api-Key عبر HTTPS.
OAuth وبيانات الاعتماد التلقائية للتطبيق: هو الخيار الأفضل لـ Google Antigravity أو مهام سير العمل المؤسسية التي تستخدم بيانات الاعتماد التلقائية للتطبيق (ADC) أو معرّف عميل OAuth 2.0 مستقل.

أنشئ بيانات الاعتماد المطلوبة لطريقة المصادقة التي اخترتها للسماح لمساعد الذكاء الاصطناعي أو وكيل كتابة الرموز البرمجية بمصادقة الطلبات باستخدام خدمة خادم بروتوكول سياق النموذج (MCP) في Developer Knowledge.

اختَر علامة تبويب لإنشاء بيانات الاعتماد:

مفتاح واجهة برمجة التطبيقات

المتطلبات الأساسية

قبل إنشاء مفتاح واجهة برمجة التطبيقات، تأكَّد من توفُّر ما يلي:

مشروع على Google Cloud.
واجهة سطر الأوامر gcloud CLI مثبَّتة (في حال الإعداد من سطر الأوامر)

تفعيل واجهة برمجة التطبيقات وإنشاء مفتاح لها

يمكنك إنشاء مفتاح واجهة برمجة التطبيقات باستخدام Google Cloud Console أو gcloud CLI:

Google Cloud Console

افتح صفحة Developer Knowledge API في Google Cloud Console.
اختَر مشروعك على Google Cloud وانقر على تفعيل.
انتقِل إلى صفحة بيانات الاعتماد.
انقر على إنشاء بيانات اعتماد واختَر مفتاح واجهة برمجة التطبيقات.
انقر على إجراء تعديل مفتاح واجهة برمجة التطبيقات لضبط القيود:
- ضمن قيود واجهة برمجة التطبيقات، اختَر تقييد المفتاح.
- اختَر Developer Knowledge API.
- إذا كنت تخطط لاستخدام هذا المفتاح نفسه لطلبات النماذج (مثل GEMINI_API_KEY)، اختَر أيضًا Generative Language API.
انقر على حفظ، ثم انسخ مفتاح واجهة برمجة التطبيقات.

gcloud CLI

فعِّل 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.com
```
ملاحظة مهمة: إذا كنت تخطط لاستخدام هذا المفتاح نفسه لطلبات النموذج العامة في عميل الذكاء الاصطناعي (مثلاً، GEMINI_API_KEY)، عليك أيضًا السماح باستخدام Generative Language API:
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com \
  --api-target=service=generativelanguage.googleapis.com
```

OAuth وبيانات الاعتماد التلقائية للتطبيق

المتطلبات الأساسية

قبل ضبط OAuth، تأكَّد من توفُّر ما يلي:

تفعيل واجهة برمجة التطبيقات

نفِّذ الأمر التالي لتفعيل Developer Knowledge API في مشروعك:

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

اختيار نوع بيانات اعتماد OAuth

اختَر طريقة بيانات الاعتماد التي تتطلبها أداتك:

بيانات الاعتماد التلقائية للتطبيق

إذا كان مساعد الذكاء الاصطناعي يتيح بيانات الاعتماد التلقائية للتطبيق (مثل Google Antigravity):

صادِق تسجيل الدخول باستخدام حساب Google واضبط مشروع الحصة:
```
gcloud auth application-default login \
  --project=PROJECT_ID
```
عند فتح المتصفّح، سجِّل الدخول باستخدام حساب Google وامنح الأذونات المطلوبة.

معرِّف عميل OAuth

إذا كان مساعد الذكاء الاصطناعي يتطلب معرّف عميل OAuth وسرًا مستقلَين:

افتح شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
اضبط نوع المستخدم على خارجي، وأدخِل اسم التطبيق وعنوان البريد الإلكتروني للدعم المطلوبَين ، وانقر على حفظ ومتابعة.
في صفحة الجمهور، انقر على إضافة مستخدمين ضمن المستخدمون التجريبيون، وأدخِل عنوان بريدك الإلكتروني على Google، وانقر على حفظ.
انتقِل إلى صفحة العملاء، وانقر على إنشاء عميل، واضبط نوع التطبيق على تطبيق سطح المكتب.
انقر على إنشاء، ثم نزِّل ملف بيانات اعتماد عميل JSON.

ضبط بيئة التطوير المتكاملة أو وكيل كتابة الرموز البرمجية

بعد الحصول على بيانات الاعتماد، اختَر بيئة كتابة الرموز البرمجية المفضّلة لعرض تعليمات الإعداد.

استنادًا إلى طريقة المصادقة التي اخترتها، استبدِل العناصر النائبة في نماذج الإعدادات على النحو التالي:

المصادقة باستخدام مفتاح واجهة برمجة التطبيقات: استبدِل YOUR_API_KEY بـ سلسلة مفتاح واجهة برمجة التطبيقات الأولية.
المصادقة باستخدام OAuth أو بيانات الاعتماد التلقائية للتطبيق: استبدِل PROJECT_ID برقم تعريف مشروعك على Google Cloud:

Google Antigravity

بيئة Antigravity IDE والإضافات

لضبط خادم MCP في بيئة Antigravity IDE أو إضافة Antigravity (مثل VS Code)، اختَر طريقة المصادقة:

بيانات اعتماد Google

لتثبيت خادم MCP باستخدام الإعداد بنقرة واحدة:

في لوحة "الوكيل"، انقر على قائمة خيارات إضافية () واختَر خوادم MCP.
ابحث عن Google Developer Knowledge.
انقر على رمز تثبيت (). تضبط Antigravity الخادم تلقائيًا وتتصل به باستخدام بيانات اعتماد Google النشطة.

مفتاح واجهة برمجة التطبيقات

لضبط مفتاح واجهة برمجة التطبيقات في بيئة Antigravity IDE أو إضافة Antigravity:

في لوحة "الوكيل"، انقر على قائمة خيارات إضافية () > خوادم MCP > إدارة خوادم MCP > عرض الإعدادات الأولية (أو افتح .agents/mcp_config.json).

أضِف إعدادات الخادم التالية:

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

Antigravity CLI

اضبط خادم MCP في .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-dev-knowledge \
  --transport http https://developerknowledge.googleapis.com/mcp \
  --header "X-Goog-Api-Key: YOUR_API_KEY"

المؤشر

لضبط المؤشر، عدِّل .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

إعدادات مساحة العمل

لضبط GitHub Copilot في VS Code لمساحة عمل معيّنة، أنشئ أو عدِّل .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

لضبط 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"
      }
    }
  }
}

غير ذلك

لضبط أي عميل MCP آخر عن بُعد (مثل JetBrains AI Assistant أو Windsurf أو Cline أو Zed أو Continue أو Claude Desktop)، اضبط خادم نقل HTTP باستخدام الإعدادات التالية:

عنوان URL للخادم: 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"
      }
    }
  }
}

التحقق من الاتصال

بعد الضبط، أعِد تشغيل مساعد الذكاء الاصطناعي أو أعِد تحميل خوادم MCP. بعد ذلك، أرسِل طلبًا تجريبيًا للتحقّق من أنّ عملية دمج الأداة تعمل:

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

إذا استدعى الوكيل search_documents أو answer_query وعرض معلومات من مستندات Google، يعني ذلك أنّ الخادم متصل ونشط.

تحسين قدرة الاستيعاب واستخدام الرموز المميّزة

يؤدي استرداد صفحات المستندات الكاملة إلى قدرة استيعاب نموذج الذكاء الاصطناعي إلى استهلاك عدد كبير من الرموز المميّزة. ويمكن أن يؤدي إدخال مستندات كبيرة متعددة إلى ارتفاع تكاليف الرموز المميّزة وزيادة وقت الاستجابة وتجاوز قدرة الاستيعاب.

لضمان الحصول على استجابات سريعة وفعّالة من حيث التكلفة، اتّبِع أفضل الممارسات التالية في هندسة الطلبات:

الاعتماد على الاسترداد على خطوتَين: اطلب من الوكيل البدء باستدعاء search_documents. يعرض هذا الأمر مقتطفات مركّزة (أجزاء) تحتوي غالبًا على البنية الدقيقة أو توقيع واجهة برمجة التطبيقات التي تحتاج إليها بدون استهلاك الرموز المميّزة للصفحة بأكملها. اطلب من الوكيل استدعاء get_documents فقط عندما يكون السياق المحيط ضروريًا للغاية.
تفضيل answer_query للأسئلة المفاهيمية: عندما تحتاج إلى شرح مُركَّب أو مقارنة تصميم، اطلب من الوكيل استخدام answer_query. تُركِّب هذه الأداة إجابة مباشرةً من مجموعة بيانات Developer Knowledge بدون عرض صفحات Markdown الأولية الكاملة.
كتابة طلبات محدّدة وضيقة النطاق: تجنَّب الطلبات الواسعة النطاق، مثل "اشرح كل Firebase". بدلاً من ذلك، حدِّد المنتج والمنصة واللغة المستهدَفة:
```
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.
```

إعدادات الأمان والحماية الاختيارية

يُقدّم بروتوكول سياق النموذج (MCP) مخاطر واعتبارات أمان جديدة بسبب المجموعة الواسعة من الإجراءات التي يمكنك تنفيذها باستخدام أدوات MCP. للحدّ من هذه المخاطر وإدارتها، توفّر Google Cloud إعدادات تلقائية وسياسات قابلة للتخصيص للتحكّم في استخدام أدوات MCP في مؤسستك أو مشروعك على Google Cloud.

لمزيد من المعلومات حول أمان MCP وحوكمته، يُرجى الاطّلاع على الأمان والحماية في الذكاء الاصطناعي.

استخدام Model Armor

Model Armor هي خدمة من Google Cloud مصمّمة لتعزيز أمان تطبيقات الذكاء الاصطناعي و حمايتها. تعمل هذه الخدمة من خلال الفحص الاستباقي لطلبات النماذج والاستجابات في النماذج اللغوية الكبيرة (LLM)، ما يحمي من المخاطر المختلفة ويدعم ممارسات الذكاء الاصطناعي المسؤول. سواء كنت تنشر الذكاء الاصطناعي في بيئتك السحابية أو على موفّري خدمات سحابية خارجيين، يمكن أن يساعدك Model Armor في منع الإدخالات الضارة والتحقّق من سلامة المحتوى وحماية البيانات الحسّاسة والحفاظ على الامتثال وفرض سياسات الأمان والحماية في الذكاء الاصطناعي بشكلٍ متّسق في جميع جوانب الذكاء الاصطناعي المتنوعة.

عند تفعيل Model Armor مع تفعيل ميزة تسجيل البيانات، تسجِّل الخدمة الحمولة الكاملة. قد يؤدي ذلك إلى كشف معلومات حسّاسة في سجلّاتك.

توجيه طلبات MCP إلى Model Armor

تتوفّر خدمة Model Armor في مناطق معيّنة. عند تفعيل Model Armor واستخدام خادم MCP في نطاق قانوني لا يتيح Model Armor استخدامه، قد يختلف سلوك توجيه المكالمة باختلاف خوادم MCP وقد يؤدي إلى إيقاف الامتثال لقواعد الإقامة الجغرافية للبيانات للبيانات قيد الاستخدام والبيانات قيد النقل. لمزيد من المعلومات حول سلوك خوادم MCP الفردية، يُرجى الاطّلاع على المنتجات المتوافقة مع Model Armor.

تفعيل Model Armor

اتّبِع الخطوات الواردة في دمج خوادم MCP من Google وGoogle Cloud لتفعيل Model Armor.

ضبط الحماية لخوادم MCP عن بُعد

للمساعدة في حماية طلبات أدوات MCP والاستجابات، يمكنك استخدام إعدادات الحد الأدنى في Model Armor. يحدّد إعداد الحد الأدنى فلاتر الأمان الدنيا التي يتم تطبيقها على مستوى المشروع. يطبّق هذا الإعداد مجموعة متّسقة من الفلاتر على جميع طلبات أدوات MCP والاستجابات ضِمن المشروع.

اضبط إعداد الحد الأدنى في Model Armor مع تفعيل ميزة التنظيف في MCP. لمزيد من المعلومات، يُرجى الاطّلاع على ضبط إعدادات الحد الأدنى في 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 برقم تعريف مشروعك .

لاحظ الإعدادات التالية:

INSPECT_AND_BLOCK: هو نوع التنفيذ الذي يفحص المحتوى لخادم MCP من Google ويحظر الطلبات والاستجابات التي تطابق الفلاتر.
ENABLED: هو الإعداد الذي يفعِّل فلترًا أو عملية تنفيذ.
MEDIUM_AND_ABOVE: هو مستوى الثقة لإعدادات فلتر "الذكاء الاصطناعي المسؤول - المحتوى الخطير". يمكنك تعديل هذا الإعداد، ولكن قد تؤدي القيم المنخفضة إلى المزيد من النتائج الإيجابية الخاطئة. لمزيد من المعلومات، يُرجى الاطّلاع على مستويات الثقة في Model Armor.

إيقاف فحص زيارات MCP باستخدام Model Armor

لمنع Model Armor من فحص الزيارات تلقائيًا من خوادم MCP من Google وإليها استنادًا إلى إعدادات الحد الأدنى للمشروع، نفِّذ الأمر التالي:

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

استبدِل PROJECT_ID برقم تعريف المشروع . لا يطبّق Model Armor تلقائيًا القواعد المحدّدة في إعدادات الحد الأدنى لهذا المشروع على أي زيارات لخادم MCP من Google.

يمكن أن تؤثر إعدادات الحد الأدنى في Model Armor والإعدادات العامة في أكثر من مجرد MCP. بما أنّ Model Armor يتكامل مع خدمات مثل Vertex AI، يمكن أن تؤثر أي تغييرات تجريها على إعدادات الحد الأدنى في فحص الزيارات وسلوكيات الأمان في جميع الخدمات المتكاملة، وليس فقط MCP.

ضبط إعدادات Model Armor

إذا كنت تستخدم Model Armor لحماية تطبيقك، قد تظهر لك أخطاء 403 PERMISSION_DENIED لبعض طلبات البحث. بما أنّ خادم بروتوكول سياق النموذج (MCP) في Developer Knowledge لا يعرض إلا المستندات العلنية من مصادر Google الموثوق بها، ننصحك بضبط فلاتر إدخال الطلبات والهروب من القيود على مستويات ثقة HIGH_AND_ABOVE لتقليل النتائج الإيجابية الخاطئة. إذا لم يكن استخدامك يتضمّن أدوات أخرى تصل إلى بيانات خاصة أو حسّاسة، يمكنك أيضًا إيقاف فلاتر إدخال الطلبات والهروب من القيود.

تحديد المشاكل وحلّها

إذا واجهت مشاكل في الاتصال بخادم بروتوكول سياق النموذج (MCP) في Developer Knowledge أو إرسال طلبات بحث إليه، يُرجى الرجوع إلى مصفوفة تحديد المشاكل وحلّها وخطوات الحلّ التالية:

مصفوفة تحديد المشاكل وحلّها

العَرَض أو الخطأ	السبب المحتمل	الحلّ
`400 Bad Request: API key not valid`	سلسلة مفتاح واجهة برمجة التطبيقات مفقودة أو غير صالحة أو غير مكتملة.	تأكَّد من نسخ مفتاح واجهة برمجة التطبيقات بشكلٍ صحيح وضبطه في عنصر `headers` باستخدام المفتاح `X-Goog-Api-Key`.
`403 PERMISSION_DENIED`: `Developer Knowledge API has not been used`	لم يتم تفعيل Developer Knowledge API في مشروع Google Cloud مشروع.	فعِّل واجهة برمجة التطبيقات في Google Cloud Console أو نفِّذ `gcloud services enable developerknowledge.googleapis.com`.
`403 PERMISSION_DENIED: API target restriction`	تستبعد قائمة القيود المفروضة على مفتاح واجهة برمجة التطبيقات Developer Knowledge API.	عدِّل القيود المفروضة على مفتاح واجهة برمجة التطبيقات في صفحة بيانات الاعتماد في Google Cloud Console لتضمين Developer Knowledge API.
`401 UNAUTHENTICATED` أو بيانات اعتماد بيانات الاعتماد التلقائية للتطبيق مفقودة	انتهت صلاحية بيانات الاعتماد التلقائية للتطبيق أو لم تتم تهيئتها.	نفِّذ `gcloud auth application-default login --project=PROJECT_ID` لإعادة تحميل بيانات الاعتماد المحلية.
`403 access_denied` / "تم حظر إمكانية الوصول: خطأ في منح الإذن"	لم يتم إدراج حسابك كمستخدم تجريبي مُصرَّح له في طلب الموافقة المتعلّقة ببروتوكول OAuth.	في Google Cloud Console > منصة المصادقة > الجمهور، أضِف عنوان بريدك الإلكتروني ضِمن المستخدمون التجريبيون.
خطأ في عميل OAuth أو عنوان URI لإعادة التوجيه غير صالح	تم إنشاء عميل OAuth بنوع تطبيق غير متوافق.	أعِد إنشاء معرّف عميل OAuth مع ضبط النوع على تطبيق سطح المكتب.
`404 NOT_FOUND` على نقطة النهاية `/mcp`	لم يتم تفعيل واجهة برمجة التطبيقات لمشروعك.	فعِّل Developer Knowledge API في Google Cloud Console أو نفِّذ `gcloud services enable developerknowledge.googleapis.com`.
`429 RESOURCE_EXHAUSTED`	لقد بلغت الحدّ الأقصى المسموح به لحصة مشروعك.	تحقَّق من استخدام حصة Developer Knowledge API في وحدة التحكّم واطلب زيادة في الحصة إذا لزم الأمر.
`403 PERMISSION_DENIED` مع Model Armor	حظر فلتر إدخال الطلبات والهروب من القيود في Model Armor طلبًا آمنًا نتيجةً لنتيجة إيجابية خاطئة.	اضبط مستوى الثقة في فلتر إدخال الطلبات والهروب من القيود على `HIGH_AND_ABOVE` في إعدادات نموذج Model Armor.

حلّ أخطاء المصادقة والموافقة

إعداد عنوان مفتاح واجهة برمجة التطبيقات: تأكَّد من أنّ إعدادات JSON في MCP تتضمّن قسم headers مع "X-Goog-Api-Key". لا تمرِّر مفتاح واجهة برمجة التطبيقات كمَعلمة طلب بحث في عنوان URL.
المستخدمون التجريبيون في شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth: عند إنشاء عميل OAuth لسطح المكتب في مشروع بنوع مستخدم خارجي في وضع الاختبار، تحظر Google الوصول إلى الحسابات غير المُدرَجة ضِمن المستخدمين التجريبيين. تأكَّد من إضافة عنوان بريدك الإلكتروني النشط على Google ضِمن الجمهور > المستخدمون التجريبيون في Google Cloud Console.
الحصص والحدود القصوى للطلبات: لمراقبة استخدامك اليومي واستخدامك لكل دقيقة، انتقِل إلى إدارة الهوية وإمكانية الوصول والمشرف > الحصص والحدود القصوى للنظام في Google Cloud Console و فلتر حسب Developer Knowledge API.

المستندات المضمّنة

يُرجى الاطّلاع على مرجع مجموعة البيانات للاطّلاع على القائمة الكاملة بمنتجات Google ومستودعات المستندات التي يفهرسها الخادم.

القيود المعروفة

المستندات العلنية فقط: لا يفهرس الخادم إلا المستندات المتاحة للجميع والمُدرَجة في مرجع مجموعة البيانات. لا يتم تضمين المستندات الداخلية والمستودعات الخاصة والموارد التابعة لجهات خارجية.
اللغة الإنجليزية: يفهرس الخادم المستندات ويعرضها بـ اللغة الإنجليزية فقط.
الاعتماد على الشبكة: يتطلب الخادم اتصالاً نشطًا بالإنترنت للوصول إلى https://developerknowledge.googleapis.com.

الربط بخادم MCP الخاص بـ "قاعدة معلومات المطوّرين" تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

إمكانات خادم MCP

اختيار طريقة المصادقة

مفتاح واجهة برمجة التطبيقات

المتطلبات الأساسية

تفعيل واجهة برمجة التطبيقات وإنشاء مفتاح لها

Google Cloud Console

gcloud CLI

OAuth وبيانات الاعتماد التلقائية للتطبيق

المتطلبات الأساسية

تفعيل واجهة برمجة التطبيقات

اختيار نوع بيانات اعتماد OAuth

بيانات الاعتماد التلقائية للتطبيق

معرِّف عميل OAuth

ضبط بيئة التطوير المتكاملة أو وكيل كتابة الرموز البرمجية

Google Antigravity

بيئة Antigravity IDE والإضافات

بيانات اعتماد Google

مفتاح واجهة برمجة التطبيقات

Antigravity CLI

بيانات اعتماد Google

مفتاح واجهة برمجة التطبيقات

Claude Code

المؤشر

GitHub Copilot

إعدادات مساحة العمل

إعدادات المستخدم على مستوى العالم

Codex

غير ذلك

التحقق من الاتصال

تحسين قدرة الاستيعاب واستخدام الرموز المميّزة

إعدادات الأمان والحماية الاختيارية

استخدام Model Armor

توجيه طلبات MCP إلى Model Armor

تفعيل Model Armor

ضبط الحماية لخوادم MCP عن بُعد

إيقاف فحص زيارات MCP باستخدام Model Armor

ضبط إعدادات Model Armor

تحديد المشاكل وحلّها

مصفوفة تحديد المشاكل وحلّها

حلّ أخطاء المصادقة والموافقة

المستندات المضمّنة

القيود المعروفة

الربط بخادم MCP الخاص بـ "قاعدة معلومات المطوّرين"