Waafir
هذه الصفحة ترجمة آلية في انتظار المراجعة البشرية. قد تحتوي على أخطاء.

الإعداد

لا يتطلب ربط مساعد ذكاء اصطناعي بـ Waafir سوى عنوان URL واحد: الصقه في مساعدك، ثم سجّل الدخول إلى Waafir عندما يطلب منك ذلك. لا يوجد رمز يجب إنشاؤه أو نسخه. تتناول هذه الصفحة تسجيل الدخول، وخطوة إضافة الخادم في كل مساعد، وكيفية الاتصال باستخدام رمز وصول شخصي بدلًا من ذلك عندما لا يستطيع المساعد تسجيل الدخول.

الأساسيات

عنوان URL. يخدم عنوان URL واحد جميع أدوات Waafir:

https://app.waafir.io/api/mcp/waafir

تعرض صفحة الإضافات ← الإعدادات ← مساعدات الذكاء الاصطناعي عنوان URL الخاص بنشرك، مع زر للنسخ. استبدل https://app.waafir.io إذا كنت على نشر مختلف.

تسجيل الدخول. في أول مرة يستخدم فيها مساعدك عنوان URL، يفتح Waafir في متصفحك. سجّل الدخول كما تفعل عادةً، ثم راجع شاشة الموافقة:

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

وافق، فيعيدك المتصفح إلى المساعد. يظهر الاتصال ضمن الإضافات ← الإعدادات ← مساعدات الذكاء الاصطناعي، حيث يمكنك رؤية ما يمكنه الوصول إليه وإلغاؤه. راجع الاتصالات.

Unverified app "…". المساعد الذي يعرّف نفسه بعنوان ويب يتحكم فيه يُعرض بذلك العنوان، مثل claude.ai. أما المساعد الذي سجّل نفسه باسم من اختياره فيُعرض بصيغة Unverified app "<its name>": لا تستطيع Waafir التحقق ممن أنشأه، لذا لا توافق عليه إلا إذا كنت أنت من بدأ الاتصال.

ما تعرضه قائمة الأدوات. تبدأ أسماء الأدوات باسم مجالها: dataroom_ وesign_ وredact_ وtranslate_. لا تعرض القائمة إلا الأدوات التي يمكن لاتصالك ولمؤسستك استخدامها: فالاتصال المقتصر على القراءة لا تُعرض له أدوات الكتابة، ولا تظهر أدوات التوقيع الإلكتروني إلا إذا كانت مؤسستك تملك إضافة E-Signatures أو اشتراكًا نشطًا. ويعرض الاتصال أيضًا الأدوات التي تحتاج إلى إذن لم تمنحه، مثل التوقيع أو الإرسال إلى خارج مؤسستك. فإذا استدعى المساعد إحداها، ترفض Waafir الاستدعاء ويطلب منك المساعد الموافقة مجددًا، مع عرض ذلك الإذن هذه المرة. أما الرمز فلا يمكنه الطلب مجددًا، لذا تستبعد قائمته تلك الأدوات. والأداة غير المدرجة تُرفض مع بيان السبب حتى لو استدعاها المساعد رغم ذلك.

ربط مساعدك

يعرض كل قسم أدناه خطوة إضافة الخادم الخاصة بالمساعد ويربط بوثائقه (تم التحقق من كل رابط آخر مرة في 23 أكتوبر 2026). لم يُختبر أي من هذه المساعدات مع تسجيل الدخول إلى Waafir حتى الآن، لذا يحتفظ كل قسم ببديل الرمز إلى جانبه.

Claude (claude.ai وClaude Desktop)

لم تختبره Waafir بعد. افتح Customize → Connectors، واختر Add → Add custom connector، وأعطه اسمًا، والصق عنوان URL، ثم تابع. أبقِ تسجيل الدخول مفعّلًا، وسجّل الدخول إلى Waafir عندما يطلب Claude ذلك. لاستخدامه في محادثة، فعّله من + → Connectors. في خطة Team أو Enterprise، يضيف المالك الموصلات ضمن Organization settings → Connectors. (دليل Claude)

