ما هو خادم MCP؟

خادم MCP (Model Context Protocol) هو برنامج صغير يشغّله عميل الذكاء الاصطناعي لديك محليًا ليُتيح أدوات للمساعد. يُتيح خادم FlipLink واجهة FlipLink REST API نفسها على هيئة أدوات، فيستطيع Claude أو Cursor أو أي عميل MCP إنشاء الكتيبات وتهيئتها ونشرها باللغة الطبيعية.

ما عملاء الذكاء الاصطناعي المدعومون؟

أي عميل يدعم MCP — بما في ذلك Claude Code وClaude Desktop وCursor وCodex. تضيف FlipLink إلى إعداد mcpServers في العميل، فيُشغّل الخادم عند الطلب عبر npx fliplink-mcp.

ما هي الأنماط readonly وsafe وfull؟

تحدّد الأنماط الأدوات المتاحة. يُتيح readonly 19 أداة للقراءة فقط؛ ويضيف safe (الافتراضي) عمليات الكتابة القابلة للتراجع والتحكم بالوصول ليصل المجموع إلى 79 أداة؛ ويُتيح full الأدوات الـ 87 جميعها، مع وضع أدوات الحذف والتجارة خلف خطوة تأكيد. اضبط النمط عبر FLIPLINK_MCP_MODE.

هل من الآمن أن أدع الذكاء الاصطناعي يُدير كتيباتي؟

نعم. في النمط full، لا تُنفَّذ الإجراءات المُتلِفة (الحذف) والمالية (البيع / التسعير) أبدًا من المحاولة الأولى — يُرجِع الخادم معاينة من سطر واحد ورمز تأكيد قصير الأجل مرتبطًا بالمعطيات نفسها بالضبط، وعلى المساعد أن يؤكّد قبل أن يحدث أي شيء. تعمل وسائل الحماية محليًا؛ وواجهة FlipLink API دون تغيير.

هل أحتاج إلى مفتاح API خاص بي؟

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

Model Context Protocol

خادم FlipLink MCP

شغّل FlipLink من مساعدك الذكي. دع Claude أو Cursor أو أي عميل يدعم MCP ينشئ كتبك التفاعلية ويضبطها وينشرها ويديرها بلغة طبيعية — مع ضوابط مدمجة تحمي من أي إجراء مدمّر.

ابدأ الآن اطّلع على واجهة REST API

اتصل بنسخة واحدة ولصقها

انسخ موجّه البداية إلى Claude Code — وهو يضيف خادم MCP الخاص بـ FlipLink ويتحقق منه.

الوضع

استبدل YOUR_API_KEY بمفتاح API الخاص بك في FlipLink.

Set up and verify the FlipLink MCP server for me.

1. Add the server to this Claude Code session by running this in the terminal:
   claude mcp add fliplink -e FLIPLINK_API_KEY=YOUR_API_KEY -e FLIPLINK_MCP_MODE=safe -- npx -y fliplink-mcp

2. Confirm it was added: run `claude mcp list` and check that "fliplink" appears and shows as connected.

3. Verify the config: confirm the "fliplink" server has FLIPLINK_API_KEY set in its env (it must be my real
   key, not the YOUR_API_KEY placeholder, and must not be empty). Reading config: `claude mcp get fliplink`.

4. Test the connection: call the FlipLink "whoami" tool. If it returns my account, the MCP is live.

5. If "fliplink" is missing or won't connect, troubleshoot:
   - Ensure Node.js 18+ and npx are installed (`node -v`).
   - Re-run the add command and confirm FLIPLINK_API_KEY is present and correct (not the placeholder).
   - Remove and re-add: `claude mcp remove fliplink` then re-run step 1; restart the session.
   - Re-run `claude mcp list` to confirm it now shows connected.

Once "whoami" succeeds, list the FlipLink tools now available to you.

احصل على مفتاح API

يعمل مع أدوات الذكاء الاصطناعي لديك

Claude
Cursor
ChatGPT
Codex
VS Code
Windsurf

يُثبَّت عبر npx fliplink-mcp · يستخدم مفتاح API الخاص بك · 87 أداة

كيف يعمل

خادم FlipLink MCP برنامج صغير يشغّله عميلك الذكي على جهازك. يتيح واجهة FlipLink REST API نفسها على هيئة أدوات MCP، ليتمكّن المساعد من استدعائها بلغة طبيعية. إنه باب ثالث يؤدي إلى الواجهة نفسها — شقيق لـ CLI. لا يتغيّر شيء في الواجهة؛ فهذا الخادم مجرد عميل آخر، وتعمل جميع الضوابط محلياً قبل أن يغادر أي طلب جهازك.

التثبيت

لا تثبّت أي شيء يدوياً — فعميلك الذكي يشغّل الخادم عبر npx. كل ما تحتاجه هو مفتاح FlipLink API الخاص بك (انظر أدناه).

Claude Code

terminal

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

Claude Desktop · Cursor · Codex

أضف هذا إلى إعدادات MCP في العميل (كتلة mcpServers):

mcp config

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

احصل على مفتاح API

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

احصل على مفتاحك ←

إذا كان المفتاح مفقوداً، تعيد كل أداة تعليمات واضحة لإضافته — فيتمكّن المساعد من إرشادك خلال الإعداد قبل أن تقرأ أي وثائق.

موجّه البداية

الصق هذا في جلسة ذكاء اصطناعي جديدة لتهيئة سير عمل آمن:

