Dodanie własnego serwera MCP
Dzięki własnemu serwerowi MCP łączysz AI-Public z systemem spraw, archiwum, źródłem danych lub inną wyspecjalizowaną usługą. Najpierw wybierz transport odpowiedni dla miejsca użytkowania.
Wybierz odpowiedni transport
| Transport | Web | Mobilny | Desktop | Zastosowanie |
|---|---|---|---|---|
| Streamable HTTP | Tak | Tak | Tak | Zalecany dla serwerów hostowanych |
| stdio | Nie | Nie | Tak | Procesy lokalne 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żywaj pełnego publicznego endpointu, włącznie ze ścieżką MCP, na przykład:
https://mcp.organisatie.nl/mcp
Endpoint musi używać HTTPS, być dostępny przez publiczny DNS bez przekierowań oraz odpowiadać ważnym handshake MCP initialize. Nazwy użytkowników i hasła nie powinny znajdować się w URL. Adresy lokalne, prywatne sieciowe oraz endpointy metadanych chmury są blokowane.
Dodanie serwera
- Otwórz Preferencje → Narzędzia.
- Wybierz Dodaj narzędzie lub Dodaj serwer MCP.
- Przejrzyj 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 zestawu narzędzi domyślnych.
Administrator może zarejestrować serwer dla całego środowiska przez Zarządzanie → Narzędzia → MCP.
Uwierzytelnianie i sekrety
AI-Public obsługuje connector-OAuth oraz statyczne sekrety. Tokeny OAuth, tokeny odświeżania, klucze API i hasła są przechowywane tylko na serwerze. 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 i bezpieczeństwo informacji
Udostępniaj tylko te narzędzia, których użytkownicy rzeczywiście potrzebują. Serwer MCP może oferować akcje odczytu i zapisu. AI-Public filtruje wykryte narzędzia względem listy dozwolonych po stronie serwera oraz sprawdza środowisko, właściciela i rolę przy każdym użyciu. Organizacja pozostaje odpowiedzialna za odpowiednie zakresy, logowanie, okresy przechowywania i autoryzację w systemie źródłowym.
Lokalne serwery desktopowe
Lokalny serwer stdio instalujesz w aplikacji desktopowej. Polecenia, argumenty, klucze środowiskowe i wymagany dostęp są ograniczone i pokazywane przed zatwierdzeniem. Sekrety są szyfrowane lokalnie.
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ź listę dozwolonych, dostęp roli i status aktywności.
- Działa tylko na desktopie: prawdopodobnie serwer używa stdio lub lokalnego adresu.