إذا لم يعمل تسجيل الدخول، فأضف ترويسة الطلب Authorization: Bearer <token> مع رمز بدلًا من ذلك (راجع الاتصال برمز بدلًا من ذلك).

ChatGPT

لم تختبره Waafir بعد. يصل ChatGPT إلى خوادم MCP البعيدة من أماكن مختلفة بحسب التطبيق؛ في تطبيق سطح المكتب، افتح Settings → MCP servers → Add server والصق عنوان URL، ثم سجّل الدخول إلى Waafir عندما يُطلب منك ذلك. (دليل OpenAI)

إذا لم يتمكن ChatGPT من تسجيل الدخول، فاستخدم رمزًا بدلًا من ذلك.

Claude Code

لم تختبره Waafir بعد.

claude mcp add --transport http waafir https://app.waafir.io/api/mcp/waafir

ثم شغّل /mcp داخل Claude Code (أو claude mcp login waafir من الصدفة) وسجّل الدخول إلى Waafir في المتصفح. أضف --scope user لاستخدامه في كل مشروع. وتعرض صفحة الإضافات ← الإعدادات ← مساعدات الذكاء الاصطناعي هذا الأمر جاهزًا للنسخ. (دليل Claude Code)

Cursor

لم تختبره Waafir بعد. أضف عنوان URL إلى .cursor/mcp.json (أو ~/.cursor/mcp.json لكل المشاريع)، ثم سجّل الدخول إلى Waafir عندما يطلب Cursor ذلك:

{
  "mcpServers": {
    "waafir": {
      "url": "https://app.waafir.io/api/mcp/waafir"
    }
  }
}

(دليل Cursor)

إذا لم يتمكن Cursor من تسجيل الدخول، فأضف ترويسة الرمز الموضحة في الاتصال برمز بدلًا من ذلك.

VS Code

لم تختبره Waafir بعد. شغّل MCP: Add Server من Command Palette، واختر HTTP، والصق عنوان URL وأعطه المعرّف waafir. سجّل الدخول إلى Waafir عندما يطلب VS Code ذلك. (دليل VS Code)

Gemini CLI

لم تختبره Waafir بعد.

gemini mcp add --transport http waafir https://app.waafir.io/api/mcp/waafir

ثم شغّل /mcp auth waafir وسجّل الدخول في المتصفح. يحتاج تسجيل الدخول إلى متصفح محلي، لذا لا يعمل عبر معظم جلسات SSH البعيدة: استخدم رمزًا هناك. (دليل Gemini CLI)

Codex

لم تختبره Waafir بعد.

codex mcp add waafir --url https://app.waafir.io/api/mcp/waafir
codex mcp login waafir

(دليل Codex)

الاتصال برمز بدلًا من ذلك

استخدم رمز وصول شخصي عندما لا يستطيع المساعد تسجيل الدخول، أو لبرنامج نصي. يحمل كل طلب الرمز بوصفه رمز حامل (bearer token) في الترويسة Authorization:

Authorization: Bearer waafir_pat_...

لا تُودِع أبدًا رمزًا حقيقيًا في ملف مشترك أو مستودع؛ وتعامل معه ككلمة مرور. وتوفر صفحة الإضافات ← الإعدادات ← رموز API مقتطفًا جاهزًا للنسخ.

خوادم المجالات. إلى جانب waafir، لا تزال أربعة خوادم للمجالات متاحة، حتى يستمر عمل أي إعداد قائم. يعرض كل منها أدوات مجاله فقط، مصفّاة بالطريقة نفسها، ويحتفظ بأسماء الأدوات التي كانت له دائمًا (list_files بدلًا من dataroom_list_files). لا تحتاج إليها إذا اتصلت بـ waafir:

