الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

يتيح خادم 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 مع رؤوس مخصصة. تفاصيل الاتصال هي:
الإعدادالقيمة
URLhttps://cloud.gorbit.app/mcp (أو http://YOUR_DOMAIN:8090/)
TransportHTTP (Streamable HTTP)
Auth HeaderAuthorization: Bearer YOUR_TOKEN
راجع وثائق MCP الخاصة بعميلك للخطوات الدقيقة للتكوين.

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

يعرض خادم MCP ثلاث أدوات يمكن لعملاء LLM استدعاؤها:
ابحث في قاعدة المعرفة الخاصة بك المفهرسة في Gorbit. يعيد قطع مستندات مرتبة بالمحتوى، ودرجات الصلة، والبيانات الوصفية.المعاملات:
المعاملالنوعمطلوبالافتراضيالوصف
querystringنعم—استعلام بحث باللغة الطبيعية
source_typesstring[]لاجميع المصادرتصفية حسب نوع الموصل (مثلاً ["confluence", "github", "jira"])
time_cutoffstringلالا قطعتاريخ ووقت ISO 8601 — إرجاع المستندات المحدثة بعد هذا الوقت فقط
limitintegerلا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 (انظر أدناه).
ابحث في الإنترنت العام للمعرفة العامة والأحداث الجارية.المعاملات:
المعاملالنوعمطلوبالافتراضيالوصف
querystringنعم—استعلام البحث
limitintegerلا5الحد الأقصى لعدد النتائج
مثال استدعاء:
{
  "query": "React 19 migration guide",
  "limit": 5
}
حقول الاستجابة:
الحقلالوصف
resultsمصفوفة نتائج بحث الويب
results[].titleعنوان الصفحة
results[].urlرابط الصفحة
results[].snippetمقطع نصي قصير
queryالاستعلام الأصلي
search_web يعيد مقاطع، لا محتوى الصفحة الكامل. استخدم open_urls لجلب النص الكامل لأي نتيجة.
استرجع محتوى النص الكامل من رابط ويب واحد أو أكثر.المعاملات:
المعاملالنوعمطلوبالوصف
urlsstring[]نعمقائمة عناوين URL للجلب
مثال استدعاء:
{
  "urls": [
    "https://react.dev/blog/2024/12/05/react-19",
    "https://react.dev/learn/react-compiler"
  ]
}
حقول الاستجابة:
الحقلالوصف
resultsمصفوفة الصفحات المجلوبة
results[].titleعنوان الصفحة
results[].urlالرابط المجلوب
results[].contentمحتوى النص المستخرج الكامل

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

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_ENABLEDfalseاضبط على "true" لتفعيل خادم MCP
MCP_SERVER_HOST0.0.0.0المضيف لربط خادم MCP
MCP_SERVER_PORT8090منفذ خادم MCP
MCP_SERVER_CORS_ORIGINS(فارغ)قائمة مفصولة بفواصل لأصول CORS المسموح بها
API_SERVER_PROTOCOLhttpالبروتوكول لاتصال خادم API الداخلي
API_SERVER_HOST127.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 الخارجية كعميل