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

نظرة عامة على MCP

يتيح بروتوكول MCP (Model Context Protocol) لأدوات المحادثة الذكية الاتصال بخدمات خارجية. يوفّر Orki خادمَي MCP، فيقدر مساعدك يقرأ الوثائق ويشغّل مساحة عملك في نفس الوقت.

الخادمما الذي يقدّمهالمصادقة
Orki Docsإجابات عن Orki مبنية على هذه الوثائقلا تحتاج
Orki Appحسابك الفعلي — الوكلاء والعملاء والحملات والأدوات وغيرهامطلوبة

خادم الوثائق أسرع شيء تضبطه، وهو الأجدر بالبداية: بدل ما تبحث في الوثائق، تسأل مساعدك ويجاوبك مع الإشارة للصفحة الصحيحة.

Orki Docs MCP​

اسأل عن Orki واحصل على إجابات مستخرجة من هذه الوثائق، مع روابط للصفحات المصدر.

  • الرابط: https://orki.ai/docs-mcp
  • النقل: Streamable HTTP
  • بدون مصادقة

الأدوات: docs_search (البحث عن الصفحات ذات الصلة) وdocs_fetch (قراءة صفحة كاملة).

Orki App MCP​

أدر حساب Orki عبر المحادثة الذكية. مجموعات الأدوات تغطي الوكلاء والتحليلات وأدوات API وموفّري المصادقة والفوترة والمحادثات والعملاء والتكاملات وقواعد المعرفة والتسويق والمنتجات وأحداث النظام والوسوم وإعدادات المؤسسة ومسارات العمل.

  • الرابط: https://app.orki.ai/services/mcp
  • النقل: Streamable HTTP
  • يتطلب مصادقة
المصادقة

يستخدم App MCP مصادقة OAuth. عند الاتصال، يفتح عميل MCP نافذة متصفح — سجّل الدخول بحساب Orki الخاص بك ويتولى العميل الباقي. معرّف عميل OAuth هو orki-mcp.

أول خطوة مع App MCP

بعد الاتصال، اطلب من المساعد عرض مؤسساتك ثم اختيار واحدة. الأدوات الخاصة بالمؤسسة ما تظهر إلا بعد اختيارها.

الإعداد​

Claude Desktop​

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) أو %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "orki-docs": {
      "type": "http",
      "url": "https://orki.ai/docs-mcp"
    },
    "orki-app": {
      "type": "http",
      "url": "https://app.orki.ai/services/mcp",
      "oauth": {
        "clientId": "orki-mcp"
      }
    }
  }
}

Cursor​

.cursor/mcp.json في جذر مشروعك — نفس الكتلة أعلاه.

Windsurf​

~/.codeium/windsurf/mcp_config.json — نفس الكتلة أعلاه.

Claude Code (CLI)​

claude mcp add --transport http orki-docs https://orki.ai/docs-mcp
claude mcp add --transport http orki-app  https://app.orki.ai/services/mcp

ماذا تسأله​

ما تريدهالخادممثال للسؤال
تتعلم ميزةDocs«كيف أنشئ حملة؟»
تلقى الإعداد الصحيحDocs«وين أفعّل إخفاء البيانات الشخصية؟»
تفهم تكاملاًDocs«وش تسوي مواصفة JOLT في أداة API؟»
تستعلم عن حسابكApp«اعرض لي عملاء VIP»
تنفّذ إجراءًApp«أرسل قالب عرض رمضان لكل عملاء الفئة الذهبية»
تتابع استهلاككApp«كم محادثة تعاملنا معها الأسبوع الماضي؟»
تلميح

ابدأ بـ Docs MCP عشان تتعلم Orki، وبعدين أضف App MCP لمّا تبغى مساعدك ينفّذ على مساحة عملك بدل ما يشرحها فقط.

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

  • رموز API — وصول برمجي لواجهة API لتكاملاتك الخاصة
  • الويب هوك — ادفع الأحداث لأنظمتك