خادم Linkly MCP

يتيح لك خادم Linkly MCP توصيل مساعدات ذكية بحسابك على Linkly باستخدام Model Context Protocol. بمجرد الاتصال، يمكنك إنشاء وإدارة الروابط القصيرة من خلال المحادثة الطبيعية.

ما هو MCP؟

Model Context Protocol (MCP) هو معيار مفتوح يسمح للمساعدات الذكية بالاتصال الآمن بالأدوات والمصادر الخارجية. بدلاً من نسخ واللصق بين التطبيقات، يمكنك طلب من مساعدك الذكي تنفيذ الإجراءات مباشرة.

المساعدات الذكية المدعومة

يعمل خادم Linkly MCP مع:

• Claude Desktop
• ChatGPT Desktop
• عملاء آخرون متوافقون مع MCP (Cursor, Windsurf, إلخ)

أين تجده

يتم إدراج خادم Linkly MCP في دليل MCP الرئيسي، لذا يمكنك تثبيته من حيث تبحث بالفعل عن الموصلات:

• دليل موصل Claude — اتصال بنقرة واحدة في Claude (الويب وسطح المكتب)
• سجل MCP الرسمي — com.linklyhq/linkly
• Smithery
• Glama
• mcp.so
• ClaudePluginHub — إضافة Linkly لـ Claude Code و Cowork
• المصدر على GitHub — مرخص تحت MIT

خادم MCP أم Linkly CLI؟

إذا كان مساعدك الذكي وكيل ترميز يمكنه تشغيل أوامر shell — مثل Claude Code أو Cursor — فإن Linkly CLI غالباً ما يكون خياراً أفضل من خادم MCP. وكلاء الترميز معتادون بالفعل على قيادة أدوات سطر الأوامر، وتوفر واجهة سطر الأوامر إخراج --json على كل أمر بالإضافة إلى أمر linkly schema الذي يطبع شجرة الأوامر الكاملة، حتى يتمكن الوكيل من اكتشاف كل ما يمكنه فعله. يبقى خادم MCP الخيار الأفضل للمساعدات التي لا يمكنها تشغيل أوامر shell، مثل Claude Desktop و ChatGPT Desktop.

ما يمكنك فعله

بمجرد الاتصال، يمكنك طلب من مساعدك الذكي:

• إنشاء روابط قصيرة - "إنشاء رابط قصير لـ https://example.com"
• تتبع الأداء - "كم عدد النقرات التي حصلت عليها روابطي هذا الأسبوع؟"
• إدارة الروابط - "تحديث الرابط المسمى 'promo' برابط وجهة جديد"
• عرض التحليلات - "أظهر لي النقرات حسب الدولة لآخر 30 يوماً"
• البحث عن الروابط - "ابحث عن جميع الروابط المتعلقة بإطلاق المنتج"
• إدارة النطاقات - "اسرد نطاقاتي المخصصة"
• إعداد Webhooks - "اشترك في https://my-site.com/webhook لاستقبال أحداث النقر"

البدء

يقع خادم Linkly MCP المستضاف على https://mcp.linklyhq.com. لا توجد حاجة لتثبيت أي شيء ولا مفتاح API لنسخه — يستخدم الخادم OAuth، لذا عند اتصال مساعدك الذكي للمرة الأولى، ستفتح نافذة المتصفح تطلب منك تسجيل الدخول إلى Linkly والموافقة على الوصول. بعد ذلك، يبقى مساعدك متصلاً.

https://mcp.linklyhq.com

الإعدادات

Claude Desktop

في Claude Desktop، انتقل إلى Settings → Connectors → Add custom connector. أدخل اسماً (Linkly) وعنوان URL لخادم MCP البعيد:

https://mcp.linklyhq.com

انقر على Add، ثم Connect على موصل Linkly. ستفتح علامة تبويب متصفح لتسجيل الدخول والموافقة على الوصول. ثم يبقى Claude Desktop متصلاً — لا توجد حاجة لملف config أو أدوات إضافية.

Claude Code (CLI)

Claude Code يدعم خوادم MCP البعيدة بشكل أصلي. أضف Linkly بأمر واحد:

claude mcp add --transport http linkly https://mcp.linklyhq.com

ثم قم بتشغيل /mcp داخل Claude Code، واختر linkly، وقم بالمصادقة في المتصفح عند المطالبة.

ChatGPT Desktop

افتح ملف إعدادات ChatGPT الخاص بك:

• macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
• Windows: %APPDATA%\ChatGPT\mcp_servers.json

أضف خادم Linkly MCP:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

الأدوات المتاحة

خيارات إنشاء الرابط

عند إنشاء روابط، يمكنك تحديد:

• الأساسي: url, name, note, domain, slug, enabled
• معاملات UTM: utm_source, utm_medium, utm_campaign, utm_term, utm_content
• Open Graph: og_title, og_description, og_image
• التتبع: fb_pixel_id, ga4_tag_id, gtm_id
• متقدم: cloaking, forward_params, block_bots, hide_referrer
• انتهاء الصلاحية: expiry_datetime, expiry_destination

استكشاف الأخطاء والإصلاح

"Could not connect to MCP server"

• تأكد من أن https://mcp.linklyhq.com يمكن الوصول إليه من جهازك
• في Claude Code، قم بتشغيل /mcp واختر linkly لإعادة تشغيل تدفق OAuth

"Authentication failed", "invalid_client"، أو المتصفح يستمر في طلب تسجيل الدخول

هذا يعني أن عميلك يحتفظ بتسجيل اتصال قديم. امسح بيانات الاعتماد المخزنة مؤقتاً وأعد المصادقة. في Claude Code، قم بتشغيل /mcp → linkly → إعادة الاتصال. في Claude Desktop، قم بإزالة موصل Linkly ضمن Settings → Connectors وأضفه مرة أخرى، ثم قم بتسجيل الدخول مجدداً.

الأدوات لا تظهر

• أعد تشغيل مساعدك الذكي بعد حفظ الإعدادات
• تحقق من أن بناء الجملة JSON في ملف الإعدادات الخاص بك صحيح
• تحقق من أن خادم MCP قيد التشغيل (ابحث عن رمز الأدوات في مساعدك)

الموارد ذات الصلة

• Claude Desktop Integration
• ChatGPT Integration
• Linkly API Documentation
• Linkly CLI
• Webhooks
• Model Context Protocol