prompt

You now have the FlipLink MCP server connected (tools like whoami,
flipbook_create_by_file, leads_list). First, call whoami to confirm my account is reachable.
If it returns an auth error, ask me to paste my FlipLink API key (I get it from
https://go.fliplink.me/Subscription) and remind me to put it in the MCP server config as
FLIPLINK_API_KEY, then stop until I confirm.
Once connected you can create, list, and configure my flipbooks. For any delete, sale/pricing,
or access-control change, show me a one-line preview and wait for my explicit "yes" before doing it.
Here's what I want to do: <describe your task>

الأوضاع

تُصنَّف الأدوات حسب درجة الخطورة، ويحدّد الوضع أي المستويات تُتاح. اضبط FLIPLINK_MCP_MODE في الإعدادات (القيمة الافتراضية safe).

الوضع	ما يُتيحه	ملاحظات
readonly	قراءة فقط (19 أداة)	whoami، والقوائم، وعمليات البحث
safe (افتراضي)	قراءة + كتابات قابلة للتراجع + التحكم بالوصول (79 أداة)	بلا أدوات حذف أو بيع
full	كل شيء (87 أداة)	أدوات الحذف والبيع تتطلّب تأكيداً

جديد على المصطلحات؟ اطّلع على ما هي واجهة API والأتمتة.

نموذج الأمان

في وضع full، لا تعمل أدوات الحذف المدمّرة وأدوات المال (البيع / التسعير) أبداً عند الاستدعاء الأول. يعيد الخادم معاينة من سطر واحد ورمز confirm_token قصير العمر؛ وعلى المساعد أن يعرض عليك المعاينة ثم يستدعي مجدداً بذلك الرمز. الرمز مرتبط بالمعطيات نفسها بالضبط، وينتهي خلال 5 دقائق. تعيش هذه البوابة داخل الخادم — ولا تطّلع عليها واجهة FlipLink API أبداً.

تحمل كل أداة أيضاً تعليقات MCP التوضيحية (readOnlyHint وdestructiveHint وidempotentHint) ليتمكّن العملاء من عرض رسائل الموافقة الخاصة بهم.

الأدوات

تُولَّد الأدوات من مواصفات الواجهة وتُسمّى على نمط <noun>_<verb> — مثل flipbook_publish وflipbook_set_skin وleads_list وcname_add. أما أداة الفحص الصحي الوحيدة على المستوى الأعلى فهي whoami. وللاطلاع على المرجع الكامل لمعطيات كل نقطة نهاية أساسية، راجع وثائق REST API.

الأسئلة الشائعة

ما هو خادم MCP؟: خادم MCP (Model Context Protocol) هو برنامج صغير يشغّله عميل الذكاء الاصطناعي لديك محليًا ليُتيح أدوات للمساعد. يُتيح خادم FlipLink واجهة FlipLink REST API نفسها على هيئة أدوات، فيستطيع Claude أو Cursor أو أي عميل MCP إنشاء الكتيبات وتهيئتها ونشرها باللغة الطبيعية.
ما عملاء الذكاء الاصطناعي المدعومون؟: أي عميل يدعم MCP — بما في ذلك Claude Code وClaude Desktop وCursor وCodex. تضيف FlipLink إلى إعداد mcpServers في العميل، فيُشغّل الخادم عند الطلب عبر npx fliplink-mcp.
ما هي الأنماط readonly وsafe وfull؟: تحدّد الأنماط الأدوات المتاحة. يُتيح readonly 19 أداة للقراءة فقط؛ ويضيف safe (الافتراضي) عمليات الكتابة القابلة للتراجع والتحكم بالوصول ليصل المجموع إلى 79 أداة؛ ويُتيح full الأدوات الـ 87 جميعها، مع وضع أدوات الحذف والتجارة خلف خطوة تأكيد. اضبط النمط عبر FLIPLINK_MCP_MODE.
هل من الآمن أن أدع الذكاء الاصطناعي يُدير كتيباتي؟: نعم. في النمط full، لا تُنفَّذ الإجراءات المُتلِفة (الحذف) والمالية (البيع / التسعير) أبدًا من المحاولة الأولى — يُرجِع الخادم معاينة من سطر واحد ورمز تأكيد قصير الأجل مرتبطًا بالمعطيات نفسها بالضبط، وعلى المساعد أن يؤكّد قبل أن يحدث أي شيء. تعمل وسائل الحماية محليًا؛ وواجهة FlipLink API دون تغيير.
هل أحتاج إلى مفتاح API خاص بي؟: نعم — يوفّر كل مستخدم مفتاحه الخاص من صفحة اشتراك FlipLink، ويُضبَط بوصفه FLIPLINK_API_KEY في الإعداد. وإن كان المفتاح مفقودًا، تُرجِع كل أداة تعليمات إعداد واضحة ليُرشدك المساعد خطوة بخطوة.

واصِل البناء

مرجع REST APIمرجع الواجهات الكامل الذي يغلّفه خادم MCP.أداة سطر الأوامرالواجهة نفسها على هيئة أداة CLI قابلة للبرمجة في الطرفيات وأنظمة CI.نظرة عامة على الوصول البرمجيما يفعله الوصول البرمجي في FlipLink ولمن هو موجَّه.اربط FlipLink بـ Claudeدليل عملي خطوة بخطوة لإعداد MCP مع Claude وغيره من العملاء.