خادم Gorbit MCP - Gorbit Documentation

نظرة عامة

يتيح خادم Gorbit MCP لأي عميل LLM متوافق مع MCP (Claude Desktop، Claude Code، Cursor، Windsurf، إلخ) الوصول إلى قاعدة معرفة Gorbit، والبحث على الويب، وإمكانيات جلب عناوين URL من خلال بروتوكول سياق النموذج.

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

قبل الاتصال، ستحتاج إلى:

مثيل Gorbit قيد التشغيل (إما مستضاف ذاتيًا أو Gorbit Cloud)
المصادقة — راجع رموز الوصول الشخصية أو مفاتيح API
عميل متوافق مع MCP (Claude Desktop، Claude Code، Cursor، إلخ)

تكوين خادم MCP المستضاف ذاتيًا

انتقل إلى متغيرات البيئة، والشبكات، وإعدادات النشر لخادم MCP المستضاف ذاتيًا

البداية السريعة

Claude Code (CLI)

claude mcp add --transport http gorbit https://cloud.gorbit.app/mcp \
  --header "Authorization: Bearer YOUR_GORBIT_TOKEN_HERE"

أو أضفه إلى ملف .mcp.json الخاص بمشروعك:

{
  "mcpServers": {
    "gorbit": {
      "type": "http",
      "url": "https://cloud.gorbit.app/mcp",
      "headers": {
        "Authorization": "Bearer ${GORBIT_TOKEN}"
      }
    }
  }
}

ثم اضبط متغير البيئة قبل تشغيل Claude Code:

export GORBIT_TOKEN="your-token-here"
claude

Claude Desktop

أضف ما يلي إلى ملف تكوين Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gorbit": {
      "url": "https://cloud.gorbit.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GORBIT_TOKEN_HERE"
      }
    }
  }
}

استبدل https://cloud.gorbit.app/mcp بـ http://YOUR_GORBIT_DOMAIN:8090/ إذا كنت تستضيف ذاتيًا.

Cursor / Windsurf / عملاء MCP الآخرون

تدعم معظم عملاء MCP نقل HTTP مع رؤوس مخصصة. تفاصيل الاتصال هي:

الإعداد	القيمة
URL	`https://cloud.gorbit.app/mcp` (أو `http://YOUR_DOMAIN:8090/`)
Transport	HTTP (Streamable HTTP)
Auth Header	`Authorization: Bearer YOUR_TOKEN`

راجع وثائق MCP الخاصة بعميلك للخطوات الدقيقة للتكوين.

الأدوات المتاحة

يعرض خادم MCP ثلاث أدوات يمكن لعملاء LLM استدعاؤها:

search_indexed_documents

ابحث في قاعدة المعرفة الخاصة بك المفهرسة في Gorbit. يعيد قطع مستندات مرتبة بالمحتوى، ودرجات الصلة، والبيانات الوصفية.المعاملات:

المعامل	النوع	مطلوب	الافتراضي	الوصف
`query`	string	نعم	—	استعلام بحث باللغة الطبيعية
`source_types`	string[]	لا	جميع المصادر	تصفية حسب نوع الموصل (مثلاً `["confluence", "github", "jira"]`)
`time_cutoff`	string	لا	لا قطع	تاريخ ووقت ISO 8601 — إرجاع المستندات المحدثة بعد هذا الوقت فقط
`limit`	integer	لا	`10`	الحد الأقصى لعدد النتائج للإرجاع

مثال استدعاء:

{
  "query": "What is the latest status of PROJ-1234?",
  "source_types": ["jira", "google_drive"],
  "time_cutoff": "2025-01-01T00:00:00Z",
  "limit": 5
}

حقول الاستجابة:

الحقل	الوصف
`documents`	مصفوفة كائنات النتائج
`documents[].semantic_identifier`	اسم المستند القابل للقراءة
`documents[].content`	مقطع نصي ذو صلة
`documents[].source_type`	مصدر الموصل (مثلاً `"confluence"`)
`documents[].link`	رابط إلى المستند الأصلي
`documents[].score`	درجة الصلة
`total_results`	عدد النتائج المرجعة
`query`	الاستعلام الأصلي
`executed_queries`	قائمة الاستعلامات المنفذة فعليًا (قد تشمل توسيعات)

لاكتشاف أنواع المصادر المتاحة، استخدم مورد indexed_sources (انظر أدناه).

search_web

ابحث في الإنترنت العام للمعرفة العامة والأحداث الجارية.المعاملات:

المعامل	النوع	مطلوب	الافتراضي	الوصف
`query`	string	نعم	—	استعلام البحث
`limit`	integer	لا	`5`	الحد الأقصى لعدد النتائج

مثال استدعاء:

{
  "query": "React 19 migration guide",
  "limit": 5
}

حقول الاستجابة:

الحقل	الوصف
`results`	مصفوفة نتائج بحث الويب
`results[].title`	عنوان الصفحة
`results[].url`	رابط الصفحة
`results[].snippet`	مقطع نصي قصير
`query`	الاستعلام الأصلي

