بدء سريع

يأخذك هذا الدليل من تطبيق قائم إلى مساعد Syncanix يعمل فعليًا: اكتشِف واجهة برمجة التطبيقات لديك، وراجع ما يستطيع المساعد فعله، واربط الخادم الخلفي، وضمّن الأداة، ورقِّ إلى الإنتاج. تنجزه معظم الفرق في نحو 90 دقيقة.

قبل أن تبدأ

• Node.js الإصدار 20 أو أحدث.
• واجهة برمجة تطبيقات HTTP قائمة فيها نقطة نهاية واحدة على الأقل مُصادَق عليها.
• مزوّد هوية لمستخدميك — Auth0 أو Clerk أو Cognito أو WorkOS أو OIDC الخاص بك.
• مفتاح من Anthropic أو OpenAI أو AWS Bedrock-EU — أو استخدم مفتاحًا مُدارًا (تُطبَّق زيادة بسيطة على بعض الخطط).

١. اكتشف واجهة برمجة التطبيقات لديك

شغّل أداة سطر الأوامر في مشروعك. تكتشف إطار العمل لديك، وتقرأ مساراتك، وتكتب كتالوج قدرات وترفعه. الاكتشاف ثابت افتراضيًا — فهو يقرأ شيفرتك ولا يشغّلها، ولا تغادر أي بيانات إنتاجية جهازك.

npx syncanix init

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

٢. راجع الكتالوج

افتح لوحة التحكم لرؤية ما اكتُشِف. هنا تقرّر ما الذي يستطيع المساعد فعله، وبأي قدر من الحذر:

• حدِّد نقاط النهاية الداخلية كي تبقى بعيدة عن متناول المساعد.
• حدِّد أثر كل إجراء — قراءة أو كتابة أو إجراء مدمِّر — وهو ما يتحكّم في كيفية تأكيده.
• اشترط المصادقة المعزَّزة على الإجراءات الحسّاسة، كي يعيد المستخدم تأكيد هويته قبل تنفيذها.

٣. اربط الخادم الخلفي لديك

أضِف حزمة Node SDK إلى الخدمة التي تملك واجهة برمجة التطبيقات لديك. تحلّ مفتاحك وتُقلِع في أجزاء قليلة من الثانية:

npm install @syncanix/sdk-node

import { init } from '@syncanix/sdk-node';

// Resolves your API key from SYNCANIX_API_KEY, ~/.syncanix/credentials,
// or an inline { apiKey } — in that order.
const { environment, bootDurationMs } = await init({ environment: 'development' });
console.log(`Syncanix booted in ${bootDurationMs.toFixed(1)}ms`);

يمكنك أيضًا تسجيل أدوات أصيلة في الـ SDK — إجراءات يستطيع المساعد استدعاءها وليست مسارات HTTP عادية. وتُنفَّذ كل منها بهوية المستخدم النهائي التي يوفّرها مزوّد الهوية لديك:

import { createToolRegistry } from '@syncanix/sdk-node';

const registry = createToolRegistry();

registry.tool({
  name: 'refund-order',
  description: 'Refund a customer order. Requires an admin role.',
  handler: async ({ orderId, amountCents }, ctx) => {
    // ctx.userId is the verified end user from your identity provider.
    return payments.refund({ orderId, amountCents, actor: ctx.userId });
  },
});

٤. ضمّن الأداة

أضِف وسم سكربت واحدًا إلى تطبيقك باستخدام مفتاحك القابل للنشر:

<script
  type="module"
  src="https://cdn.syncanix.com/widget.js"
  data-key="pk_live_..."
></script>

هذا كل شيء. تُحمَّل الأداة على نحوٍ مؤجَّل، وتعمل داخل Shadow DOM كي لا تتعارض أنماطك وأنماطنا أبدًا، وتلتقط هويتك التجارية تلقائيًا، وهي جاهزة للكتابة من اليمين إلى اليسار.

٥. اربط عميل MCP (اختياري)

في خطط Growth وما فوقها، تحصل كل مساحة عمل أيضًا على خادم MCP خاص بها، كي يصل مستخدموك إلى القدرات نفسها من Claude Desktop وCursor وChatGPT. ويُفوَّض تسجيل الدخول إلى مزوّد الهوية لديك.

٦. رقِّ إلى الإنتاج

عندما ترضى عن سلوك المساعد في التطوير، رقِّه إلى الإنتاج من لوحة التحكم. تعمل أولًا بوابة تقييم تمنع الترقية إذا تراجعت الجودة، بحيث لا يتغيّر الإنتاج إلا نحو الأفضل.

ما لديك الآن

• مساعد مضمَّن في تطبيقك يجيب عن الأسئلة وينفّذ إجراءاتك.
• خادم MCP لكل مساحة عمل من أجل Claude Desktop وCursor وChatGPT (Growth وما فوق).
• سجلّ تدقيق لكل إجراء وكل ترقية وكل تغيير إداري.
• كل شيء مستضاف في الاتحاد الأوروبي، مع تشفير بياناتك أثناء التخزين.

الخطوات التالية