اتصالهای محلی در اپ دسکتاپ
اپ دسکتاپ میتواند سرورهای MCP محلی را از طریق stdio راهاندازی کند. این امکان به هوش مصنوعی دسترسی به قابلیتهای گستردهتر Google و Microsoft، Nextcloud و ابزارهای دیگری را میدهد که مرورگر قادر به اجرای آنها نیست. دسترسی به فایلهای محلی به صورت داخلی تعبیه شده و نیازی به سرور MCP ندارد.
راهاندازی اولیه
در اولین پیکربندی مراحل زیر را طی میکنید:
- یک پوشه پیشفرض محلی برای ابزارهای فایل داخلی انتخاب میکنید.
- در صورت تمایل میتوانید یک اتصال محلی برای Nextcloud انتخاب کنید.
- در صورت تمایل میتوانید سرورهای MCP دیگری از فروشگاه ابزار اضافه کنید.
میتوانید کل راهاندازی اولیه را به تعویق بیندازید. پوشه پیشفرض و اتصالهای اضافی را میتوانید بعداً تنظیم کنید. همه انتخابهای پوشه فقط به صورت محلی ذخیره میشوند.
فروشگاه ابزار
روی افزودن ابزار یا افزودن سرور MCP کلیک کنید. ابتدا پیشتنظیمهای امنی که با اپ دسکتاپ سازگارند را میبینید. فقط وقتی افزودن سرور MCP به صورت دستی را انتخاب کنید، فرم دستی باز میشود.
پیشتنظیمهای پرکاربرد شامل موارد زیر هستند:
| پیشتنظیم | امکانات | احراز هویت |
|---|---|---|
| Nextcloud | فایلها، تقویم و مخاطبین | آدرس سرور، نام کاربری و رمز عبور اپ |
| Memory | ذخیره و بازیابی دانش | ذخیرهسازی محلی |
علاوه بر این، فروشگاه ممکن است پیشتنظیمهایی برای سرویسهایی مانند GitHub، Canva، Notion، Supabase، Mailchimp و سایر سرورهای MCP مناسب نمایش دهد. در دسترس بودن بستگی به پلتفرم، احراز هویت و کاتالوگ فعلی دارد.
Google و Microsoft
Google Workspace و Microsoft 365 اتصالهای داخلی AI-School هستند. اینها روی وب، موبایل و دسکتاپ کار میکنند و به OpenAI یا پیشتنظیم سرور MCP محلی وابسته نیستند. پس از اجازه یکباره Google یا Microsoft، ابزارهای موجود با OpenAI، Claude، Gemini و Mistral قابل استفاده هستند، تا جایی که مدل انتخابشده از استفاده ابزار پشتیبانی کند.
انتخاب ابزار پویا
یک سرور MCP میتواند دهها ابزار ارائه دهد. بنابراین Desktop Deep Agent ابتدا اطلاعات مختصر ابزارها را بارگذاری میکند و در حین انجام وظیفه ابزارهای مرتبط را انتخاب میکند. این امکان وجود دارد که چندین سرور MCP بزرگ به طور همزمان فعال باشند بدون اینکه همه ابزارها به صورت همزمان در زمینه مدل قرار گیرند.
نصب امن
نصب محلی MCP مرز سختی بین رابط Angular و Electron دارد:
- رندر کننده هیچ فرمان شل آزاد را اجرا نمیکند؛
- فرمان، آرگومانها، کلیدهای محیطی و دسترسیهای درخواستشده کنترل میشوند؛
- یک دیالوگ بومی نشان میدهد چه چیزی در حال اجرا است؛
- پیکربندیهای تاییدشده گواهی یکپارچگی دریافت میکنند؛
- اسرار با ذخیرهسازی امن سیستمعامل رمزنگاری میشوند؛
- فرایندها هنگام خاموش کردن، حذف، خروج از سیستم و بستن متوقف میشوند.
اگر سروری را حذف کنید، اطلاعات ورود ذخیرهشده محلی نیز حذف میشوند.
وضعیت و تست
در بخش روی این کامپیوتر همه سرورهای محلی فعال را در یک مکان میبینید. در تنظیمات چت، اتصالهای محلی و راه دور با هم تحت اتصالها قرار دارند.
یک سرور را با یک سوال مشخص تست کنید، مثلاً:
- «چه پوشههایی در Nextcloud من وجود دارد؟»
- «آخرین ایمیلها درباره پروژه را پیدا کن.»
- «چه فایلهایی در این پوشه محلی وجود دارد؟»
در صورت بروز مشکل، لاگ دسکتاپ را بررسی کنید. اتصال موفق نام سرور و تعداد ابزارهای بارگذاریشده را نشان میدهد.
رفع مشکلات
- سرور فعال است اما هوش مصنوعی ابزارها را نمیبیند: runtime محلی را ریاستارت کنید و بررسی کنید آیا شناسه سرور در درخواست چت وجود دارد.
- احراز هویت وجود ندارد: سرور را در تنظیمات → ابزارها باز کنید و دوباره اتصال را انتخاب کنید.
- Nextcloud کار نمیکند: از URL پایه محیط Nextcloud و یک رمز عبور اپ جداگانه استفاده کنید.
- فایلهای محلی در دسترس نیستند: بررسی کنید پوشه کاری فعال هنوز وجود دارد و در صورت نیاز آن را دوباره از داشبورد انتخاب کنید.
- ابزارهای زیاد: انتخاب ابزار پویا را فعال نگه دارید و در سوال خود به وضوح منبع مورد نیاز را مشخص کنید.
افزودن سرور stdio به صورت دستی
ترجیحاً از پیشتنظیم استفاده کنید. فقط در صورتی سرور را به صورت دستی اضافه کنید که منبع و فرمان آن را مطمئن باشید. قبل از تایید موارد زیر را بررسی کنید:
- فایل اجرایی و آرگومانها؛
- کلیدهای محیطی؛
- دسترسی به سیستم فایل؛
- قابلیتهای خواندن و نوشتن.
همچنین ببینید
دسترسی به پوشههای محلی
ابزارهای فایل داخلی فقط میتوانند فایلها را در پوشه کاری که از طریق انتخابگر پوشه بومی به صورت صریح تایید کردهاید، بخوانند یا تغییر دهند.
هر مسیر به مکان کاننیکال تبدیل میشود. ترفندهایی با پیشوند مشابه پوشه مجاور و لینکهای نمادین که خارج از پوشه تاییدشده قرار میگیرند، رد میشوند. پس از راهاندازی مجدد runtime محلی، مجوزها دوباره همگامسازی میشوند؛ بدون پوشه تاییدشده، دسترسی به فایل به طور پیشفرض رد میشود.
اگر از هوش مصنوعی بخواهید فایلی یا زیرپوشهای را حذف کند، اپ دسکتاپ آن مورد را به سطل زباله سیستم منتقل میکند. این عملکرد در ویندوز، macOS و لینوکس کار میکند. خود پوشه اصلی تاییدشده را نمیتوان از طریق هوش مصنوعی به سطل زباله منتقل کرد.
