مایندبیس و Windsurf؛ وضعیت واقعی اتصال و راه‌های جایگزین

اگر کاربر Windsurf هستید و می‌خواهید مدل‌های مایندبیس را در آن داشته باشید، این مطلب وضعیت واقعی را — بدون تعارف و بدون آموزش‌های نادرست اینترنتی — برایتان روشن می‌کند و راه‌حل‌های عملی می‌دهد.

خلاصه: چرا اتصال مستقیم ممکن نیست؟

سه واقعیت را از منابع رسمی بررسی کرده‌ایم:

  • ویندسرف حالا Devin Desktop است. تیم Cognition در ژوئن ۲۰۲۶ اعلام کرد نسخه بعدی ویندسرف همان Devin Desktop است و مستندات قدیمی docs.windsurf.com به docs.devin.ai منتقل شده‌اند. عامل Cascade قدیمی هم مسیر حذف را طی می‌کند.
  • قابلیت BYOK رسمی ویندسرف فقط Anthropic است. مسیر رسمی واردکردن کلید شخصی، صفحه Provider API Keys در حساب windsurf.com است که طبق اعلام رسمی نسخه ۱.۹.۲ فقط کلید Anthropic می‌پذیرد — کلید باز-سازگار (مثل کلید mb_ مایندبیس) در آن جایی ندارد.
  • امکان Endpoint سفارشی OpenAI در نسخه مصرف‌کننده وجود ندارد. در مستندات رسمی ویندسرف از سال ۲۰۲۴ تا امروز هیچ قابلیت «Add custom model / Base URL» برای کاربر عادی مستند نشده است؛ تنها مکانیسم باز-سازگار موجود، فایل models.json مخصوص استقرارهای سازمانی Air-Gapped است که در دسترس کاربران عادی نیست.

پس آموزش‌هایی که «Settings → Add model با Base URL» را برای ویندسرف نشان می‌دهند، به یک قابلیت اشاره دارند که در نسخه رسمی وجود ندارد — روی آن حساب نشوید.

راه جایگزین ۱: همان مدل‌ها در ادیتورهای باز-سازگار

محیط واقعی Windsurf — آموزش تنظیم اتصال به مایندبیس

تجربه‌ای که از ویندسرف می‌خواهید — ایجنت کدنویسی داخل ادیتور با مدل دلخواه — در ابزارهای دیگر دقیق‌تر و بازتر هم هست. هر سه گزینه زیر اتصال رسمی و مستندشده به مایندبیس دارند و آموزش کامل‌شان در همین دسته‌بندی آمده است:

  • Continue در VS Code یا JetBrains: یک بلوک YAML و مدل MindBase در چت، ویرایش و Apply؛ حتی روی همان PyCharm شما هم نصب می‌شود.
  • Zed: Provider باز-سازگار رسمی (openai_compatible) با api_url مایندبیس و ایجنت داخلی قدرتمند.
  • AI Assistant در PyCharm (نسخه ۲۰۲۵.۳ به بعد): قابلیت BYOK رسمی JetBrains با Provider سازگار-OpenAI؛ URL مایندبیس، کلید mb_ و تست اتصال.

در همه این‌ها مقادیر یکسان است: Base URL = https://api.mindbase.ir/v1، کلید = کلید mb_ از پروفایل مایندبیس و مدل = MindBase.

دریافت کلید API و Base URL از پنل کاربری مایندبیس

راه جایگزین ۲: ادامه استفاده از ویندسرف + مایندبیس کنار هم

اگر به ویندسرف/Devin Desktop برای کارهای خودش وابسته‌اید، لازم نیست بین دو دنیا یکی را انتخاب کنید:

  • کارهای ایجنتی و چت با مدل‌های مایندبیس را به یک کلاینت باز-سازگار بدهید — مثلاً Chatbox یا Cherry Studio روی همان سیستم، یا Continue داخل VS Code.
  • ویندسرف را برای تکمیل خودکار Tab و قابلیت‌های اختصاصی خودش نگه دارید (آن بخش از کلید مایندبیس استفاده نمی‌کند).
  • با یک حساب مایندبیس، همزمان در همه این ابزارها — ادیتور، ترمینال و اپ چت — مصرف واحد و گزارش انرژی دارید.

چرا این محدودیت منطقی است؟

ویندسرف (مانند Cursor) مدل را بخشی از بسته ارزش خودش می‌داند و درآمدش از اشتراک است؛ باز گذاشتن Endpoint سفارشی یعنی دورزدن آن مدل کسب‌وکار. در مقابل، ابزارهای متن‌باز یا باز-دوست مثل Continue، Zed، OpenCode و Aider دقیقاً به همین دلیل Endpoint دلخواه را رسمی پشتیبانی می‌کنند — و مایندبیس با استاندارد OpenAI با همه‌شان سازگار است.

جمع‌بندی

ویندسرف — حالا با نام Devin Desktop — برای کاربر عادی هیچ مسیر رسمی‌ای برای Endpoint باز-سازگار ندارد؛ BYOK آن فقط Anthropic است و قابلیت «Add model با Base URL» که در اینترنت دیده می‌شود در مستندات رسمی وجود ندارد. اگر مایندبیس برایتان اولویت است، Continue یا Zed یا AI Assistant همان تجربه را بازتر می‌دهند؛ و اگر ویندسرف را نگه می‌دارید، مایندبیس را در کلاینت‌های کناری‌اش داشته باشید.

سوالات متداول

پس آموزش‌هایی که Add model در Windsurf نشان می‌دهند چیست؟

در مستندات رسمی ویندسرف چنین قابلیتی هرگز مستند نشده و بررسی آرشیو مستندات و تغییرات نسخه‌ها آن را تایید نمی‌کند؛ اتکا به آن باعث خطای زمان‌سربی می‌شود.

می‌توانم کلید مایندبیس را در صفحه Provider API Keys ویندسرف بگذارم؟

نه؛ آن صفحه فقط کلید Anthropic می‌پذیرد و کلیدهای باز-سازگار مثل mb_ را رد می‌کند.

نزدیک‌ترین تجربه به ویندسرف با مایندبیس چیست؟

Continue در VS Code یا Zed — هر دو ایجنت داخلی با فراخوانی ابزار دارند و آموزش اتصال رسمی‌شان به مایندبیس در همین دسته‌بندی هست.

آیا در آینده ممکن می‌شود؟

تصمیمش با Cognition است؛ در صورت افزودن قابلیت BYOK باز-سازگار، اتصال مایندبیس همان دو مقدار ثابت (Base URL با v1 و کلید mb_) خواهد بود. این مطلب را در صورت تغییر وضعیت به‌روز می‌کنیم.