ربط Claude بـ Nordlet

هذا الدليل مخصص للمستخدمين الذين يرغبون في تمكين Claude من العمل مع دفاترهم المحاسبية في Nordlet. يتصل Claude بـ خادم Nordlet MCP على الرابط https://api.nordlet.com/mcp. يمكنك السماح بالاتصال مرة واحدة فقط عبر صفحة مخصصة في Nordlet، ولن تحتاج إلى نسخ أي مفتاح.

1. إنشاء حساب Nordlet

1. افتح الرابط app.nordlet.com وأدخل بريدك الإلكتروني.
2. وافق على شروط الخدمة، وسياسة الخصوصية، واتفاقية معالجة البيانات. سيرسل لك Nordlet رابط تسجيل دخول صالحاً لمدة 15 دقيقة وقابلاً للاستخدام مرة واحدة فقط، إذ لا توجد كلمات مرور.
3. افتح الرابط، واختر باقة الاشتراكات: إما الباقة الثابتة التي تبدأ بفترة تجريبية مجانية، أو الدفع حسب الطلب مع أول عملية شحن رصيد.
4. أنشئ شركتك بإدخال: الاسم، والدولة، ورقم التسجيل، والرقم الضريبي (VAT code). لتجربة النظام أولاً، حدد خيار شركة تجريبية (Sandbox company). تحتوي هذه النسخة على بيانات اختبارية ويمكن حذفها في أي وقت.

يمكنك الانضمام إلى عدة شركات: شركتك الخاصة، والشركات التي دُعيت إليها من قِبل مالكيها. يحدد دورك في كل شركة (مالك، أو مسؤول، أو محاسب، أو مدير، أو مطور، أو مستعرض) الصلاحيات المتاحة لك، ويحصل Claude على نفس الصلاحيات تماماً.

2. ربط Claude

1. أضف موصلاً مخصصاً (custom connector) في Claude بالعنوان https://api.nordlet.com/mcp، واترك حقول المصادقة فارغة.
2. سيفتح Claude صفحة تابعة لـ Nordlet. وإذا لم تكن مسجلاً الدخول، سيطلب منك Nordlet إدخال بريدك الإلكتروني ليُرسل لك رابط تسجيل الدخول. افتح الرابط في نفس المتصفح للعودة إلى الصفحة المطلوبة.
3. تعرض الصفحة اسم التطبيق الذي يطلب حق الوصول والعنوان الذي ستعود إليه. تحقق من كليهما، ثم اختر سماح (Allow). سيؤدي اختيار رفض (Deny) إلى إعادتك دون منح حق الوصول.
4. بعد عودتك إلى Claude، ستجد أن الموصل قد تم ربطه بنجاح.

يقوم Claude بتجديد حق الوصول تلقائياً؛ إذ صلاحية رمز الوصول (access token) ساعة واحدة، ويستبدله Claude برمز جديد دون مطالبتك بأي إجراء.

3. ربط Claude Code

قم بتشغيل الأمر التالي:

claude mcp add --transport http nordlet https://api.nordlet.com/mcp

بعد ذلك، شغل الأمر /mcp داخل Claude Code واختر مصادقة خادم nordlet. سيفتح متصفحك نفس صفحة Nordlet المذكورة في الخطوة 2. وبعد النقر على سماح (Allow)، سيعيدك المتصفح إلى Claude Code على حاسوبك الشخصي.

4. العمل في شركاتك

يعمل اتصال واحد عبر جميع الشركات التي تنتمي إليها. يبدأ Claude بسرد شركاتك، ثم يحدد اسم الشركة في كل طلب. اطلب تنفيذ العمليات باسم الشركة، مثل "أصدر هذه الفاتورة لصالح شركة UAB Pavyzdys". وعند إضافتك إلى شركة جديدة، يمكن لـ Claude العمل فيها فوراً، بينما يفقد القدرة على العمل فيها بمجرد إزالتك منها.

تُعد كل عملية يقوم بها Claude طلباً عادياً عبر واجهة برمجة التطبيقات (API request) وتحتسب كأي طلب آخر، كما يتم تسجيل كافة التعديلات التي يجريها في سجل التدقيق (audit log).

5. قطع الاتصال

1. في Nordlet، افتح قسم الحساب (Account) ثم المطورين (Developers). ستجد الاتصال مدرجاً ضمن مفاتيح واجهة برمجة التطبيقات (API keys) الخاصة بك تحت اسم التطبيق، مثل "Claude".
2. اختر إلغاء (Revoke)، وسيفقد Claude حق الوصول فوراً في جميع الشركات.

ولإعادة الاتصال لاحقاً، ما عليك سوى تكرار الخطوة 2.

استخدام مفتاح واجهة برمجة التطبيقات بدلاً من ذلك

يمكن للمالكي، والمسؤولين، والمطورين إنشاء مفتاح واجهة برمجة التطبيقات (API key) عبر قسم الحساب (Account) ثم المطورين (Developers)، وإرساله كرأس طلب (header). راجع قسم خادم MCP.