الخادمعنوان URL
waafir-redacthttps://app.waafir.io/api/mcp/waafir-redact
waafir-translatehttps://app.waafir.io/api/mcp/waafir-translate
waafir-dataroomhttps://app.waafir.io/api/mcp/waafir-dataroom
waafir-esignhttps://app.waafir.io/api/mcp/waafir-esign

لا توجد نقطة نهاية /api/mcp مجرّدة: مقطع اسم الخادم إلزامي، والطلب الذي يخلو منه يُرجع 404. والخادم waafir-esign خدمة مدفوعة: فبدون إضافة E-Signatures أو اشتراك نشط، يجيب عنوانه بالخطأ ADDON_NOT_PURCHASED. أما على waafir فلا ترى المؤسسة نفسها أدوات esign_ ببساطة.

Claude Code. ضع الرمز أولًا في متغير بيئة، حتى يبقى خارج سجل أوامر الصدفة:

export WAAFIR_PAT=...   # the token you copied at issuance
claude mcp add --transport http waafir https://app.waafir.io/api/mcp/waafir \
  --header "Authorization: Bearer $WAAFIR_PAT"

لمشاركة الإعداد مع مشروع، ضع الإدخال نفسه في ملف .mcp.json الخاص به. يوسّع Claude Code المتغير ${WAAFIR_PAT} من بيئة كل شخص، لذا يمكن إيداع الملف دون أن يتضمن الرمز:

{
  "mcpServers": {
    "waafir": {
      "type": "http",
      "url": "https://app.waafir.io/api/mcp/waafir",
      "headers": {
        "Authorization": "Bearer ${WAAFIR_PAT}"
      }
    }
  }
}

ملف إعدادات Claude Desktop. يشغّل claude_desktop_config.json خوادم محلية: كل إدخال فيه هو command يُشغَّل، لا url بعيد. للوصول إلى Waafir من ذلك الملف، شغّل الجسر mcp-remote (يحتاج إلى Node.js)، الذي يعيد التوجيه إلى الخادم البعيد ويضيف رمزك كترويسة:

{
  "mcpServers": {
    "waafir": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.waafir.io/api/mcp/waafir",
        "--header",
        "Authorization:${WAAFIR_AUTH}"
      ],
      "env": {
        "WAAFIR_AUTH": "Bearer YOUR_WAAFIR_PAT"
      }
    }
  }
}

احرص على أن يخلو الوسيط Authorization:${WAAFIR_AUTH} من المسافات، ثم أعد تشغيل Claude Desktop.

Cursor، والعملاء الآخرون الذين يقبلون عنوان URL وترويسات.

{
  "mcpServers": {
    "waafir": {
      "url": "https://app.waafir.io/api/mcp/waafir",
      "headers": {
        "Authorization": "Bearer YOUR_WAAFIR_PAT"
      }
    }
  }
}

يُضاف خادم المجال بالطريقة نفسها، مع تغيير مفتاح الإدخال وعنوان URL.

استدعاء أداة

بعد الاتصال، يعرض عميلك أدوات الخادم (عبر tools/list في MCP) ويستدعيها نيابةً عنك. لا تستدعي الأدوات يدويًا — بل تطلب من عميل الذكاء الاصطناعي أن يفعل شيئًا ("اعرض الملفات في غرفة البيانات هذه"، "ترجم هذه الفقرة إلى الفرنسية") فيختار الأداة المناسبة ويستدعيها، ممررًا الوسائط الموثقة في مرجع كل خادم. راجع مراجع waafir-redact وwaafir-translate وwaafir-dataroom وwaafir-esign للاطلاع على عقود الأدوات.

عندما يحدث خطأ

تصل حالات الفشل على طبقتين مختلفتين، ولا تتشابهان في الشكل. والخطأ في فهم ذلك هو أكثر أخطاء التكامل شيوعًا هنا: فالعميل الذي يتفرع بناءً على حالة HTTP وحدها سيفوّت بصمت كل فشل من النوع الثاني.

الطبقة 1 — رُفض الطلب قبل تشغيل أي أداة

