Dvina MCP

استخدم Dvina من تطبيقات أخرى عبر MCP

اربط عميل MCP مثل Claude Code أو ChatGPT أو Cursor بـ Dvina، وسجّل الدخول، واسمح له بقراءة محتواك في Dvina والإضافة إليه بموافقتك.

عرض بصيغة Markdown

لدى Dvina خادم MCP خاص به. اربط عميل MCP، مثل Claude Code أو ChatGPT أو Cursor، ليتمكّن ذلك التطبيق من البحث في محتواك في Dvina، وقراءة مستنداتك وذاكرتك، وإضافة ملاحظات ومهام وتذكيرات باسمك.

قبل أن تبدأ

تحتاج إلى عنوان الخادم:

https://api.dvina.ai/mcp

إذا كانت شركتك تشغّل Dvina على خوادمها الخاصة، فاستخدم عنوان واجهة API الخاصة بـ Dvina في شركتك، مع إضافة /mcp في نهايته. اطلب العنوان من المسؤول.

يستخدم الخادم Streamable HTTP. إذا طلب منك العميل اختيار بروتوكول النقل، فاختر HTTP.

ربط عميل

Claude Code

  1. شغّل الأمر التالي في الطرفية:

    claude mcp add --transport http dvina https://api.dvina.ai/mcp

  2. افتح Claude Code، وشغّل /mcp، واختر dvina، ثم سجّل الدخول إلى Dvina.

ChatGPT

  1. افتح القسم الذي يتيح لك إضافة خادم MCP في ChatGPT.
  2. أدخل https://api.dvina.ai/mcp عنوانًا للخادم، واختر OAuth إذا طُلب منك تحديد طريقة تسجيل الدخول.
  3. سجّل الدخول إلى Dvina عندما يطلب منك ChatGPT ذلك.

Cursor

  1. افتح القسم الذي يتيح لك إضافة خادم MCP في Cursor.
  2. أضف خادمًا باسم dvina وعنوانه https://api.dvina.ai/mcp.
  3. سجّل الدخول إلى Dvina عندما يطلب منك Cursor ذلك.

لا تحتاج إلى معرّف عميل أو سرّ عميل. يسجّل العميل نفسه لدى Dvina عند اتصاله لأول مرة.

تسجيل الدخول

يتيح لك خادم MCP الخاص بـ Dvina تسجيل الدخول باستخدام OAuth في متصفحك:

  1. سجّل الدخول إلى Dvina كالمعتاد.
  2. إذا كنت عضوًا في أكثر من مساحة عمل، فاختر إحداها ضمن اختيار مساحة العمل، ثم اختر متابعة. يعمل العميل في مساحة العمل تلك فقط.
  3. ضمن تفويض الوصول، تحقّق من اسم التطبيق، ثم اختر السماح بالوصول. اختر رفض إذا لم تتعرّف عليه.

يبقى العميل متصلًا، لذا لا تحتاج إلى تسجيل الدخول في كل مرة.

ما يمكن للعميل فعله

يمكن للعميل الاطّلاع على أدوات Dvina واستخدامها عندما يتطلّب طلبك ذلك:

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

لا يمكن للعميل حذف أي شيء نهائيًا، أو فتح روابط عامة، أو ربط التطبيقات أو إلغاء ربطها، أو تغيير إعدادات الإدارة أو الفوترة.

الموافقة على التغييرات

تخضع إجراءات العميل للقواعد نفسها المطبّقة في كل مكان في Dvina:

  • تُنفَّذ عمليات القراءة دون طلب موافقتك.
  • تُنفَّذ إضافة شيء جديد، مثل ملاحظة أو ملف ذاكرة أو مهمة، دون طلب موافقتك. ولا تغيّر أبدًا ما هو موجود بالفعل.
  • يُطلب منك أولًا الموافقة على تغيير شيء أو إزالته، مثل نقل مستند إلى سلة المهملات، أو إعادة كتابة صفحة في لوحة، أو إيقاف مهمة، أو مشاركة عنصر. يعرض العميل ملخص Dvina نفسه للتغيير، فتوافق عليه أو ترفضه. إذا رفضت، فلن يتغير شيء.

ملاحظة

إذا لم يتمكن العميل من طلب تأكيدك، فلن ينفّذ Dvina التغيير الذي يطلبه. أجرِ التغيير في تطبيق Dvina بدلًا من ذلك، أو استخدم عميلًا يمكنه طلب تأكيدك.

صلاحيات وصولك وقواعد شركتك

يعمل العميل نيابةً عنك، ضمن ما يمكنك رؤيته وفعله في Dvina:

  • لا يعمل إلا ما دمت عضوًا في مساحة العمل، وضمن ما يسمح به دورك فقط.
  • إذا عطّل المسؤول ميزة، مثل رفع الملفات، فلن يتمكن العميل من استخدامها أيضًا.
  • يخضع ما يضيفه العميل أو يغيّره لقواعد حماية البيانات في شركتك، كما في التطبيق.
  • يُسجَّل ما يضيفه أو يغيّره في سجل التدقيق لديك باعتباره إجراءً نفّذه المساعد نيابةً عنك، مع تحديد العميل الذي صدر منه.
  • تُحتسب إجراءاته ضمن استخدامك، وتخضع لحدودك المعتادة.

الاتصال باستخدام مفتاح API بدلًا من OAuth

في خطة Enterprise، يمكن للعميل الاتصال باستخدام رمز وصول شخصي بدلًا من تسجيل الدخول. استخدم هذه الطريقة لعميل لا يمكنه تسجيل الدخول باستخدام OAuth، أو لبرنامج نصي.

  1. افتح الإعدادات واختر الوصول عبر API.
  2. ضمن رموز الوصول الشخصية، اختر إنشاء رمز.
  3. أدخل اسمًا، وحدّد صلاحيات الوصول وموعد انتهاء الصلاحية، ثم اختر إنشاء رمز.
  4. ضمن نسخ رمزك، انسخ الرمز. هذه هي المرة الوحيدة التي يُعرض فيها.

اختر صلاحيات الوصول التي يحتاج إليها العميل:

  • القراءة فقط: لا يرى العميل إلا أدوات القراءة. يمكنه البحث في محتويات Dvina لديك وقراءتها، لكنه لا يستطيع إضافة أي شيء أو تغييره.
  • القراءة والكتابة: يرى العميل جميع الأدوات، وتظل التغييرات بحاجة إلى موافقتك، كما عند استخدام OAuth.

أرسل الرمز في ترويسة Authorization، بعد Bearer. في Claude Code، مثلًا:

claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"

في أي عميل آخر، أضف الترويسة نفسها في الموضع الذي يتيح لك ضبط ترويسات خادم MCP.

يعمل الرمز نيابةً عنك، في مساحة العمل التي أنشأته فيها، وفق دورك الحالي فيها. لاستبداله، افتحه ضمن رموز الوصول الشخصية واختر تدوير…: يحل رمز جديد محله، ويتوقف الرمز القديم عن العمل فورًا. لإيقافه، اختر إلغاء…: يتوقف كل ما يستخدمه عن العمل فورًا.

لمزيد من المعلومات عن الرموز، راجع الوصول عبر API.