كيفية ربط FlipLink بـ Claude عبر خادم MCP

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

يأخذك هذا الدليل عبر عملية الإعداد بالكامل — أقل من خمس دقائق من البداية حتى أول مهمة.

ما الذي ستحتاج إليه

قبل أن تربط أي شيء، تأكّد من توفّر ما يلي:

• Node.js الإصدار 18 أو أحدث — يعمل الخادم عبر npx، لذا فإنّ Node هو الاعتماد الوحيد لبيئة التشغيل. (لا تثبّت الخادم يدوياً؛ بل يطلقه عميل الذكاء الاصطناعي عند الحاجة.)
• مفتاح FlipLink API — سجّل الدخول على go.fliplink.me واحصل على مفتاحك من صفحة Subscription. يصادق هذا المفتاح على كل إجراء يقوم به Claude، لذا تعامل معه كأنه كلمة مرور.

هذا كل شيء. إذا لم يسبق لك استخدام خادم بروتوكول سياق النموذج (MCP)، فإنّ قراءة دقيقتين تستحق العناء: ما هو خادم MCP.

ربط FlipLink بـ Claude Code (أمر واحد)

إذا كنت تستخدم Claude Code، فإنّ الإعداد بأكمله أمر واحد. ضع مفتاحك ونفّذ:

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

يسجّل هذا الأمر FlipLink كخادم MCP، ويمرّر مفتاح API الخاص بك كمتغيّر بيئة، ويُخبر Claude بإطلاق الخادم عبر npx كلما احتاج إليه. تتيح الراية -y لـ npx جلب الحزمة دون مطالبة تفاعلية. أعد تشغيل جلسة Claude Code وستصبح أدوات FlipLink متاحة.

ربط Claude Desktop (كتلة الإعدادات)

يستخدم Claude Desktop (وعملاء آخرون مثل Cursor أو Codex) ملف إعدادات JSON بدلاً من ذلك. أضف مدخل mcpServers على هذا النحو:

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

استبدل <YOUR_KEY> بمفتاحك الحقيقي، واحفظ الإعدادات، وأعد تشغيل العميل. عند الإطلاق التالي، تُحمّل أدوات FlipLink تلقائياً. تحدّد قيمة FLIPLINK_MCP_MODE الإجراءات المسموح بها — المزيد عن ذلك أدناه.

التحقّق من الاتصال

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

“شغّل أداة FlipLink whoami.”

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

🚀

جرّب FlipLink مجاناً

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

Drop your PDF here or click to browse

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

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

كيف يبدو استدعاء الأداة

لن تكتب اسم أداة بنفسك أبداً. تصف ما تريده بلغة طبيعية، فيختار Claude الأداة المناسبة، ويملأ الوسائط، ويشغّلها. تُولَّد أدوات FlipLink مباشرةً من مواصفات الـ API وتُسمّى وفق النمط <noun>_<verb> — لذا سترى استدعاءات مثل flipbook_create_by_file أو flipbook_publish أو flipbook_set_skin أو leads_list تمرّ أثناء عمل Claude.

خلف الكواليس، تُربط كل أداة بنقطة نهاية حقيقية في FlipLink API. وإذا أردت يوماً الاطّلاع على أشكال الطلبات الأساسية والمعاملات وعلى وحدة تجربة مباشرة، فإنّ مرجع API الكامل يوثّق كلاً منها — ومن هناك أيضاً يأتي مفتاح API الخاص بك.

مهمّتك الأولى

والآن الجزء الممتع. سلّم Claude ملف PDF واطلب:

“أنشئ كتاباً تفاعلياً من ملف PDF هذا وسمّه Q3 Report.”

يستدعي Claude الأداة flipbook_create_by_file، ويرفع الملف، ويعيد إليك معرّف الكتاب التفاعلي الجديد ورابط مشاركته. ومن هناك يمكنك المتابعة في المحادثة نفسها:

“انشره الآن وأعطني رابط المشاركة.”

يربط Claude الأداتين flipbook_publish وflipbook_get_share_link ويُرجع رابطاً يمكنك إرساله فوراً. لا تنقّل بين النوافذ، ولا خطوات يدوية — مجرد محادثة تنتج كتباً تفاعلية حقيقية ومنشورة. وللاطّلاع على الصورة الأشمل لما يفتحه ذلك، راجع أتمتة الكتب التفاعلية باللغة الطبيعية.

كلمة عن الأوضاع (الوضع الآمن افتراضياً)

يأتي خادم MCP مع آليّة حماية ينبغي أن تفهمها: يتحكّم إعداد FLIPLINK_MCP_MODE في الأدوات التي يستطيع Claude الوصول إليها.

• readonly — 19 أداة، للقراءة فقط. يستطيع Claude العرض والفحص، لكنه لا يغيّر أي شيء أبداً.
• safe — 79 أداة، وهو الوضع الافتراضي. قراءة بالإضافة إلى عمليات كتابة قابلة للتراجع والتحكّم في الوصول؛ دون حذف، ودون إجراءات تجارية. هذه هي نقطة الانطلاق المناسبة لمعظم الناس.
• full — جميع الأدوات الـ 87، بما في ذلك الإجراءات المدمّرة والمتعلّقة بالمال.

حتى في وضع full هناك شبكة أمان ثانية: أدوات الحذف والبيع/التسعير لا تنطلق أبداً في الاستدعاء الأول. يعيد الخادم معاينة من سطر واحد بالإضافة إلى رمز تأكيد قصير العمر (مرتبط بتلك الوسائط بالضبط، وينتهي خلال خمس دقائق)، وعلى Claude أن يعرض عليك المعاينة ويستدعي مرة أخرى بالرمز قبل أن يحدث أي شيء لا يمكن التراجع عنه. وإذا أردت التفصيل الكامل لكيفية عمل آليّات الحماية هذه، اقرأ آليّات حماية خادم MCP.

ابدأ التحدّث إلى كتبك التفاعلية

ربط FlipLink بـ Claude يحوّل إدارة الكتب التفاعلية إلى محادثة. أمر واحد (أو كتلة إعدادات واحدة)، وفحص whoami سريع، وستجد نفسك تطلب من Claude بناء الكتب التفاعلية ونشرها نيابةً عنك — بأمان، مع حماية وضع safe لك جاهزاً من البداية.

مستعدّ للانطلاق؟ احصل على مفتاحك من صفحة Subscription، ونفّذ أمر الإعداد، واطلب من Claude إنشاء أول كتاب تفاعلي له.

قراءات ذات صلة

• نظرة عامة على خادم FlipLink MCP
• ما هو خادم MCP؟
• آليّات حماية خادم MCP (للقراءة فقط / الآمن / الكامل)
• أتمتة الكتب التفاعلية باللغة الطبيعية
• ميزة الوصول إلى API
• مرجع FlipLink CLI