ملاحظات العملاء مباشرة إلى Claude Code وCursor

هذا الدليل للمطوّرين والوكالات الذين يراجع عملاؤهم موقعًا حيًّا أو موقع تجربة. يضغط العميل على عنصر في الموقع ويكتب ما يريد تغييره، ثم يطبّق وكيلك التعديل في مستودعك. آخر تحديث: 19 نوفمبر 2026.

ابدأ مجانًا شاهد كيف تعمل الدورة

ما تحتاجه

  • حساب PinSay، والخطة المجانية متاحة دون بطاقة.
  • تطبيق ويب يمكنك إضافة الودجت إليه.
  • وكيل برمجة بالذكاء الاصطناعي (Claude Code أو Cursor أو Codex أو opencode) يعمل داخل مستودعك.

الدورة خطوة بخطوة

  1. يشير عميلك ويقول: يضغط على عنصر في الموقع الحي أو موقع التجربة، ويكتب التعديل أو ينطق به بالعربية أو الإنجليزية أو أي لغة.
  2. يلتقط PinSay العنصر: مع محدد CSS وقواعد CSS المطبّقة (ومنها القاعدة الغالبة) والمسار وحجم الشاشة ولقطة DOM منقّحة.
  3. تطلب من وكيلك: في Claude Code أو Cursor أو Codex أو opencode، عبر خادم PinSay MCP أو الأمر npx @pinsay/cli apply.
  4. يغيّر الوكيل الكود ويُنشئ commit: محليًّا في مستودعك، والخيار --mark يجعل التعليقات «مطبّقة» (Applied).
  5. تراجع وتدفع أنت: تقرأ الفروقات وتدفع الكود حين ترضى عنه.
  6. يصير التعليق Live: بعد نشر موقعك، يحوّل الأمر npx @pinsay/cli status --deployed الحالة من Applied إلى Live.

إعداد Claude Code

شغّل هذا الأمر في الطرفية، ثم في Claude Code نفّذ /mcp واختر pinsay ثم Authenticate.

claude mcp add --transport http pinsay https://app.pinsay.dev/mcp

وإن فضّلت مفتاح API (بصلاحيتَي القراءة والتطبيق، وأبقِه خارج git):

claude mcp add --transport http pinsay https://app.pinsay.dev/mcp --header "Authorization: Bearer $PINSAY_API_KEY"

ولتثبيت الودجت ومهارات الوكيل في مشروعك شغّل:

npx @pinsay/cli@latest init

إعداد Cursor

ضع هذا في الملف .cursor/mcp.json داخل مشروعك، أو في ~/.cursor/mcp.json لكل المشاريع. وعند أول اتصال يفتح Cursor متصفحك لتختار مساحة العمل وتوافق.

{
  "mcpServers": {
    "pinsay": {
      "url": "https://app.pinsay.dev/mcp"
    }
  }
}

دون MCP: الـ CLI

شغّل npx @pinsay/cli apply ليبني أمر التطبيق لأي وكيل يستطيع تشغيل أمر في الطرفية.

وشغّل npx @pinsay/cli apply --mark ليُنشئ commit ويسجّل التعليقات على أنها مطبّقة.

ما لا يفعله PinSay أبدًا

  • PinSay لا يشغّل وكيل البرمجة ولا يعدّل كودك: وكيلك هو من يفعل ذلك على جهازك.
  • PinSay لا يرفع التغييرات (push) إلى مستودعك البعيد أبدًا.
  • PinSay لا ينشر ولا يلمس خوادم الإنتاج لديك.
  • لا يُرفع كودك المصدري أبدًا: يحمل التعليق لقطة منقّحة فقط من الصفحة المثبّت عليها.

المصادر

الأوامر من وثائق PinSay (/docs/mcp.html و/docs/apply.html و/docs/deployments.html)، تمت المراجعة في 19 نوفمبر 2026.

هل أنت مستعد لتترك وكيل الذكاء الاصطناعي يطبّق ملاحظات الواجهة؟

الإعداد في دقيقة واحدة. ابدأ بالخطة المجانية مع فريقك كله.

ابدأ مجانًا