ربط Claude Code باستوديوك

ما هو

Claude Code هو Claude من Anthropic، ويعمل في طرفية الكمبيوتر. باستخدام موصل الذكاء الاصطناعي، يمكنه الاطلاع على بيانات استوديوك (المبيعات والعملاء والمواعيد والشؤون المالية) عندما تطرح عليه سؤالًا، وفقًا لصلاحيات المستخدم المرتبطة بالمفتاح. يقتصر دوره على الاطلاع، ولا يغيّر أي شيء في النظام.

متى تستخدمه

إذا كنت تستخدم Claude Code على الكمبيوتر بالفعل وتريد الاستفسار عن نشاط الاستوديو من دون مغادرته.
إذا أردت إعداد ملخص أو جدول بيانات بأرقام النظام، باستخدام طلبات باللغة العادية.

قبل أن تبدأ

جهّز عنوان الموصل الذي نسخته وفقًا للمقالة ربط أداة الذكاء الاصطناعي. يجب تثبيت Claude Code على الكمبيوتر. يتصل عبر تسجيل الدخول إلى النظام؛ ومفتاح API اختياري لمن يفضّلون عدم استخدام تسجيل الدخول (مثلًا، على جهاز لا يحتوي على متصفح).

خطوة بخطوة

الخطوة 1 — إضافة الموصل

في الطرفية، نفّذ الأمر أدناه، واستبدل العنوان بالعنوان الذي نسخته من نسخ العنوان:

claude mcp add --transport http heya https://seu-dominio/mcp

في Claude Code، اكتب /mcp، واختر heya ثم خيار المصادقة. ستُفتح صفحة تسجيل الدخول إلى النظام في المتصفح. سجّل الدخول، واختر الشركة، ثم انقر على تفويض.

إذا كنت تفضّل استخدام مفتاح API (الذي أنشأته مع تفعيل السماح بالاستخدام كموصل ذكاء اصطناعي)، فأضف الترويسة إلى الأمر: --header "Authorization: Bearer hk_...".

لاستخدام الموصل في جميع المجلدات على الكمبيوتر، وليس في المجلد الحالي فقط، أضف --scope user إلى الأمر.

الخطوة 2 — التحقق من الاتصال

نفّذ claude mcp list. من المفترض أن يظهر الموصل heya على أنه متصل. ويعرض الأمر /mcp الشيء نفسه داخل Claude Code.

الخطوة 3 — طرح سؤال

افتح Claude Code واطرح سؤالًا مثل: «كم بلغت مبيعاتي أمس في الاستوديو؟». في المرة الأولى، قد يطلب منك Claude الموافقة على استخدام أدوات الموصل.

ماذا يحدث بعد ذلك

يبحث Claude عن الاستعلام المناسب للسؤال، وينفّذه، ثم يجيب بأرقام النظام.
يظهر المفتاح في علامة التبويب مفتاح API، مع تحديث آخر استخدام.
لإلغاء الوصول، أبطِل المفتاح في علامة التبويب مفتاح API؛ وسيفقد Claude Code إمكانية الوصول خلال 30 ثانية.

أخطاء شائعة وأسئلة

س: يعرض claude mcp list الرسالة “Failed to connect”. ماذا أفعل؟ ج: تحقّق من أن العنوان ينتهي بـ /mcp ومن أنك لصقت المفتاح كاملًا، بما في ذلك Bearer والمسافة التي تليه. يحفظ الأمر الإعدادات من دون اختبار المفتاح؛ لذلك لا يظهر الخطأ إلا عندما يحاول Claude الاتصال.

س: يقول Claude إن المفتاح يجب أن يتضمن خيار “Permitir uso como conector de IA”. لماذا؟ ج: أُنشئ المفتاح من دون هذا الخيار. عدّل المفتاح في علامة التبويب مفتاح API وحدد السماح بالاستخدام كموصل ذكاء اصطناعي.

س: كيف أغيّر المفتاح؟ ج: أزِل الموصل باستخدام claude mcp remove heya، ثم أضِفه مجددًا باستخدام المفتاح الجديد.

س: هل يمكنني مشاركة الإعدادات مع فريقي عبر مستودع الملفات؟ ج: لا تضع المفتاح في ملف مشترك؛ إذ يحفظ --scope project الإعدادات في .mcp.json. يجب على كل شخص استخدام مفتاحه الخاص، وفقًا لصلاحيات حسابه.

س: قال Claude إنه لم يعثر على معلومة أراها في النظام. لماذا؟ ج: لا يملك المستخدم المرتبط بالمفتاح صلاحية الوصول إلى تلك الشاشة، أو أنها مستثناة من الموصل لأسباب أمنية (محادثات WhatsApp، وسجل الحالة، والصور، والحساب الرقمي). راجع مقالة موصل الذكاء الاصطناعي.