اگر امروز برای اتصال عامل‌های هوش مصنوعی به ابزارها روی ویندوز حساب باز کرده‌اید، یک بگ ظریف در PowerShell می‌تواند کل گردش کار را متوقف کند. گزارش سازگاری تازه sentinel-ir-mcp ۰.۲.۳ این شکست را مستند می‌کند و راه‌حل‌های عملی را روی میز می‌گذارد.
پروتکل زمینهٔ مدل (MCP) — مثل یک سوکت جهانی که هر ابزار هوش مصنوعی را به هر مدل وصل می‌کند — به سرعت لایه استاندارد برای اتصال عامل‌ها به توابع خارجی شده است. sentinel-ir-mcp (سرور تحلیل کد) — مثل یک دستیار که کد را می‌خواند و توابع را برای عامل‌ها باز می‌کند — نسخه ۰.۲.۳ ادعای پشتیبانی کامل از دسکتاپ ویندوز را دارد، اما تست‌های میدانی روایتی دیگر را روایت می‌کنند. همان‌طور که در تحلیل قبلی ما درباره‌ی چالش‌های یکپارچه‌سازی عامل‌ها در محیط‌های متنوع اشاره کردیم، تکه‌تکه بودن پیاده‌سازی‌ها مانع اصلی است.
جزئیات تست‌ها
- ماشین تست: ویندوز سرور ۲۰۲۲، بیلد ۱۰.۰.۲۰۳۴۸.۵۶۲۲، Node.js (محیط اجرا) — مثل بستر که کد جاوااسکریپت روی آن می‌دود — نسخه ۲۲.۲۳.۴ و npm (مدیر بسته) — مثل انبارداری که کتابخانه‌ها را دانلود و نگه می‌دارد — نسخه ۱۰.۹.۹ (نسخه ۲۰.۱۹.۰ از PATH حذف شده).
- VS Code (ویرایشگر) — مثل یک کارگاه مجهز که همه ابزارها در دسترس است — با قطعه کد PowerShell شامل توکن
--%سرور را با موفقیت راه‌اندازی کرد و سه تابع را کشف کرد.
فایل‌های لاگ انتقال حالت از Starting به Running در عرض ثانیه‌ها را تایید کردند. فایل .cursor%mcp.jsonمسیر پروژه را با حفظ فاصله و کاراکترهای خاص ذخیره کرد. VS Code با مسیری شامل&،%و^در cmd.exe هم کار کرد. - Claude Code در PowerShell (مفسر خط فرمان) — مثل یک مترجم سخت‌گیر که هر کلمه را قبل از اجرا تجزیه می‌کند — نسخه ۵.۱ دستور استاندارد
npx(ابزار اجرا) — مثل یک دروازه که بسته‌های Node را بدون نصب سراسری اجرا می‌کند — را با خطایunknown option '-y'رد کرد. PowerShell توکن--را قبل از رسیدن به اسکریپت مصرف کرد. همان شکست با توکن--%تکرار شد که به عنوان آرگومان الحاقی عبور کرد.
تغییر به cmd.exe (مفسر کلاسیک) — مثل یک دروازه ساده که دستورات را بدون تغییر می‌رساند — مشکل را حل کرد و سرور با سه تابع متصل شد. دستور claude mcp listاتصال سالم را نشان داد وclaude mcp getمسیر دقیق پروژه را ذخیره کرد. - Cursor (ویرایشگر هوشمند) — مثل یک همکار که کد می‌نویسد و ابزارها را مدیریت می‌کند — فایل تنظیمات سطح پروژه را شناسایی کرد اما سرور را راه‌اندازی نکرد. سرشماری MCP مقدار
enabledTotal:0را گزارش داد و حالت disconnected ماند.
با این حال یک دیپ‌لینک README ورودی سطح کاربر نصب کرد که بدون نیاز به ورود با سه تابع متصل شد. دیپ‌لینک دستور را در cmd.exe /d /s /cپیچید و سرور با موفقیت آغاز شد. لاگ‌ها اتصال stdio موفق و تغییر اثر انگشتی با سه تابع را ثبت کردند. - Windsurf (ویرایشگر عامل‌محور) — مثل یک ناوبری که عامل‌ها را در کد راهنمایی می‌کند — و Devin (عامل مهندسی) — مثل یک مهندس مجازی که وظایف را به صورت خودکار انجام می‌دهد — در صفحه انبوردینگ متوقف شدند و هرگز سرور MCP را آغاز نکردند. لاگ‌های برنامه هیچ خط sentinel نداشتند و هیچ پروسه‌ای ایجاد نشد.
دستور setup فایل تنظیمات جدید در %APPDATA%devinmcp_config.jsonبا ورودی sentinel-ir نوشت. دستور مهاجرت سرورهای موجود را از مکان قدیمی Windsurf به فایل جدید کپی کرد. فایل قدیمی بدون تغییر ماند و ورودی dummy-other را حفظ کرد. - Claude Desktop (برنامه دسکتاپ) — مثل یک برنامه کامل که مدل را در دسترس می‌گذارد — صفحه «Get started» را نمایش داد و قبل از ورود هیچ فایل لاگ MCP ایجاد نکرد.
فایل تنظیمات به درستی نوشته شد اما برنامه هرگز سعی در راه‌اندازی سرور نکرد. - دستور doctor (چکاپ) — مثل یک معاینه پزشکی که سلامت سیستم را بررسی می‌کند — دست‌دهی (handshake) — مثل یک سلام دوستانه که دو طرف ارتباط را برقرار می‌کند — خودکار را در برابر چک‌اوت محلی انجام داد، نسخه ۰.۲.۳ را گزارش کرد. نسخه Node، متادیتای بسته و ورودی پیکربندی برای هر کلاینت را تایید کرد. دست‌دهی موفق بود و لیست توابع با سه تابع مورد انتظار مطابقت داشت.
- مسیری شامل علامت
%باعث شکست npm نسخه ۱۰.۸ با خطای URI نامعتبر شد — مثل آدرس پستی اشتباه که پستچی نمی‌تواند پیدا کند. ارتقا به npm ۱۰.۹.۹ یا ۱۱.۱۹.۱ مشکل را برطرف کرد و اجازه دادnpxدر چنین پوشه‌هایی آغاز شود. - تست دودی سازگاری ورودی‌ها را در تنظیمات واقعی Claude Desktop و Windsurf نوشت، سپس آن‌ها را به یک پوشه موقت حذف شده اشاره کرد که نویسنده پس از آن پاکسازی کرد.
- اسکریپت اختصاصی تست نقل‌قول تأیید کرد که هم PowerShell و هم cmd.exe می‌توانند مسیرهای با فاصله،
&و^را مدیریت کنند. تمام ترکیبات تست شده OK برگرداندند و نقل‌قول قوی را تایید کردند. - مجموعه تست (test suite) — مثل یک چک‌لیست کامل که هر بخش را امتحان می‌کند — پروژه ۵۶ تست اجرا کرد: ۵۵ پاس، ۱ پرش. تست‌ها تجزیه آرگومان، دست‌دهی doctor، فراخوانی توابع و مهاجرت تنظیمات را پوشش می‌دادند. این تکه‌تکه‌سازی در مدیریت پیکربندی MCP، همان نگرانی است که بررسی اخیر ما درباره سرورهای عمومی MCP به آن اشاره کرد.
تحلیل
گزارش یک مشکل تکه‌تکه‌سازی عمیق را آشکار می‌کند: هر کلاینت پیکربندی MCP را به شیوه‌ای متفاوت مدیریت می‌کند. برخی ورود کاربری می‌خواهند، برخی بدون احراز هویت کار می‌کنند، و یک بگ مفسر خط فرمان می‌تواند کل زنجیره را فلج کند. برای کاربران عملی، پیامد مستقیم است: VS Code و دیپ‌لینک Cursor خارج از جعبه کار می‌کنند. Claude Code نیازمند cmd.exe است، و برنامه‌های کامل دسکتاپ پشت دروازه احراز هویت قفل مانده‌اند. بگ علامت درصد در npm صداع جداگانه است؛ ارتقای npm یا اجتناب از % در مسیرها تنها درمان است. در ادامه، ۵ آزمون امنیتی پیش از اعطای دسترسی ابزاری به عامل‌ها می‌تواند به کاهش این ریسک‌ها کمک کند.
گام بعدی شما
- sentinel-ir-mcp ۰.۲.۳ را دانلود کنید و دستور setup برای کلاینت ترجیحی خود را اجرا کنید.
- خروجی دستور
doctorرا برای هشدارها بررسی کنید. - اگر از Claude Code در ویندوز استفاده می‌کنید، مفسر پیش‌فرض را به cmd.exe تغییر دهید.
بازار کلاینت‌های MCP همچنان در حال تکامل است؛ تحلیل ما درباره‌ی استراتژی‌های یکپارچه‌سازی در اکوسیستم عامل‌محور به زودی منتشر می‌شود.
گفتگو