search_web يعيد مقاطع، لا محتوى الصفحة الكامل. استخدم open_urls لجلب النص الكامل لأي نتيجة.

open_urls

استرجع محتوى النص الكامل من رابط ويب واحد أو أكثر.المعاملات:

المعامل	النوع	مطلوب	الوصف
`urls`	string[]	نعم	قائمة عناوين URL للجلب

مثال استدعاء:

{
  "urls": [
    "https://react.dev/blog/2024/12/05/react-19",
    "https://react.dev/learn/react-compiler"
  ]
}

حقول الاستجابة:

الحقل	الوصف
`results`	مصفوفة الصفحات المجلوبة
`results[].title`	عنوان الصفحة
`results[].url`	الرابط المجلوب
`results[].content`	محتوى النص المستخرج الكامل

الموارد المتاحة

indexed_sources

URI: resource://indexed_sourcesيسرد جميع أنواع موصلات المستندات المفهرسة حاليًا في مثيل Gorbit (مثلاً "confluence"، "github"، "google_drive"، "slack").استخدم هذا لاكتشاف القيم الصالحة لفلتر source_types في search_indexed_documents.مثال استجابة:

{
  "indexed_sources": ["confluence", "github", "google_drive", "jira", "slack"]
}

تكوين الاستضافة الذاتية

لاستضافة خادم MCP ذاتيًا، ستحتاج إلى تفعيل النشر عبر متغيرات البيئة. Docker:

.env

MCP_SERVER_ENABLED=true

Kubernetes:

values.yaml

configMap:
  MCP_SERVER_ENABLED: "true"

فحص الصحة

تحقق من أن خادم MCP يعمل:

curl http://localhost:8090/health # أو http://YOUR_DOMAIN:8090/health

الاستجابة المتوقعة:

{
  "status": "healthy",
  "service": "mcp_server"
}

متغيرات البيئة

معظم المستخدمين لا ينبغي أن يحتاجوا لتكوين متغيرات البيئة هذه.

المتغير	الافتراضي	الوصف
`MCP_SERVER_ENABLED`	`false`	اضبط على `"true"` لتفعيل خادم MCP
`MCP_SERVER_HOST`	`0.0.0.0`	المضيف لربط خادم MCP
`MCP_SERVER_PORT`	`8090`	منفذ خادم MCP
`MCP_SERVER_CORS_ORIGINS`	(فارغ)	قائمة مفصولة بفواصل لأصول CORS المسموح بها
`API_SERVER_PROTOCOL`	`http`	البروتوكول لاتصال خادم API الداخلي
`API_SERVER_HOST`	`127.0.0.1`	اسم المضيف لاتصال خادم API الداخلي
`API_SERVER_URL_OVERRIDE_FOR_HTTP_REQUESTS`	(غير محدد)	تجاوز رابط كامل لخادم API. استخدم هذا عند استضافة خادم MCP ذاتيًا مقابل Gorbit Cloud

التصحيح والاختبار

فاحص MCP

فاحص MCP هو أداة تصحيح تفاعلية لخوادم MCP:

npx @modelcontextprotocol/inspector

الإعداد في الفاحص:

تجاهل قوائم تكوين OAuth
افتح تبويب Authentication
اختر مصادقة Bearer Token
الصق رمز Gorbit PAT أو مفتاح API
انقر Connect

بمجرد الاتصال، يمكنك تصفح الأدوات، واختبار الاستدعاءات بمعاملات مختلفة، وفحص حمولات الطلب/الاستجابة.

الخطوات التالية

رموز الوصول الشخصية

أنشئ رمزًا للمصادقة مع خادم MCP

مفاتيح API

أنشئ مفاتيح API مشتركة لوصول MCP على مستوى الفريق

الموصلات

أضف مصادر بيانات لجعل معرفتك قابلة للبحث عبر MCP

إجراءات MCP

اربط Gorbit بخوادم MCP الخارجية كعميل

​نظرة عامة

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

تكوين خادم MCP المستضاف ذاتيًا

​البداية السريعة

​Claude Code (CLI)

​Claude Desktop

​Cursor / Windsurf / عملاء MCP الآخرون

​الأدوات المتاحة

​الموارد المتاحة

​تكوين الاستضافة الذاتية

​فحص الصحة

​متغيرات البيئة

​التصحيح والاختبار

​فاحص MCP

​الخطوات التالية

رموز الوصول الشخصية

مفاتيح API

الموصلات

إجراءات MCP

نظرة عامة

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

البداية السريعة

Claude Code (CLI)

Claude Desktop

Cursor / Windsurf / عملاء MCP الآخرون

الأدوات المتاحة

الموارد المتاحة

تكوين الاستضافة الذاتية

فحص الصحة

متغيرات البيئة

التصحيح والاختبار

فاحص MCP

الخطوات التالية