استخدام FlipLink في Cursor وغيره من عملاء MCP

إن كنت تعيش أصلاً داخل Cursor، فلست بحاجة إلى مغادرة محرّرك للعمل مع FlipLink. فبمجرّد إضافة خادم MCP لـ FlipLink، يستطيع الذكاء الاصطناعي المدمج في Cursor أن ينشئ الكتيّبات الرقمية وينشرها ويسحب العملاء المحتملين وأكثر من ذلك — لا أكثر من أن تطلب ذلك بلغة بسيطة. والإعداد نفسه يعمل في Claude Desktop وCodex وأي أداة أخرى تتقن بروتوكول سياق النماذج.

يأخذك هذا الدليل خطوةً بخطوة عبر إعداد Cursor، ثم يطلعك على الإعداد العام الذي يعمل في كل عميل MCP.

ما المقصود بعميل MCP

عميل MCP هو أي تطبيق يستطيع الاتصال بخوادم MCP والسماح للذكاء الاصطناعي فيه باستخدام الأدوات التي تتيحها تلك الخوادم. وكلٌّ من Cursor وClaude Desktop وCodex هو عميل MCP. أمّا بروتوكول سياق النماذج (Model Context Protocol) فهو المعيار المفتوح الذي يتيح لها التحدّث إلى خادم مثل fliplink-mcp دون أي شيفرة ربط مخصّصة.

عند ربط خادم MCP لـ FlipLink، يشغّل العميل الخادم في الخلفية، فيكتسب الذكاء الاصطناعي مجموعةً من أدوات FlipLink — أشياء مثل flipbook_create_by_file وflipbook_publish وleads_list. جديد على الفكرة؟ ابدأ بـ ما خادم MCP، ثم عُد إلى هنا.

أين يوجد إعداد MCP في Cursor

يدير Cursor خوادم MCP من إعداداته. افتح إعدادات Cursor، وابحث عن قسم MCP / Model Context Protocol، ثم اختر إضافة خادم MCP جديد. يتيح لك Cursor لصق تعريف الخادم بصيغة JSON — وهي بنية mcpServers نفسها التي يستخدمها كل عميل MCP.

لست بحاجة إلى تثبيت أي شيء يدوياً، إذ يشغّل العميل الخادم عبر npx عند الطلب، فلا متطلّبات سوى Node.js 18+ ومفتاح FlipLink API. احصل على المفتاح بتسجيل الدخول في go.fliplink.me وفتح صفحة الاشتراك.

كتلة خادم FlipLink

في إعدادات MCP داخل Cursor، أضف خادم MCP باستخدام مدخل mcpServers التالي. استبدل <YOUR_KEY> بمفتاح FlipLink API الخاص بك:

{
  "mcpServers": {
    "fliplink": {
      "command": "npx",
      "args": ["-y", "fliplink-mcp"],
      "env": { "FLIPLINK_API_KEY": "<YOUR_KEY>", "FLIPLINK_MCP_MODE": "safe" }
    }
  }
}

بعض الملاحظات على هذه الكتلة:

• command وargs يخبران العميل بتشغيل الخادم عبر npx — دون حاجة إلى تثبيت عام.
• FLIPLINK_API_KEY يصادق على كل استدعاء. تعامل معه كأنّه كلمة مرور، وأبقِه بعيداً عن المستودعات المشتركة.
• FLIPLINK_MCP_MODE يتحكّم في عدد الأدوات المتاحة. فوضع safe (الافتراضي) يمنحك القراءات إضافةً إلى الكتابات القابلة للتراجع وضوابط الوصول — دون حذف ودون عمليات تجارية. استخدم readonly لإعداد للنظر دون اللمس، أو full لكل شيء. راجع أوضاع أمان MCP للاطّلاع على التفاصيل كاملة.

بعد الحفظ، أعد تشغيل Cursor (أو أعد تحميل خادم MCP من الإعدادات) كي يلتقط المدخل الجديد.

جرّبه: اطلب من Cursor استدعاء whoami

أسرع طريقة لتأكيد نجاح الاتصال هي أداة الفحص. في محادثة Cursor، اطلب:

استخدم FlipLink MCP واستدعِ whoami.

