نویسنده: WKFGo Editorial · تاریخ انتشار · آخرین ویرایش

وقتی مرکز کار توسعه‌دهنده ویرایشگر است اما مدیریت پروژه در مرورگر مانده

ساعت ده و نیم صبح است. توسعه‌دهنده روی درخواست ادغام کار می‌کند. مدیر پروژه در پیام‌رسان تیم می‌پرسد: «تسک 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`)

همان دسترسی ویژگی وب‌اپ روی هر فراخوانی اعمال می‌شود؛ پیمانکار بدون مجوز مالی، عدد بودجه نمی‌بیند.

سناریوی واقعی: اسپرینت میانی بدون تعویض پنجره

برای یک تیم پشتیبان پنج‌نفره، این پایلوت تدریجی را اجرا کنید و زمان‌های زیر را متناسب با ریسک خود تنظیم کنید:

روز ۱: سرپرست فنی پیکربندی را در ویکی نوشت و مطمئن شد کلیدها وارد مخزن نمی‌شوند.

روز ۳: هر نفر صبح 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 می‌ماند.

قدم بعدی

منابع دست‌اول و روش راستی‌آزمایی

این فهرست برای بررسی بیشتر است؛ لینک‌های داخل متن، منبع ادعای مشخص همان بخش‌اند.