الدليل

التكامل مع Claude

التكامل مع Claude

v1.11.0+

التكامل مع Claude ميزة تتيح لك إدارة GeckoFlag من خلال محادثة مع Claude، وذلك بإضافة امتداد إلى تطبيق Claude لسطح المكتب (Windows وmacOS). يمكنك البحث في التذاكر والمشاريع وصفحات الويكي والملاحظات وعرضها وإنشاؤها وتحديثها، وتصدير مخطط جانت إلى Excel. يعمل الامتداد على جهاز المستخدم، ويتواصل مباشرة مع GeckoFlag الخاص بالمستخدم فقط. وتُنفَّذ كل العمليات بصلاحيات المستخدم صاحب رمز API.

إعدادات المسؤول

  1. 1افتح الإعدادات في الشريط الجانبي، وانقر على تعديل في بطاقة التكامل مع Claude.شاشة الإعدادات، وتظهر بطاقة “Claude Integration” محاطة بإطار أحمر
  2. 2حدّد تفعيل التكامل مع Claude (وهو معطّل افتراضيًا). وإذا كنت تريد أن ينشئ Claude المحتوى ويعدّله أيضًا، ففعّل السماح بالكتابة كذلك، ثم احفظ. وعند عدم السماح بالكتابة، تصبح كل الرموز للقراءة فقط.شاشة إعدادات التكامل مع Claude، وتظهر خانتا الاختيار “Enable Claude integration” و“Allow writing” محاطتين بإطار أحمر، ويُعرض أسفلهما عدد المستخدمين المسموح لهم وعدد رموز API
  3. 3في المستخدمون، افتح تعديل للمستخدم المعني، وفعّل السماح بالتكامل مع Claude ‏(API)، ثم انقر على تحديث. وهو إعداد منفصل عن “السماح بالتسجيل بمساعدة الذكاء الاصطناعي”. وعند سحب الإذن، تُحذف كل رموز API الخاصة بذلك المستخدم.شاشة تعديل المستخدم، ويظهر “Users” في الشريط الجانبي وخانة الاختيار “Allow Claude integration (API)” محاطين بإطار أحمر

إنشاء رمز API

  1. 1افتح الملف الشخصي في الشريط الجانبي، وفي قسم رموز API، حدّد اسم الرمز ومدة الصلاحية (30 يومًا أو 90 يومًا أو 365 يومًا أو بلا انتهاء؛ والقيمة الافتراضية 90 يومًا) والصلاحية (القراءة فقط أو القراءة والكتابة)، ثم أنشئ الرمز.قسم “API Tokens (Claude Integration)” في شاشة الملف الشخصي، وتظهر حقول Token name وExpires in وPermission محاطة بإطار أحمر
  2. 2انسخ الرمز المعروض (سلسلة تبدأ بـ gfk_). يُعرض الرمز مرة واحدة فقط، بعد إنشائه مباشرة. ودوّن أيضًا “عنوان URL المطلوب إدخاله في الامتداد” المعروض في القسم نفسه.
  • يمكن لكل شخص إنشاء ما يصل إلى 5 رموز، ويمكن حذف الرموز التي لم تعد مستخدمة في أي وقت من الملف الشخصي.
  • عند إنشاء رمز، يتلقى صاحبه رسالة إشعار بالبريد الإلكتروني. وعند تغيير كلمة المرور، تُحذف كل رموز ذلك المستخدم.

الإعداد في تطبيق Claude لسطح المكتب

  1. 1في تطبيق Claude لسطح المكتب، افتح Settings (الإعدادات) ← Extensions (الامتدادات)، واسحب ملف امتداد GeckoFlag ‏(.mcpb) وأفلته، ثم انقر على Install (تثبيت). ويمكنك أيضًا التثبيت بالنقر المزدوج على الملف، أو من Advanced settings (الإعدادات المتقدمة). ويُضمَّن ملف الامتداد في ملف التنزيل الذي تحصل عليه بعد شراء GeckoFlag.
  2. 2أدخل العناصر التالية في شاشة الإعدادات، ثم انقر على Save (حفظ).
    • GeckoFlag URL (مطلوب): عنوان URL الذي دوّنته. يجب أن يبدأ بـ https:// (ولا يُسمح بـ http:// إلا لـ localhost و*.test و*.local).
    • API token (مطلوب): الرمز الذي نسخته. ويُحفظ مُقنَّعًا.
    • Export folder (اختياري): المجلد الذي تُحفظ فيه ملفات Excel لمخطط جانت. إذا تُرك فارغًا، تُحفظ الملفات في مجلد التنزيلات.
    شاشة إعدادات امتداد GeckoFlag، وتضم حقول GeckoFlag URL وAPI token وExport folder
  3. 3اطلب من Claude “تحقّق من اتصالك بـ GeckoFlag”. وإذا عُرض صاحب الرمز وإصدار GeckoFlag وما إذا كانت الكتابة ممكنة، فقد اكتمل الإعداد.

للاطلاع على الخطوات المفصّلة مع لقطات الشاشة، راجع دليل إعداد التكامل مع Claude. ويُوصى بضبط عمليات الكتابة على “التأكيد في كل مرة” ضمن إعدادات الامتداد في Claude.

