Dodawanie własnego serwera MCP
Dzięki własnemu serwerowi MCP połączysz AI-School z własną aplikacją, źródłem danych lub wyspecjalizowaną usługą. Najpierw wybierz transport odpowiedni do miejsca użycia.
Wybierz właściwy transport
| Transport | Web | Mobilne | Desktop | Zastosowanie |
|---|---|---|---|---|
| Streamable HTTP | Tak | Tak | Tak | Zalecane dla hostowanych serwerów |
| stdio | Nie | Nie | Tak | Lokalne procesy i integracje desktopowe |
| SSE | Tylko istniejące konfiguracje | Tylko istniejące konfiguracje | Tak | Przestarzały transport; dla nowych serwerów wybierz Streamable HTTP |
Wymagania dla Streamable HTTP
Użyj pełnego publicznego punktu końcowego, włącznie ze ścieżką MCP, na przykład:
https://mcp.example.nl/mcp
Punkt końcowy musi:
- używać HTTPS;
- działać bez nazwy użytkownika i hasła w adresie URL;
- nie wymagać przekierowania;
- być dostępny przez publiczny DNS;
- odpowiadać prawidłowym handshake
initializeMCP; - mieć jawnie określony zestaw dozwolonych narzędzi.
Lokalne adresy, prywatne adresy sieciowe i końcówki metadanych chmury są blokowane. Dlatego nie możesz zarejestrować serwera na localhost z poziomu aplikacji webowej.
Dodawanie serwera
- Otwórz Preferencje → Narzędzia.
- Wybierz Dodaj narzędzia lub Dodaj serwer MCP. Ten przycisk widzisz tylko wtedy, gdy masz dostęp do MCP.
- Najpierw przejrzyj dostępne presety.
- Wybierz Dodaj własny serwer MCP.
- Wpisz nazwę, pełny punkt końcowy i metodę uwierzytelniania.
- Zapisz konfigurację i poczekaj na sprawdzenie połączenia.
- Włącz serwer dla swojego domyślnego zestawu narzędzi.
Administrator może też zarejestrować serwer dla całego środowiska przez Administracja → Ustawienia AI → Narzędzia → MCP.
Uwierzytelnianie i sekrety
AI-School obsługuje OAuth łącznika i statyczne sekrety. Tokeny OAuth, tokeny odświeżania, klucze API i hasła są przechowywane wyłącznie po stronie serwera. Czat otrzymuje tylko zarejestrowany connectorId, nigdy poufną konfigurację.
Po zmianie adresu URL lub uwierzytelniania nowa konfiguracja jest najpierw ponownie sprawdzana. Jeśli sprawdzenie się nie powiedzie, wcześniej zatwierdzona konfiguracja może pozostać aktywna, dopóki problem nie zostanie rozwiązany.
Uprawnienia do narzędzi
Udostępniaj tylko te narzędzia, których użytkownicy naprawdę potrzebują. Serwer MCP może oferować zarówno operacje odczytu, jak i zapisu, takie jak usuwanie plików, wysyłanie e-maili czy modyfikowanie rekordów. AI-School filtruje wykryte narzędzia względem allowlisty po stronie serwera, ale administrator serwera pozostaje odpowiedzialny za odpowiednie zakresy i autoryzację.
Testowanie lokalne
Lokalny serwer stdio testujesz w aplikacji desktopowej. Renderer nie może uruchamiać dowolnych poleceń shell: instalacja odbywa się przez zatwierdzony preset lub bezpieczny przepływ desktopowy. Polecenie, argumenty, klucze środowiskowe i żądany dostęp są pokazane przed instalacją.
Rozwiązywanie problemów
- Punkt końcowy niedostępny: sprawdź HTTPS, DNS, zaporę sieciową i pełną ścieżkę
/mcp. - Wymagane ponowne połączenie: odśwież zgodę OAuth lub zapisany sekret.
- Należy do innego środowiska: zarejestruj łącznik ponownie w bieżącym środowisku.
- Brak widocznych narzędzi: sprawdź allowlistę narzędzi, dostęp do MCP oraz czy serwer jest aktywny.
- Działa tylko na desktopie: prawdopodobnie serwer używa stdio lub lokalnego adresu.
Zasoby dla deweloperów
Zobacz też
Podczas edycji pobierana jest zarejestrowana konfiguracja serwera. Zapisany klucz pozostaje ukryty: pozostaw pole klucza puste, aby go zachować. Przy innym adresie URL lub metodzie uwierzytelniania wymagane jest ponowne połączenie. Błąd w jednym narzędziu MCP nie oznacza, że wszystkie narzędzia tego serwera są niedostępne.