افزودن یک سرور MCP اختصاصی
با یک سرور MCP اختصاصی، AI-School را به یک برنامه، منبع داده یا سرویس تخصصی خود متصل میکنید. ابتدا انتخاب کنید که کدام نوع انتقال (transport) برای محل استفاده مناسب است.
انتخاب نوع انتقال مناسب
| انتقال | وب | موبایل | دسکتاپ | کاربرد |
|---|---|---|---|---|
| Streamable HTTP | بله | بله | بله | توصیه شده برای سرورهای میزبانی شده |
| stdio | خیر | خیر | بله | فرآیندهای محلی و یکپارچهسازی دسکتاپ |
| SSE | فقط پیکربندیهای موجود | فقط پیکربندیهای موجود | بله | انتقال منسوخ شده؛ برای سرورهای جدید Streamable HTTP را انتخاب کنید |
الزامات برای Streamable HTTP
از نقطه انتهایی عمومی کامل، شامل مسیر MCP استفاده کنید، برای مثال:
https://mcp.example.nl/mcp
نقطه انتهایی باید:
- از HTTPS استفاده کند؛
- بدون نام کاربری یا رمز عبور در URL کار کند؛
- نیازی به ریدایرکت نداشته باشد؛
- از طریق DNS عمومی قابل دسترسی باشد؛
- پاسخ handshake معتبر MCP
initializeرا بدهد؛ - مجموعه صریحی از ابزارهای مجاز داشته باشد.
آدرسهای محلی، آدرسهای شبکه خصوصی و نقاط انتهایی متادیتای ابری مسدود میشوند. بنابراین نمیتوانید سروری روی localhost را از طریق وباپ ثبت کنید.
افزودن یک سرور
- باز کنید تنظیمات → ابزارها.
- انتخاب کنید افزودن ابزار یا افزودن سرور MCP.
- ابتدا پیشتنظیمهای موجود را بررسی کنید.
- انتخاب کنید افزودن سرور MCP به صورت دستی.
- نام، نقطه انتهایی کامل و روش احراز هویت را وارد کنید.
- پیکربندی را ذخیره کنید و منتظر بررسی اتصال بمانید.
- سرور را برای مجموعه ابزار پیشفرض خود فعال کنید.
یک مدیر میتواند از طریق مدیریت → تنظیمات AI → ابزارها → MCP نیز سروری را برای کل محیط ثبت کند.
احراز هویت و اسرار
AI-School از OAuth کانکتور و اسرار ایستا پشتیبانی میکند. توکنهای OAuth، توکنهای تازهسازی، کلیدهای API و رمزهای عبور در ذخیرهسازی فقط سرور نگهداری میشوند. یک چت فقط connectorId ثبت شده را دریافت میکند و هرگز پیکربندی محرمانه را نمیبیند.
در صورت تغییر URL یا احراز هویت، پیکربندی جدید ابتدا دوباره بررسی میشود. اگر این بررسی ناموفق باشد، پیکربندی قبلاً تأیید شده میتواند فعال بماند تا مشکل حل شود.
مجوزهای ابزار
فقط ابزارهایی را آزاد کنید که کاربران واقعاً به آن نیاز دارند. یک سرور MCP میتواند عملیات خواندن و نوشتن ارائه دهد، مانند حذف فایلها، ارسال ایمیل یا تغییر رکوردها. AI-School ابزارهای کشف شده را با allowlist سمت سرور فیلتر میکند، اما مدیر سرور مسئول محدودهها و مجوزهای مناسب باقی میماند.
تست محلی
یک سرور stdio محلی را در اپ دسکتاپ تست کنید. رندرکننده نباید دستورات شل دلخواه را اجرا کند: نصب از طریق پیشتنظیم تأیید شده یا جریان امن دسکتاپ انجام میشود. فرمان، آرگومانها، کلیدهای محیطی و دسترسیهای درخواست شده قبل از نصب نمایش داده میشوند.
رفع مشکلات
- نقطه انتهایی در دسترس نیست: HTTPS، DNS، فایروال و مسیر کامل
/mcpرا بررسی کنید. - نیاز به اتصال مجدد: مجوز OAuth یا راز ذخیره شده را تازه کنید.
- مربوط به محیط دیگری است: کانکتور را دوباره در محیط فعلی ثبت کنید.
- ابزاری دیده نمیشود: allowlist ابزار، دسترسی MCP و فعال بودن سرور را بررسی کنید.
- فقط روی دسکتاپ کار میکند: احتمالاً سرور از stdio یا آدرس محلی استفاده میکند.
