خادم Linkly MCP

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

ما هو MCP؟

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

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

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

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

خادم MCP أم واجهة سطر الأوامر Linkly؟

إذا كان مساعدك الذكي عبارة عن وكيل ترميز يمكنه تشغيل أوامر shell — مثل Claude Code أو Cursor — فإن واجهة سطر الأوامر Linkly غالباً ما تكون خياراً أفضل من خادم 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 متصلاً بعد ذلك — لا توجد حاجة لملف إعداد أو أدوات إضافية.

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