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