ملاحظات العملاء مباشرة إلى Claude Code وCursor
هذا الدليل للمطوّرين والوكالات الذين يراجع عملاؤهم موقعًا حيًّا أو موقع تجربة. يضغط العميل على عنصر في الموقع ويكتب ما يريد تغييره، ثم يطبّق وكيلك التعديل في مستودعك. آخر تحديث: 19 نوفمبر 2026.
ما تحتاجه
- حساب PinSay، والخطة المجانية متاحة دون بطاقة.
- تطبيق ويب يمكنك إضافة الودجت إليه.
- وكيل برمجة بالذكاء الاصطناعي (Claude Code أو Cursor أو Codex أو opencode) يعمل داخل مستودعك.
الدورة خطوة بخطوة
- يشير عميلك ويقول: يضغط على عنصر في الموقع الحي أو موقع التجربة، ويكتب التعديل أو ينطق به بالعربية أو الإنجليزية أو أي لغة.
- يلتقط PinSay العنصر: مع محدد CSS وقواعد CSS المطبّقة (ومنها القاعدة الغالبة) والمسار وحجم الشاشة ولقطة DOM منقّحة.
- تطلب من وكيلك: في Claude Code أو Cursor أو Codex أو opencode، عبر خادم PinSay MCP أو الأمر
npx @pinsay/cli apply. - يغيّر الوكيل الكود ويُنشئ commit: محليًّا في مستودعك، والخيار
--markيجعل التعليقات «مطبّقة» (Applied). - تراجع وتدفع أنت: تقرأ الفروقات وتدفع الكود حين ترضى عنه.
- يصير التعليق 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.