خادم MCP (وكلاء الذكاء الاصطناعي)
Joryio هو خادم MCP. يتصل به مساعد الذكاء الاصطناعي عبر تسجيل دخول، ثم يعمل مع مساحة عملك: يسرد الحملات والرحلات، ويقرأ نتائجها ونتائج مراجعة الإطلاق، ويستعلم عن الأحداث، ويتحقق من المحتوى الذي يحقق أداءً - وعندما تسمح، ينشئ مسودات حملات وشرائح ليراجعها شخص.
لا شيء للتثبيت ولا مفتاح للنسخ. يتحدث الوكيل مع نفس واجهة REST API العامة الموثقة في مرجع API؛ كل أداة هي نقطة نهاية موثقة.
الصلاحيات - صلاحيات من يحصل عليها الوكيل؟
صلاحياتك أنت. عند ربط عميل ذكاء اصطناعي، يرسلك Joryio إلى شاشة موافقة في لوحة التحكم حيث تسجّل الدخول بصفتك وتحدد ما يجوز للوكيل فعله. منذ ذلك الحين يتصرف الوكيل بصفتك، ضمن ما حددته:
- لا يمكنه أبدًا فعل أكثر مما تستطيع. لا تعرض شاشة الموافقة سوى الصلاحيات التي تملكها، ويتحقق كل طلب من صلاحياتك ومن النطاقات المحددة معًا.
- إذا فقدت صلاحية، يفقدها كل وكيل ربطته عند طلبه التالي. اقطع اتصال وكيل من الإعدادات > عام فتتوقف رموزه فورًا.
- يرتبط كل اتصال بمساحة العمل التي كنت فيها عند الموافقة.
- تُسجَّل الإجراءات التي ينفذها الوكيل باسمك. اربط بالدور الذي تقصده: الزميل الذي يربط Claude بصفته يمنح صلاحياته هو، لا صلاحياتك.
لا يوجد "مستخدم وكيل" منفصل ولا مفتاح API لإدارته. المؤسسات التي تفضّل المفاتيح يمكنها الاستمرار في استخدام REST API مباشرة.
بيانات جهات الاتصال معطّلة افتراضيًا
بيانات الأشخاص هي الجزء الحساس في مساحة عمل تسويقية، لذا لا يحصل عليها وكيل الذكاء الاصطناعي إلا إذا تحقق أمران:
- فعّل مسؤول السماح لوكلاء الذكاء الاصطناعي بقراءة بيانات جهات الاتصال من الإعدادات > عام للمؤسسة. حتى ذلك الحين لا تعرض شاشة الموافقة أدوات جهات الاتصال إطلاقًا.
- يحمل الشخص الذي يربط الوكيل صلاحية وكلاء الذكاء الاصطناعي: بيانات جهات الاتصال (
agents:contacts، صلاحية بمستوى مسؤول) ويحددها في شاشة الموافقة.
وحتى عندها، تعود الحقول التي تعلّمها مساحة العمل كبيانات شخصية مقنّعة ما لم يحمل ذلك الشخص صلاحية PII - وهي نفس القاعدة التي تطبقها لوحة التحكم وواجهة REST API. يمكن لمفتاح API أن يحمل النطاق agents:contacts تحت نفس مفتاح تبديل المؤسسة.
ربط عميل
يظهر عنوان الموصّل الخاص بك في الإعدادات > عام > وكلاء الذكاء الاصطناعي مع زر نسخ. خذه من هناك بدلًا من كتابته: لكل منطقة في Joryio عنوانها الخاص، وتعرض البطاقة دائمًا عنوان المنطقة التي توجد فيها مساحة عملك. لمنطقة الاتحاد الأوروبي هو:
https://api-eu1.joryio.com/api/mcp
- Claude (claude.ai وClaude Desktop وClaude Code): أضف موصّلًا مخصصًا بهذا العنوان، أو
claude mcp add --transport http joryio https://api-eu1.joryio.com/api/mcp. - ChatGPT: أضف العنوان كموصّل في إعدادات الموصّلات في التطبيق.
- Grok (xAI): راجع Grok أدناه - يتصل grok.com وواجهة سطر أوامر Grok Build عبر تسجيل دخول؛ أما واجهة xAI البرمجية فلا.
- Cursor وعملاء آخرون يدعمون خوادم MCP البعيدة (Streamable HTTP) مع OAuth: أضف العنوان؛ يسجّل العميل نفسه ويفتح شاشة الموافقة في متصفحك.
- العملاء الذين يشغّلون خوادم محلية فقط: استخدم جسر المجتمع
npx -y mcp-remote https://api-eu1.joryio.com/api/mcp.
يستخدم الخادم OAuth 2.1 مع تسجيل العميل الديناميكي وPKCE؛ الاكتشاف على https://api-eu1.joryio.com/.well-known/oauth-authorization-server. تدوم رموز الوصول ساعة واحدة وتتجدد بصمت لمدة ثلاثين يومًا أو حتى تقطع الاتصال.
Grok (xAI)
- grok.com: افتح grok.com/connectors، واختر New Connector ثم Custom، والصق عنوان الموصّل الخاص بك. يرسلك Grok إلى شاشة الموافقة في Joryio لتسجيل الدخول وتحديد ما يُسمح له به. في Grok Business وEnterprise يجهّز مسؤول الفريق الموصّل أولًا في وحدة تحكم xAI، ثم يجده الأعضاء ضمن موصّلاتهم.
- Grok Build (واجهة سطر الأوامر
grok):grok mcp add --transport http joryio https://api-eu1.joryio.com/api/mcp. يُفتح تسجيل الدخول في متصفحك أول مرة يستخدم فيها Grok الخادم؛ ويمكنك أيضًا بدؤه من تبويب MCP ضمن/mcps. - واجهة xAI البرمجية (أدوات MCP البعيدة في طلب Responses): غير مدعومة. يرسل هذا المسار رمزًا ثابتًا في ترويسة
Authorizationولا يستطيع إكمال تسجيل الدخول، بينما لا تقبل نقطة MCP في Joryio إلا الرموز التي يصدرها تسجيل الدخول الخاص بها - ويُرفض مفتاح API. للوصول إلى Joryio من شيفرتك عبر واجهة xAI البرمجية، استدعِ واجهة REST البرمجية بمفتاح API من أدوات الدوال (function tools) الخاصة بك.
ما تعرضه شاشة الموافقة
| المجموعة | النطاقات | ما يمكن للوكيل فعله |
|---|---|---|
| قراءة | campaigns:read canvas:read segments:read events:read analytics:read | سرد وقراءة الحملات والرحلات والشرائح والأحداث والتقارير والكتالوج |
| إنشاء مسودات | campaigns:write segments:write events:track | إنشاء مسودات حملات وشرائح لتراجعها؛ تسجيل الأحداث |
| بيانات جهات الاتصال | users:read users:write agents:contacts | البحث عن الأشخاص وقراءتهم وتحديث سماتهم - فقط مع تفعيل مفتاح المؤسسة |
محدد افتراضيًا: ما طلبه العميل، أو مجموعة القراءة.
الأدوات
| الأداة | ما تعيده | نقطة النهاية |
|---|---|---|
list_campaigns | الحملات حسب الحالة أو القناة أو الاسم | GET /campaigns |
get_campaign | حملة واحدة مع متغيراتها واستهدافها | GET /campaigns/:id |
get_campaign_stats | المرسل، المسلّم، المفتوح، النقرات، التحويلات | GET /campaigns/:id/stats |
get_campaign_failure_reasons | إخفاقات التسليم حسب رمز المزوّد | GET /campaigns/:id/failure-reasons |
get_campaign_launch_review | العوائق والتوصيات | GET /campaigns/:id/launch-review |
get_campaign_performance | الحملات مرتبة حسب التحويلات الإضافية، كل حملة بهدف التحويل الخاص بها | GET /campaigns/performance |
get_journey | رحلة واحدة كاملة: المحفّز، العقد مع رسائلها، الحواف | GET /journeys/:id |
list_journeys, get_journey_stats, get_journey_launch_review | الشيء نفسه للرحلات | GET /journeys… |
list_segments, get_segment_size | الجماهير المحفوظة وحجمها | GET /segments… |
list_contact_imports | عمليات استيراد جهات الاتصال حسب اسم الملف والتاريخ، لمرشّح الشريحة «جاء من استيراد» (يتطلب users:read وليس agents:contacts) | GET /users/import/sources |
query_events, list_recent_events, get_event_trend | أحداث في نطاق، المستكشف، اتجاه | GET /events/query, GET /analytics/events, POST /analytics/events/trend |
get_active_users_now, get_content_performance | عدد مباشر، أي محتوى يعمل | GET /analytics/… |
list_products, get_catalog_stats | الكتالوج وحالته | GET /catalog/… |
create_campaign_draft | تنشئ حملة كمسودة - مسودة دائمًا، مهما طلب الوكيل | POST /campaigns |
create_segment | تنشئ شريحة محفوظة | POST /segments |
track_event | تسجل حدثًا لشخص | POST /users/track |
search_contacts, get_contact, update_contact | الأشخاص (مع مجموعة بيانات جهات الاتصال فقط) | GET /users/search, GET /users/:id, PUT /users/by-user-id/:id |
تظهر الأداة فقط عندما يحمل الاتصال نطاقها.
ما لا يستطيع الوكيل فعله أبدًا
لا توجد أداة ترسل أو تجدول أو تفعّل أو توافق أو تعيد الإرسال أو تصدّر أو تحذف أي شيء، ولا أداة تدير مفاتيح API أو أعضاء الفريق - مهما حددت. المسودة التي ينشئها الوكيل تنتظر في لوحة التحكم شخصًا يراجعها ويشغّل مراجعة الإطلاق ويرسلها.
إدارة الاتصالات
الإعدادات > عام > وكلاء الذكاء الاصطناعي تسرد الوكلاء المتصلين بصفتك، مع نطاقات كل منهم وآخر استخدام. قطع الاتصال يلغيه فورًا. يجد المسؤولون مفتاح بيانات جهات الاتصال على مستوى المؤسسة في نفس البطاقة.
الحدود
تُحتسب الطلبات ضمن حدود معدل API العادية لمساحة العمل؛ ويُطلب من الوكيل الانتظار عندما يبلغ أحدها. تنتهي مهلة كل استدعاء أداة بعد 30 ثانية. تُقسَّم القوائم إلى صفحات بنفس معاملات limit وpage / offset كما في REST API.