أداة whoami هي فحص الحساب على المستوى الأعلى. إن كان مفتاحك صالحاً، فستحصل على هوية حسابك والحدّ الأقصى لحجم الرفع لديك. وإن كان المفتاح مفقوداً أو خاطئاً، فإن الأداة تعيد تعليمات إعداد واضحة بدلاً من رسالة خطأ غامضة — وتلك إشارتك لتصحيح قيمة FLIPLINK_API_KEY وإعادة التشغيل.

بمجرّد أن يعمل whoami، جرّب شيئاً حقيقياً:

أنشئ كتيّباً رقمياً من ./deck.pdf بعنوان "Q3 Report"، ثم أعطني رابط المشاركة.

سيستدعي الذكاء الاصطناعي في Cursor أداتَي flipbook_create_by_file وflipbook_get_share_link نيابةً عنك، دون أي استدعاءات يدوية للواجهة.

🚀

جرّب FlipLink مجاناً

حوّل ملف PDF خلال ثوانٍ. لا تسجيل ولا بطاقة ائتمان — ارفع ملفك وانطلق.

Drop your PDF here or click to browse

الحجم الأقصى 40MB

الباقات المدفوعة من $39 ترفع هذا الحد إلى 150 MB.

العملاء الآخرون يستخدمون الإعداد نفسه

جمال MCP أن الإعداد عام. فكتلة mcpServers نفسها أعلاه تعمل في Claude Desktop وCodex وأي عميل MCP آخر — لا يختلف سوى القائمة التي تلصقه فيها. في كل عميل، ابحث عن إعدادات MCP أو Model Context Protocol وأضف خادماً باستخدام بنية JSON نفسها.

إن أتاح عميلك خيار نقل عبر stdio، فهو الخيار الذي ينبغي أن تختاره: إذ يتواصل fliplink-mcp عبر stdio، وهو تماماً ما يهيّئه command وargs. فلا شيء خاصّ بـ FlipLink في طريقة النقل — إنها بنية stdio القياسية التي يستخدمها كل خادم MCP.

أمّا في Claude Code تحديداً، فيمكنك تجاوز JSON تماماً وتشغيل أمر واحد:

claude mcp add fliplink -e FLIPLINK_API_KEY=<YOUR_KEY> -- npx -y fliplink-mcp

ويوجد شرح مفصّل خاص بهذا العميل في اربط FlipLink بـ Claude عبر خادم MCP.

أسئلة شائعة لاستكشاف الأخطاء

س: لا يظهر خادم FlipLink في Cursor. ماذا أفعل الآن؟ ج: تأكّد أولاً من تثبيت Node.js 18+ (node --version)، فهو ضروري لـ npx. ثم تحقّق من صحة صيغة JSON — فأي فاصلة أو قوس ناقص سيُسقط الخادم بصمت. وأخيراً، أعد تشغيل العميل بالكامل كي يقرأ الإعداد من جديد.

س: تظهر الأدوات، لكن كل استدعاء يفشل برسالة إعداد. ج: هذا يعني أن مفتاح الواجهة لا يصل إلى الخادم. تحقّق من ضبط FLIPLINK_API_KEY داخل كتلة env وأن القيمة هي مفتاحك الحقيقي من صفحة الاشتراك. احفظ وأعد التشغيل بعد التعديل.

س: لماذا لا يستطيع الذكاء الاصطناعي حذف كتيّب رقمي أو تنفيذ إجراء بيع؟ ج: أنت في وضع safe، وهو يخفي الأدوات المدمّرة والتجارية عمداً. بدّل FLIPLINK_MCP_MODE إلى full لتفعيلها — لكن لاحظ أن إجراءات الحذف والإجراءات المالية تتطلّب خطوة تأكيد قبل تنفيذها. راجع أوضاع أمان MCP.

في الختام

لا تتطلّب إضافة FlipLink إلى Cursor سوى كتلة JSON واحدة وإعادة تشغيل. وبمجرّد ربطها، يتولّى الذكاء الاصطناعي في محرّرك إنشاء الكتيّبات الرقمية ونشرها وتصدير العملاء المحتملين عبر اللغة الطبيعية — والإعداد نفسه يندرج مباشرةً في أي عميل MCP آخر تستخدمه.

لقراءة المزيد

• خادم FlipLink MCP — قائمة الأدوات الكاملة والأوضاع وتفاصيل الأمان
• ما خادم MCP؟
• اربط FlipLink بـ Claude عبر MCP
• أوضاع أمان MCP (readonly / safe / full)
• توثيق FlipLink CLI
• مرجع الواجهة (API)