افزودن یک سرور MCP اختصاصی
با یک سرور MCP اختصاصی، AI-School را به یک برنامه اختصاصی، منبع داده یا سرویس تخصصی متصل می‌کنید. ابتدا مشخص کنید کدام انتقال با محل استفاده سازگار است.
انتخاب انتقال مناسب
| انتقال | وب | موبایل | دسکتاپ | استفاده |
|---|---|---|---|---|
| Streamable HTTP | بله | بله | بله | پیشنهادی برای سرورهای میزبانی‌شده |
| stdio | خیر | خیر | بله | فرایندهای محلی و یکپارچه‌سازی‌های دسکتاپ |
| SSE | فقط پیکربندی‌های موجود | فقط پیکربندی‌های موجود | بله | انتقال قدیمی؛ برای سرورهای جدید Streamable HTTP را انتخاب کنید |
پیش‌نیازهای Streamable HTTP
از endpoint عمومی کامل، همراه با مسیر MCP، استفاده کنید؛ برای مثال:
https://mcp.example.nl/mcp
endpoint باید:
- از HTTPS استفاده کند؛
- بدون نام کاربری یا گذرواژه در URL کار کند؛
- به هیچ redirectی نیاز نداشته باشد؛
- از طریق DNS عمومی در دسترس باشد؛
- به handshake معتبر MCP
initializeپاسخ دهد؛ - یک مجموعه صریح از ابزارهای مجاز داشته باشد.
آدرس‌های محلی، آدرس‌های شبکه خصوصی و endpointهای فرادادهٔ ابری مسدود می‌شوند. بنابراین نمی‌توانید سروری روی localhost را از وب‌اپ ثبت کنید.
افزودن یک سرور
- ترجیحات → ابزارها را باز کنید.
- افزودن ابزار یا افزودن سرور MCP را انتخاب کنید. این دکمه فقط زمانی نمایش داده می‌شود که به MCP دسترسی داشته باشید.
- ابتدا presetهای موجود را بررسی کنید.
- خودتان یک سرور MCP اضافه کنید را انتخاب کنید.
- نام، endpoint کامل و روش احراز هویت را وارد کنید.
- پیکربندی را ذخیره کنید و منتظر بررسی اتصال بمانید.
- سرور را برای مجموعه‌ابزار پیش‌فرض خود فعال کنید.
یک مدیر می‌تواند از طریق مدیریت → تنظیمات AI → ابزارها → MCP نیز یک سرور برای کل محیط ثبت کند.
احراز هویت و secretها
AI-School از connector-OAuth و secretهای ثابت پشتیبانی می‌کند. توکن‌های OAuth، refresh tokenها، کلیدهای API و گذرواژه‌ها در ذخیره‌سازی فقط-سرور نگه‌داری می‌شوند. یک گفتگو فقط connectorId ثبت‌شده را دریافت می‌کند، نه پیکربندی محرمانه را.
در صورت تغییر URL یا احراز هویت، پیکربندی جدید ابتدا دوباره بررسی می‌شود. اگر این بررسی ناموفق باشد، ممکن است یک پیکربندی قبلاً تأییدشده فعال بماند تا مشکل برطرف شود.
مجوزهای ابزار
فقط ابزارهایی را آزاد کنید که کاربران واقعاً به آن‌ها نیاز دارند. یک سرور MCP می‌تواند عملیات خواندن و نوشتن ارائه دهد، مانند حذف فایل‌ها، ارسال ایمیل یا تغییر رکوردها. AI-School ابزارهای کشف‌شده را با allowlist سمت سرور فیلتر می‌کند، اما مدیر سرور همچنان مسئول scopeها و مجوزدهی مناسب است.
آزمایش محلی
یک سرور محلی stdio را در برنامه دسکتاپ آزمایش می‌کنید. renderer نباید هر دستور shell دلخواهی را اجرا کند: نصب از طریق یک preset تأییدشده یا جریان امن دسکتاپ انجام می‌شود. دستور، آرگومان‌ها، کلیدهای environment و دسترسی درخواستی پیش از نصب نمایش داده می‌شوند.
عیب‌یابی
- endpoint در دسترس نیست: HTTPS، DNS، فایروال و مسیر کامل
/mcpرا بررسی کنید. - اتصال مجدد لازم است: مجوز OAuth یا secret ذخیره‌شده را تازه‌سازی کنید.
- مربوط به محیط دیگری است: connector را دوباره در محیط فعلی ثبت کنید.
- هیچ ابزاری نمایش داده نمی‌شود: allowlist ابزار، دسترسی MCP و فعال بودن سرور را بررسی کنید.
- فقط روی دسکتاپ کار می‌کند: احتمالاً سرور از stdio یا یک آدرس محلی استفاده می‌کند.
منابع توسعه
همچنین ببینید
هنگام ویرایش، پیکربندی ثبت‌شدهٔ سرور بازیابی می‌شود. کلید ذخیره‌شده پنهان می‌ماند: برای حفظ آن، فیلد کلید را خالی بگذارید. در صورت URL یا روش احراز هویت دیگر، اتصال مجدد لازم است. خطا در یک ابزار MCP به این معنی نیست که همه ابزارهای آن سرور در دسترس نیستند.