الإجابة عن سؤال «هل يمكنني ربط Etsy بـClaude؟» هي نعم، وهناك أربع طرق للقيام بذلك. لكنها ليست متكافئة. تختلف في قدرة الاتصال على الكتابة، وفي المكان الذي تُحفظ فيه بيانات اعتماد Etsy. ثم تتوقف الطرق الأربع عند الباب نفسه، الذي تميل أدلة الإعداد إلى تجاوزه بجملة واحدة.
المسارات الأربعة
دليل موصلات Claude. لا شيء للربط. Etsy غير موجودة فيه، ولم تُصدر خادم MCP خاصًا بها، لذا فهذا ليس مسارًا متاحًا بعد.
خادم MCP مجتمعي. توجد عدة خوادم على GitHub، مبنية على Open API v3 الخاصة بـEtsy. تشغّل الخادم على جهازك وتسجله لدى عميلك، وتوفر بيانات اعتماد API بنفسك.
MCP مستضاف أو منصة تكامل. تعمل خدمات هذا النوع وسيطًا بين Claude وEtsy، وإعدادها هو الأقصر بين الخيارات الأربعة. ويصاحب ذلك أمران: تُحفظ بيانات اعتماد Etsy على بنيتها التحتية، والعديد منها مخصص للقراءة فقط بحكم التصميم.
عميل لسطح المكتب يتضمن الموصل. ينتمي Orkas إلى هذا النوع. وهو يستدعي https://openapi.etsy.com/v3/application مباشرة من جهازك، لذا لا يوجد خادم MCP لتشغيله ولا وسيط بين الطرفين.
الباب الذي تتوقف عنده المسارات الأربعة
ليست Open API v3 الخاصة بـEtsy مفتوحة بمعنى «احصل على مفتاح وابدأ الاستدعاء». تتطلب قراءة متجرك أو الكتابة إليه تطبيقًا معتمدًا من أجل الوصول إلى API البائعين. يستطيع البائعون الأفراد التقدم بطلب من خلال Etsy Developers → تطبيقاتك؛ ولا تحتاج إلى شركة للقيام بذلك.
ستحصل على ثلاث قيم، وإحداها تكلّف بعض الناس فترة ما بعد الظهر كاملة:
سلسلة المفتاح و السر المشترك تحصل عليهما مباشرة من صفحة تفاصيل تطبيقك. معرّف المتجر هو المعرّف الرقمي، وليس اسم متجرك — وعنوان URL العام لمتجرك يتضمن الاسم، لا المعرّف. والطريقة الموثّقة لاستخراجه هي نقطة النهاية findShops التي تبحث باسم المتجر وتعيد shop_id في النتيجة. يجب توثيق ذلك الاستدعاء باستخدام سلسلة المفتاح والسر المشترك اللذين حصلت عليهما للتو، لذا فالترتيب مهم: التطبيق أولًا، ثم بيانات الاعتماد، ثم استخدامهما للبحث عن معرّف متجرك.
إحدى الخطوات أسهل مما تبدو عند قراءتها. تطلب منك Etsy تسجيل عنوان لإعادة التوجيه للتطبيق، وهو ما يبدو كأنك تحتاج إلى تشغيل خادم. لكنك لا تحتاج إلى ذلك — بل تسجل العنوان الذي يستخدمه عميلك. يستخدم Orkas https://orkas.ai/api/connectors/oauth/dcr-callback؛ تلصقه في حقل عنوان URI لإعادة التوجيه، وهذه هي الخطوة بأكملها.
لن ننشر مدة متوقعة للموافقة. لا تلتزم Etsy بمدة، والأرقام المذكورة في المنتديات تجارب فردية لا جدولًا زمنيًا. تعامل معها كخطوة فعلية لا كإجراء شكلي، وابدأ بها قبل البدء في تقييم العملاء. إن وثائق المصادقة الرسمية الخاصة بـEtsy هي ما يستحق القراءة أثناء الانتظار.
القراءة ليست الكتابة
بعد توفر بيانات الاعتماد، لا تعود المسارات متكافئة. السؤال عن عدد الطلبات الواردة الأسبوع الماضي قراءة. أما تغيير سعر، أو تجديد إعلان منتج، أو تحديث المخزون، أو تبديل ملف شحن فهو كتابة، ويحتاج إلى نطاقات الصلاحيات المطابقة.
هذا هو الفرق الذي تتجاوزه معظم المقالات عن «ربط Etsy بـClaude». الموصل المستضاف الذي يجيب عن أسئلة بالإنجليزية العادية حول بيانات متجرك مفيد فعلًا ومخصص فعلًا للقراءة فقط؛ اطلب منه إصلاح اثنتي عشرة صفحة منتج ولن يحدث شيء. تحقق من إمكانات الكتابة قبل الاختيار، لأن الجهد المطلوب لطلب الموافقة قبل ذلك متطابق في الحالتين.
يغطي موصل Orkas المتجر وصفحات المنتجات والمخزون وتنفيذ الطلبات وملفات الشحن وأقسام المتجر — في جانبي القراءة والكتابة. تُشفّر بيانات الاعتماد على جهازك بدلًا من حفظها في ملف إعدادات أو على خوادم جهة أخرى، وكل عملية كتابة إلى متجر فعلي تمر عبر طلب إذن في العميل بدلًا من الاعتماد على حذر النموذج.
متى لا تستخدم هذا
أربع حالات يكون فيها خيار آخر أنسب. تريد طرح الأسئلة فقط: الموصل المستضاف يتطلب جهدًا أقل، ولا يوجد شيء لتثبيته. تريد تشغيله دون إشراف وفق جدول زمني: Orkas تطبيق لسطح المكتب، لذا يتوقف عند إغلاق النافذة؛ والمهمة المجدولة على خادم هي الحل المناسب. تريد أن تُطلق Etsy مسارات عمل عبر عشرات الخدمات الأخرى: منصات التكامل مصممة لهذا الغرض، أما هذا فليس كذلك. تريد تغيير العناوين أو الأسعار أو الوسوم جماعيًا: أداة التعديل الجماعي المدمجة في Shop Manager لدى Etsy تفعل ذلك بالفعل، من دون أي طلب للحصول على صلاحية API. لا تثبّت أي شيء لهذا الغرض.
ما يحلّ محله مسار تطبيق سطح المكتب ليس أدوات Etsy نفسها، بل كومة الخدمات الصغيرة التي كنت ستضعها بين متجرك والنموذج، وتحتفظ كل منها بنسختها الخاصة من بيانات اعتمادك. الدليل نفسه يغطي eBay، Walmart Marketplace، Amazon Seller Central، Shopify, WooCommerce والمنصات الصينية، كي لا تتكرر تلك الكومة مع كل واجهة متجر.