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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يمكنك إنشاء مفتاح واجهة برمجة تطبيقات باستخدام وحدة تحكّم Google Cloud أو 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...). عليك لصق هذه القيمة في إعدادات بيئة التطوير المتكاملة (IDE).
- 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 وADC

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

قبل إعداد 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 أو ADC: استبدِل 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-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

لضبط 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.toml (أو .codex/config.toml مشروعك):

[mcp_servers.google-developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  http_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.
```

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

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

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

استخدام Model Armor

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

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

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

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

تفعيل Model Armor

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

ضبط إعدادات الحماية لخوادم MCP البعيدة

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

اضبط إعداد الحد الأدنى في Model Armor مع تفعيل ميزة تنظيف MCP. لمزيد من المعلومات، يُرجى الاطّلاع على ضبط إعدادات Model Armor floor.

اطّلِع على مثال الأمر التالي:

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

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

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

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

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

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

ضبط إعدادات "درع النموذج"

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

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

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

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

المشكلة أو الخطأ	السبب المحتمل	الدقة
`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 لتضمين Developer Knowledge API.
`401 UNAUTHENTICATED` أو بيانات اعتماد ADC غير متوفّرة	انتهت صلاحية بيانات الاعتماد التلقائية للتطبيق أو لم يتم إعدادها.	نفِّذ الأمر `gcloud auth application-default login --project=PROJECT_ID` لإعادة تحميل بيانات الاعتماد المحلية.
`403 access_denied` / "تم حظر إمكانية الوصول: خطأ في منح الإذن"	لم يتم إدراج حسابك كمستخدم تجريبي معتمَد في الموافقة المتعلّقة ببروتوكول OAuth.	في وحدة تحكّم Google Cloud > منصة المصادقة > الجمهور، أضِف عنوان بريدك الإلكتروني ضمن المستخدمون التجريبيون.
خطأ في عميل 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 PIJB إلى حظر طلب بحث آمن.	اضبط مستوى الثقة في فلتر معلومات تحديد الهوية الشخصية (PII) ومعلومات تحديد الاهتمامات (PIB) على `HIGH_AND_ABOVE` في إعدادات نموذج Model Armor.

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

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

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

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

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

المستندات المتاحة للجميع فقط: يفهرس الخادم المستندات المتاحة للجميع فقط والمدرَجة في مرجع مجموعة المستندات. لا يتم تضمين المستندات الداخلية والمستودعات الخاصة والمراجع التابعة لجهات خارجية.
اللغة الإنجليزية: يفهرس الخادم المستندات ويعرضها باللغة الإنجليزية فقط.
الاعتماد على الشبكة وعناصر التحكّم في خدمة VPC: بما أنّ خادم Developer Knowledge MCP هو خدمة مستضافة عن بُعد، يجب أن يكون لدى العميل اتصال بالشبكة للوصول إلى https://developerknowledge.googleapis.com.
- داخل شبكات السحابة الافتراضية الخاصة (VPC) في Google Cloud: لا يلزم الخروج إلى الإنترنت المتاح للجميع. يمكنك الوصول إلى developerknowledge.googleapis.com بشكل خاص بدون عناوين IP خارجية أو Cloud NAT من خلال توجيه الزيارات باستخدام الوصول الخاص إلى Google (private.googleapis.com / 199.36.153.8/30) أو نقطة نهاية Private Service Connect (PSC) تستهدف حزمة all-apis.
- عناصر التحكّم في خدمة سحابة VPC: developerknowledge.googleapis.com لا تتوافق مع نقاط نهاية Restricted VIP (restricted.googleapis.com / 199.36.153.4/30) أو PSC vpc-sc. إذا كانت مسارات شبكة VPC توجّه *.googleapis.com إلى restricted.googleapis.com، عليك إعداد سياسة استجابة Cloud DNS أو سجلّ نظام أسماء نطاقات خاص محدّدَين لكي يتم حلّ developerknowledge.googleapis.com إلى private.googleapis.com (199.36.153.8/30).

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

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

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

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

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

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

Google Cloud Console

gcloud CLI

OAuth وADC

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

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

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

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

معرِّف عميل OAuth

ضبط إعدادات بيئة التطوير المتكاملة أو وكيل الترميز

Google Antigravity

‫Antigravity IDE والإضافات

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

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

Antigravity CLI

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

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

Claude Code

المؤشر

GitHub Copilot

إعدادات Workspace

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

Codex

غير ذلك

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

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

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

استخدام Model Armor

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

تفعيل Model Armor

ضبط إعدادات الحماية لخوادم MCP البعيدة

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

ضبط إعدادات "درع النموذج"

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

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

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

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

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

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