افزودن یک سرور MCP اختصاصی
با یک سرور MCP اختصاصی، AI-Public را به یک سیستم پرونده، بایگانی، منبع داده یا هر سرویس تخصصی دیگر متصل می‌کنید. ابتدا مشخص کنید کدام transport با محل استفاده سازگار است.
انتخاب transport مناسب
| Transport | وب | موبایل | دسکتاپ | استفاده |
|---|---|---|---|---|
| Streamable HTTP | بله | بله | بله | توصیه‌شده برای سرورهای میزبانی‌شده |
| stdio | خیر | خیر | بله | فرایندهای محلی و یکپارچه‌سازی‌های دسکتاپ |
| SSE | فقط پیکربندی‌های موجود | فقط پیکربندی‌های موجود | بله | transport قدیمی؛ برای سرورهای جدید Streamable HTTP را انتخاب کنید |
الزامات برای Streamable HTTP
از endpoint عمومی کامل، شامل مسیر MCP، استفاده کنید؛ برای مثال:
https://mcp.organisatie.nl/mcp
endpoint باید از HTTPS استفاده کند، بدون redirect و از طریق DNS عمومی در دسترس باشد و به یک handshake معتبر initialize در MCP پاسخ دهد. نام‌های کاربری و گذرواژه‌ها نباید در URL باشند. آدرس‌های محلی، آدرس‌های شبکه خصوصی و endpointهای فرادادهٔ ابری مسدود می‌شوند.
افزودن یک سرور
- ترجیحات → Tools را باز کنید.
- Tools toevoegen یا MCP-server toevoegen را انتخاب کنید. این دکمه را فقط زمانی می‌بینید که به MCP دسترسی داشته باشید.
- presetهای موجود را بررسی کنید.
- Zelf een MCP-server toevoegen را انتخاب کنید.
- نام، endpoint کامل و روش احراز هویت را وارد کنید.
- پیکربندی را ذخیره کنید و منتظر بررسی اتصال بمانید.
- سرور را برای مجموعه ابزار پیش‌فرض خود فعال کنید.
یک مدیر می‌تواند از طریق Beheer → Tools → MCP یک سرور را برای کل محیط ثبت کند.
احراز هویت و secrets
AI-Public از connector-OAuth و secrets ایستا پشتیبانی می‌کند. توکن‌های OAuth، refresh tokenها، API-keyها و گذرواژه‌ها در فضای ذخیره‌سازی فقط-سرور نگه‌داری می‌شوند. یک چت فقط connectorId ثبت‌شده را دریافت می‌کند، نه پیکربندی محرمانه را.
در صورت تغییر URL یا احراز هویت، پیکربندی جدید ابتدا دوباره بررسی می‌شود. اگر این بررسی ناموفق باشد، یک پیکربندی تأییدشدهٔ قبلی می‌تواند تا زمان رفع مشکل فعال بماند.
مجوزهای ابزار و امنیت اطلاعات
فقط ابزارهایی را آزاد کنید که کاربران واقعاً به آن‌ها نیاز دارند. یک سرور MCP می‌تواند عملیات خواندن و نوشتن را ارائه دهد. AI-Public ابزارهای کشف‌شده را با یک allowlist سمت‌سرور فیلتر می‌کند و در هر استفاده، محیط، مالک و نقش را بررسی می‌کند. سازمان مسئول scopeهای مناسب، logging، دوره‌های نگه‌داری و مجوزدهی در سیستم مبدأ است.
سرورهای محلی دسکتاپ
یک سرور stdio محلی را در برنامهٔ دسکتاپ نصب می‌کنید. Command، argumentها، environment keyها و دسترسی‌های درخواستی محدود می‌شوند و پیش از تأیید نمایش داده می‌شوند. secrets به‌صورت محلی رمزنگاری می‌شوند.
عیب‌یابی
- endpoint در دسترس نیست: HTTPS، DNS، firewall و مسیر کامل
/mcpرا بررسی کنید. - نیاز به اتصال مجدد: اجازهٔ OAuth یا secret ذخیره‌شده را نوسازی کنید.
- مربوط به محیط دیگری است: connector را دوباره در محیط فعلی ثبت کنید.
- ابزاری نمایش داده نمی‌شود: allowlist، دسترسی نقش و وضعیت فعال را بررسی کنید.
- فقط روی دسکتاپ کار می‌کند: احتمالاً سرور از stdio یا یک آدرس محلی استفاده می‌کند.
منابع توسعه
همچنین ببینید
هنگام ویرایش، پیکربندی ثبت‌شدهٔ سرور واکشی می‌شود. کلید ذخیره‌شده پنهان می‌ماند: برای حفظ آن، فیلد کلید را خالی بگذارید. در صورت وجود URL یا روش احراز هویت متفاوت، اتصال مجدد لازم است. خطا در یک ابزار MCP به این معنی نیست که همهٔ ابزارهای آن سرور غیرقابل‌دسترسی هستند.