ما يمكنك فعله

  • التذاكر: البحث (حسب المشروع والحالة والمكلَّف والمُبلِّغ والأولوية والكلمة المفتاحية وتاريخ الاستحقاق والتذكرة الرئيسية)، وعرض التفاصيل والتعليقات، والإنشاء (مع إمكانية تحديد التذكرة الرئيسية ومستلمي الإشعارات)، وتغيير الحقول، ونشر التعليقات، وتغيير الحالة.
  • المشاريع: عرض القائمة والتفاصيل، والإنشاء (لغير الضيوف)، وتغيير الاسم والوصف والمالك والفترة والتبديل بين مكتمل/غير مكتمل، وإضافة الأعضاء وإزالتهم (للمالك والمسؤولين).
  • الويكي: العرض، وإعادة كتابة العنوان والمتن، والإضافة إلى النهاية (لأعضاء المشروع والمسؤولين).
  • الملاحظات: عرض قائمة ملاحظاتك والبحث فيها وقراءتها وإنشاؤها وإعادة كتابتها والإضافة إليها.
  • البيانات الأساسية: إضافة أنواع التذاكر والحالات والأولويات والمسميات الوظيفية (الأقسام)، وتغيير أسمائها وألوانها (للمسؤولين).
  • مخطط جانت: تحويل تذاكر المشروع (حتى 5,000 تذكرة) إلى ملف Excel وحفظه على جهازك. وعندما تتجاوز الفترة 120 يومًا، يصبح كل عمود أسبوعًا واحدًا.
  • البحث عن المستخدمين: البحث عن المستخدمين بالاسم (المعرّف والدور فقط، دون إرجاع عناوين البريد الإلكتروني).

يمكنك الإشارة إلى التذاكر بمفتاح مثل “WEB-12”. وتتطلب الكتابة كلًّا من رمز بصلاحية “القراءة والكتابة” وخيار “السماح بالكتابة” على مستوى الموقع.

القيود والحدود

  • لا يمكن الحذف (المشاريع والتذاكر والتعليقات والبيانات الأساسية والويكي والملاحظات)، ولا تعديل التعليقات، ولا إرفاق الصور والملفات أو عرضها، ولا تغيير مفتاح المشروع، ولا إعادة ترتيب البيانات الأساسية.
  • لا يمكن إضافة المستخدمين أو تعديلهم، ولا تغيير إعدادات الموقع، ولا التعامل مع لوحة كانبان أو الإشارات المرجعية أو إعدادات الإشعارات، ولا عرض ملاحظات المستخدمين الآخرين (حتى للمسؤولين).
  • تُنفَّذ الكتابة عنصرًا واحدًا في كل مرة، وينفّذ Claude العناصر المتعددة واحدًا تلو الآخر. ومهلة انتظار الاستجابة 30 ثانية، ولا تُعاد محاولة عمليات الكتابة تلقائيًا لتجنّب التسجيل المزدوج.
  • عنوان التذكرة حتى 50 حرفًا، وأسماء البيانات الأساسية حتى 20 حرفًا (حتى 10 عناصر لكل نوع، مع الاختيار من بين 8 ألوان). ومتن الويكي حتى 65,535 بايت إجمالًا، ومتن الملاحظة حتى 1,000,000 بايت.
  • يُختصر ما يقرؤه Claude من نصوص عندما تتجاوز الأوصاف والويكي والملاحظات 8,000 حرف، والتعليقات 2,000 حرف. ولا يُعاد كتابة النصوص المختصرة، بل يقترح Claude الإضافة إليها بدلًا من ذلك.
  • يعرض البحث والقوائم حتى 50 عنصرًا في الصفحة الواحدة. وحدّ المعدّل 60 طلبًا في الدقيقة لكل رمز.
  • لا يمكن الاستخدام إلا عندما يكون تطبيق Claude لسطح المكتب قيد التشغيل على جهازك.

السجل ورسائل الإشعار بالبريد الإلكتروني

  • تغيير حقول التذكرة، كما في التعديل من الشاشة، لا يترك تعليقًا في السجل ولا يرسل رسائل بريد إلكتروني. وإذا أردت الاحتفاظ بسجل، فاطلب “أجرِ التغيير كتعليق”.
  • عند تغيير الحالة أو غيرها من خلال تعليق، يُضاف السجل كما في الشاشة، ويتلقى الأعضاء المشتركون في إشعارات جميع التعليقات رسالة بريد إلكتروني.
  • عند إنشاء تذكرة، لا يتلقى رسالة البريد الإلكتروني إلا الأعضاء المحدَّدون كمستلمين للإشعارات. وعند إنشاء مشروع، يتلقى الأعضاء رسالة دعوة بالبريد الإلكتروني (ولا تُرسَل عند الإضافة لاحقًا).
  • تُسجَّل العمليات على أنها عمليات صاحب الرمز، دون أي إشارة إلى أنها “عبر Claude”.

الأمان والتعامل مع البيانات

عندما يكون التكامل مع Claude معطّلًا، تُعامَل واجهة API كعنوان URL غير موجود (404). وتُعامَل المشاريع والتذاكر التي لا تملك صلاحية عليها على أنها “غير موجودة” أيضًا. ولا يُخزَّن على الخادم سوى القيمة المجزّأة (hash) للرمز، ويسري تقييد الوصول حسب عنوان IP في GeckoFlag على واجهة API أيضًا. ويُرسَل محتوى التذاكر والويكي والملاحظات الذي يقرؤه Claude إلى Anthropic كجزء من المحادثة. وقبل البدء في الاستخدام، تأكد من أن لوائح شركتك أو عقودك مع العملاء لا تقيّد الإرسال إلى خدمات خارجية. وإذا تعذّر الاتصال، فراجع استكشاف الأخطاء وإصلاحها.