هذه حالات خطأ HTTP حقيقية، مع جسم خطأ بصيغة JSON-RPC. وهي تعني أن الطلب لم يصل إلى أي أداة على الإطلاق:

  • 404 — خادم MCP غير معروف. مقطع اسم الخادم في عنوان URL ليس أحد waafir أو waafir-redact أو waafir-translate أو waafir-dataroom أو waafir-esign — وغالبًا ما يكون السبب خطأً مطبعيًا أو /api/mcp مجرّدًا بلا اسم خادم. صحّح عنوان URL.

  • 402 — الإضافة غير مشتراة. الخادم خدمة مدفوعة (حاليًا: waafir-esign) ومؤسستك لا تملك الإضافة ولا اشتراكًا نشطًا. يمكن لمسؤول المؤسسة شراء الإضافة أو خطة من إعدادات الفوترة. ولا تستطيع المؤسسة غير المستحقة حتى عرض أدوات الخادم. لا يجيب waafir أبدًا بـ 402: بل يخفي الأدوات المدفوعة بدلًا من ذلك، ويُرفض استدعاء إحداها على الطبقة 2 بالرمز QUOTA_EXCEEDED ورسالة تسمّي تلك الأداة، وتحمل أيضًا ADDON_NOT_PURCHASED.

  • 401 — غير مصادق عليه. بيانات الاعتماد مفقودة أو مشوّهة أو ملغاة أو منتهية الصلاحية. بالنسبة إلى الاتصال، سجّل الدخول مجددًا من مساعدك: تفعل معظم المساعدات ذلك نيابةً عنك عندما ترى 401، والاتصال الذي أُلغي، أو الذي ظل دون استخدام لمدة 30 يومًا، يحتاج إلى تسجيل دخول جديد. أما بالنسبة إلى الرمز، فتحقق من وجود الترويسة Authorization ومن أن الرمز لا يزال نشطًا في الإضافات ← الإعدادات ← رموز API؛ وأصدر رمزًا جديدًا إذا كان قد أُلغي أو انتهت صلاحيته. ويجيب النشر الأقدم من هذا السلوك عن الرمز المفقود أو المشوّه بالخطأ 403 CSRF validation failed: missing Origin بدلًا من ذلك؛ وعلى هذه الواجهة، يعني ذلك أيضًا أن الرمز مفقود أو مشوّه.

  • 403 — محظور. رُفضت بيانات الاعتماد عند المدخل: استُخدمت جلسة متصفح مسجّل الدخول فيها بدلًا من اتصال أو PAT (لا تُقبل الجلسات على هذه الواجهة)، أو أن مؤسستك تفرض قائمة سماح لعناوين IP وجاء الطلب من عنوان خارجها.

  • 429 — طلبات كثيرة جدًا. لقد بلغت حدًا لمعدل طلبات MCP. لا شيء هنا مرتبط بعنوان IP الخاص بك أو بمؤسستك — فميزانيتك هي ميزانية رمزك، لذا لا يستهلكها زميل في المؤسسة نفسها ولا عميل ثانٍ على الشبكة نفسها. الحد هو 60 طلبًا في الدقيقة لكل رمز. ويُحتسب قبل البحث عن الرمز، لذا يستهلكه أيضًا الرمز المشوّه أو الملغى أو المنتهي الصلاحية، وتُحتسب استدعاءات الرمز نفسه لواجهة Waafir API خارج MCP ضمن الستين نفسها. كما تُحتسب الستون للاتصال المسجّل الدخول لكل اتصال، لذا فإن الرمز الجديد الذي يحصل عليه مساعدك عند تحديث تسجيل دخوله لا يبدأ ستين جديدة.

    لا تحمل الاستجابة أي ترويسة Retry-After ولا أي رمز مميِّز — فكل 429 على هذه الواجهة يبدو متطابقًا — لذا تراجع وفق جدول زمني خاص بك بدلًا من إعادة المحاولة المتواصلة. وإذا لم يوفّر رمز واحد هامشًا كافيًا، فأصدر رمزًا ثانيًا: فالحد لكل رمز.

