وقتی مرکز کار توسعهدهنده ویرایشگر است اما مدیریت پروژه در مرورگر مانده
ساعت ده و نیم صبح است. توسعهدهنده روی درخواست ادغام کار میکند. مدیر پروژه در پیامرسان تیم میپرسد: «تسک AUTH-442 هنوز در حال انجام است؟» برای پاسخ باید مرورگر را باز کند، وارد شود، بورد را فیلتر کند، وضعیت را عوض کند و برگردد — حدود بیست دقیقه تمرکز عمیق از بین میرود. این تعویض زمینه روزی چند بار تکرار میشود.
Cursor با پروتکل زمینهٔ مدل (MCP) این اصطکاک را کم میکند. سرور MCP در WKFGo را در Cursor پیکربندی میکنید و از پنل گفتوگو میگویید: «وضعیت AUTH-442 را مسدود کن و مانع را در کامنت بنویس.» مدل ابزارهای بهروزرسانی وضعیت (update_status) و ایجاد کامنت (create_comment) را با کلید شخصی شما صدا میزند — بدون ترک ویرایشگر.
علائم و هزینهٔ جدا افتادن ویرایشگر از بورد
| علامت | هزینهٔ پنهان |
|---|---|
| بهروزرسانی وضعیت «بعد از ادغام» به تعویق میافتد | بورد همیشه یک روز عقب است |
| دیدن تسک جدید یعنی چند تب و ورود دوباره | از دست رفتن کار عمیق |
| بازبینی کد بدون معیار پذیرش تسک | کار مجدد در اسپرینت بعدی |
| مدیر پروژه از توسعهدهنده تصویر صفحه میخواهد | اعتماد به سیگنال بورد پایین میآید |
هزینه فقط وقت نیست — کیفیت سیگنال بورد پایین میآید و جلسهٔ وضعیت روی دادهٔ کهنه برگزار میشود. وقتی وضعیت در مسیر کدنویسی ثبت نشود، کانبان تزئینی میشود.
راهاندازی Cursor با WKFGo — پنج مرحله
۱. کلید شخصی بسازید
در WKFGo بروید به تنظیمات → یکپارچهسازی → اتصال IDE هوش مصنوعی. کلید با پیشوند wk_ را کپی کنید. هر نفر کلید خودش را دارد — کلید ادمین مشترک در پیکربندی تیم نگذارید. در خروج همکار همان کلید را لغو کنید.
۲. پیکربندی سرور MCP در Cursor
از تنظیمات Cursor بخش MCP را باز کنید و سرور WKFGo را با آدرس نمونه و هدر احراز هویت اضافه کنید. مسیر دقیق و نمونهٔ فایل در مستندات API و MCP آمده است. فایل کلید را به مخزن کد نسپارید.
۳. آزمایش فقطخواندنی
بپرسید: «با فهرست تسکها (list_tasks) تسکهای محولشده به من را نشان بده.» نامها باید با داشبورد همخوان باشند. اگر «ممنوع» آمد، دسترسی ویژگی (FeatureAccess) یا نقش پروژه را اصلاح کنید — با کلید ادمین دور نزنید.
۴. حلقهٔ استاندارد توسعه کنار کد
- بستهٔ زمینه (
get_context_pack) — معیار پذیرش، ویکی، وابستگیها - شروع کار (
start_work) — ثبت آغاز جلسه - کدنویسی در Cursor
- ارسال برای بازبینی (
submit_for_review) — وقتی درخواست ادغام آماده است - پایان کار (
end_work) — بستن جلسه
زمینه کنار کد میماند؛ بهروزرسانی بورد دیگر کار جداگانهٔ عصر نیست.
۵. کتابخانهٔ پرسش در ویکی تیم
سه قالب ثابت ثبت کنید:
- صبح: برنامهٔ امروز من (
my_day) - قبل از درخواست ادغام:
get_context_pack - پایان روز: بهروزرسانی پیشرفت (
update_progress)
هر ماه قالبها را با سوالات واقعی تیم بهروز کنید.
گردشکارهای عملی در Cursor
صبح: «my_day را صدا بزن و سه اولویت امروز را توضیح بده.»
میانهٔ اسپرینت: «با list_tasks تسکهای معوق با برچسب امنیتی را پیدا کن.»
قبل از انتشار: «فهرست تأییدهای در انتظار (list_pending_approvals) را نشان بده.»
بعد از رفع اشکال: «وضعیت را انجامشده کن و با ثبت زمان (log_time) دو ساعت ثبت کن.»
دانش کنار کد: «با جستوجوی مستندات (search_docs) راهنمای استقرار را پیدا کن.»
ضدالگوها
- گذاشتن کلید ادمین در مخزن — فوراً لغو و چرخش کلید
- نوشتن روی بورد از روز اول بدون تأیید انسان
- راهاندازی فقط برای یک نفر — بقیه در پیامرسان وضعیت میپرسند
- نادیده گرفتن «ممنوع» — مسئلهٔ مجوز است، نه باگ MCP
- چسباندن خروجی اکسل بهجای فراخوانی زنده
ابزارهای WKFGo در Cursor
| نیاز | ابزار MCP با معنی فارسی |
|---|---|
| صف امروز | my_day (برنامهٔ امروز)، صف کار من (my_queue) |
| زمینه قبل از کد | get_context_pack، جزئیات تسک (get_task) |
| بهروزرسانی بدون مرورگر | update_status، update_progress، create_comment |
| ثبت زمان | start_work، end_work، log_time |
| تحویل به بازبینی | submit_for_review |
| ویکی کنار کد | search_docs، صفحهٔ ویکی (get_wiki_page) |
همان دسترسی ویژگی وباپ روی هر فراخوانی اعمال میشود؛ پیمانکار بدون مجوز مالی، عدد بودجه نمیبیند.
سناریوی واقعی: اسپرینت میانی بدون تعویض پنجره
تیم پشتیبان پنج نفره قبل از Cursor و MCP روزی چهار تا شش بار مرورگر باز میکرد — بیش از دو ساعت تعویض زمینه. بعد از راهاندازی تدریجی:
روز ۱: سرپرست فنی پیکربندی را در ویکی نوشت و مطمئن شد کلیدها وارد مخزن نمیشوند.
روز ۳: هر نفر صبح my_day را اجرا کرد و خلاصهٔ کوتاهی در کانال گذاشت.
روز ۷: نرخ بهروزرسانی بورد از حدود ۵۵٪ به حدود ۸۲٪ رسید — چون بهروزرسانی در مسیر کار بود.
روز ۱۴: جلسهٔ وضعیت از سی دقیقه به دوازده دقیقه کوتاه شد.
پذیرش وقتی ماندگار شد که مدیر پروژه هم با list_tasks استثناها را مرور کرد. ابزار یکطرفه شکست میخورد.
همافزایی با گیت محلی
Cursor و MCP جایگزین گیت محلی نیستند — مکملاند:
- قبل از شاخهٔ جدید:
get_taskبرای معیار پذیرش - بعد از ثبت تغییر:
update_progress - باز شدن درخواست ادغام:
submit_for_reviewو لینک در کامنت - شکست خط لوله: فهرست خطوط لولهٔ گیت (
list_git_pipelines)
کارت تسک و تاریخچهٔ گیت هر دو بهروز میمانند. یکپارچهسازی گیت داخل WKFGo جدا از گیت محلی ویرایشگر است.
رفع اشکال رایج
| مشکل | راهحل |
|---|---|
| فهرست ابزارها خالی است | آدرس سرور و راهاندازی مجدد Cursor |
| همهٔ ابزارها «ممنوع» | نقش پروژه و دسترسی ویژگی |
| دادهٔ پروژهٔ اشتباه | نام یا شناسهٔ پروژه در پرسش |
| پاسخ کند | اتصال شبکه تا نمونهٔ WKFGo |
Cursor در برابر Claude
| نقش | کلاینت پیشنهادی |
|---|---|
| توسعهدهنده | Cursor — کد و تسک در یک جریان |
| مدیر پروژه | Claude روی میز کار — روایت اسپرینت |
| مدیر مالی / مدیرعامل | Claude روی میز کار — مالی، صندوق تصمیم، پرتفوی |
یک سرور MCP، چند کلاینت، مجوز به ازای هر کاربر — یک منبع حقیقت.
سوالات متداول
آیا طرح ویژهٔ Cursor لازم است؟
پشتیبانی MCP به نسخه و طرح Cursor بستگی دارد؛ سمت WKFGo با اشتراک معمولی و کلید شخصی کار میکند. جزئیات در مستندات.
آیا روی ویندوز، لینوکس و مک کار میکند؟
بله. MCP سمت کلاینت است؛ سرور WKFGo میتواند ابری یا خودمیزبان باشد.
آیا با یکپارچهسازی گیت WKFGo تداخل دارد؟
خیر. فهرست ثبتهای گیت (list_git_commits) زمینه را از دادهٔ پروژه میخواند و جایگزین گیت محلی نیست.
مدیر پروژه بدون Cursor چطور؟
همان سرور را در Claude روی میز کار میخواند؛ توسعهدهنده در Cursor میماند.