Dodanie własnego serwera MCP
Dzięki własnemu serwerowi MCP łączysz AI-School z własną aplikacją, źródłem danych lub wyspecjalizowaną usługą. Najpierw wybierz transport odpowiedni dla miejsca użycia.
Wybierz odpowiedni transport
| Transport | Web | Mobilny | Desktop | Zastosowanie |
|---|---|---|---|---|
| Streamable HTTP | Tak | Tak | Tak | Zalecany dla serwerów hostowanych |
| 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 endpointu, łącznie ze ścieżką MCP, na przykład:
https://mcp.example.nl/mcp
Endpoint musi:
- używać HTTPS;
- działać bez nazwy użytkownika i hasła w URL;
- nie wymagać przekierowania;
- być dostępny przez publiczny DNS;
- odpowiadać poprawnym handshake MCP
initialize; - mieć wyraźnie określony zestaw dozwolonych narzędzi.
Adresy lokalne, prywatne sieci i endpointy metadanych chmurowych są blokowane. W związku z tym nie możesz zarejestrować serwera na localhost z poziomu aplikacji webowej.
Dodanie serwera
- Otwórz Preferencje → Narzędzia.
- Wybierz Dodaj narzędzie lub Dodaj serwer MCP.
- Najpierw sprawdź dostępne presety.
- Wybierz Dodaj własny serwer MCP.
- Wprowadź nazwę, pełny endpoint i metodę uwierzytelniania.
- Zapisz konfigurację i poczekaj na sprawdzenie połączenia.
- Włącz serwer dla swojego domyślnego zestawu narzędzi.
Administrator może również zarejestrować serwer dla całego środowiska przez Zarządzanie → Ustawienia AI → Narzędzia → MCP.
Uwierzytelnianie i sekrety
AI-School obsługuje connector-OAuth oraz statyczne sekrety. Tokeny OAuth, tokeny odświeżania, klucze API i hasła są przechowywane tylko po stronie serwera. Chat otrzymuje jedynie zarejestrowany connectorId, nigdy tajnej konfiguracji.
W przypadku zmiany URL lub uwierzytelniania nowa konfiguracja jest najpierw ponownie weryfikowana. Jeśli weryfikacja się nie powiedzie, wcześniej zatwierdzona konfiguracja może pozostać aktywna do czasu rozwiązania problemu.
Uprawnienia narzędzi
Udostępniaj tylko te narzędzia, których użytkownicy faktycznie potrzebują. Serwer MCP może oferować akcje do odczytu 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 odpowiada 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 zabezpieczony desktopowy flow. Polecenie, argumenty, klucze środowiskowe i wymagany dostęp są wyświetlane przed instalacją.
Rozwiązywanie problemów
- Endpoint niedostępny: sprawdź HTTPS, DNS, zaporę i pełną ścieżkę
/mcp. - Wymagane ponowne połączenie: odśwież zgodę OAuth lub zapisany sekret.
- Należy do innego środowiska: zarejestruj connector ponownie w bieżącym środowisku.
- Brak widocznych narzędzi: sprawdź allowlistę narzędzi, dostęp MCP i czy serwer jest aktywny.
- Działa tylko na desktopie: prawdopodobnie serwer używa stdio lub lokalnego adresu.