الطبقة 2 — شُغّلت أداة ورفضت

هنا تقع معظم حالات الرفض، وهي ليست خطأ HTTP. استجابة HTTP هي 200 وغلاف JSON-RPC هو غلاف نجاح. يُنقل الفشل داخل نتيجة الأداة، التي تضبط isError: true ويكون محتواها النصي:

{ "error": { "code": "CONFLICT", "message": "…" } }

تفرّع بناءً على error.code. الرموز هي:

الرمزالمعنى
INVALID_ARGUMENTوسيط مفقود أو مشوّه أو ليس معرّفًا صالحًا — صحّحه وأعد المحاولة
FORBIDDENالرمز صالح لكنه غير مسموح له بهذا الاستدعاء
NOT_FOUNDلا يوجد سجل كهذا، أو أنه ليس لك
CONFLICTالطلب مفهوم ومسموح به، لكن غرفة البيانات ليست في حالة تسمح بتنفيذه
TOO_LARGEالمُدخل يتجاوز حدًا للحجم — قسّمه
QUOTA_EXCEEDEDاستُنفد رصيد محسوب الاستهلاك؛ يجب على أحدهم شراء شيء أو ترقيته
UPSTREAM_ERROR / UNAVAILABLEفشل عابر في خدمة لاحقة — أعد المحاولة لاحقًا
INTERNALفشل غير متوقع — لا تُعد المحاولة، بل صعّد المشكلة

يوقع اثنان من هذه الرموز الناس في الخطأ:

  • FORBIDDEN لنطاق منخفض جدًا. لا تُعرض أدوات الكتابة لاتصال أو رمز بنطاق read، لكن العميل الذي يستدعي إحداها رغم ذلك يُرفض من قِبل الأداة، لذا يصل هنا بصيغة FORBIDDEN داخل الحمولة — وليس كخطأ HTTP 403. وينطبق الأمر نفسه على الرمز المقصور على غرف بيانات محددة عندما يذكر غرفة خارج قائمة السماح الخاصة به بوصفها dataroom_id. وتجيب معظم الأدوات التي تأخذ معرّف ملف أو مجلد بدلًا من ذلك بـ NOT_FOUND لعنصر في غرفة كهذه، تمامًا كما تفعل مع معرّف غير موجود. سجّل الدخول مجددًا من مساعدك وامنح النطاق الصحيح أو غرف البيانات الصحيحة، أو أصدر رمزًا بالنطاق الصحيح.
  • CONFLICT. كان الاستدعاء مفهومًا ومسموحًا به، لكن غرفة البيانات ليست في حالة تسمح بتنفيذه — اسم مجلد مستخدم بالفعل، أو ملف استحوذ ملف نشط على اسمه منذ ذلك الحين، أو استعادة لا تزال حاويتها محذوفة أو لم يكتمل تحميلها قط. إن CONFLICT ليس مشكلة تفويض، ولن يفيد تسجيل الدخول مجددًا أو إعادة إصدار الرمز؛ وتسمّي الرسالة السجل المانع حيثما وُجد، لتتمكن من التعامل معه وإعادة المحاولة. ويسرد مرجع waafir-dataroom حالات التعارض التي يمكن أن تُرجعها كل أداة.

ملف لا يزال قيد الفحص. تفحص Waafir كل ملف مرفوع حديثًا وكل إصدار جديد قبل أن تقدّم محتواه. وإلى ذلك الحين، تُجيب أي أداة تقرأ محتوى الملف بـUNAVAILABLE مع error.reason: "ACTIVATION_PENDING" والرسالة This file is still being checked. Try again shortly. وهذا الرفض مؤقت: استدعِ الأداة مجددًا بعد انتظار قصير.

الرفض الواضح على أي من الطبقتين هو النتيجة المتوقعة والآمنة لاستدعاء لن تخدمه Waafir — فهي تُفشل الطلب بدلًا من أن تنفّذ بصمت أقل مما طلبت.