Dodawanie własnego serwera MCP
Z własnym serwerem MCP łączysz AI-Public z systemem spraw, archiwum, źródłem danych lub inną wyspecjalizowaną usługą. Najpierw wybierz transport odpowiedni do miejsca użycia.
Wybierz odpowiedni transport
| Transport | Sieć | Mobilnie | 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.organisatie.nl/mcp
Punkt końcowy musi używać HTTPS, być osiągalny przez publiczny DNS bez przekierowania i odpowiadać poprawnym handshake initialize MCP. Nazwy użytkowników i hasła nie powinny znajdować się w adresie URL. Adresy lokalne, prywatne adresy sieciowe i punkty końcowe metadanych chmury są blokowane.
Dodawanie serwera
- Otwórz Preferencje → Tools.
- Wybierz Dodaj Tools lub Dodaj serwer MCP. Ten przycisk zobaczysz tylko wtedy, gdy masz dostęp do MCP.
- 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 domowego zestawu narzędzi.
Administrator może zarejestrować serwer dla całego środowiska przez Zarządzanie → Tools → MCP.
Uwierzytelnianie i sekrety
AI-Public obsługuje OAuth konektora i statyczne sekrety. Tokeny OAuth, tokeny odświeżania, klucze API i hasła są przechowywane w pamięci tylko po stronie serwera. Czat otrzymuje wyłącznie zarejestrowany connectorId, nigdy poufnej konfiguracji.
Po zmianie URL lub uwierzytelniania nowa konfiguracja jest najpierw ponownie sprawdzana. Jeśli to sprawdzenie się nie powiedzie, wcześniej zatwierdzona konfiguracja może pozostać aktywna, dopóki problem nie zostanie rozwiązany.
Uprawnienia narzędzi i bezpieczeństwo informacji
Udostępniaj tylko te narzędzia, których użytkownicy naprawdę potrzebują. Serwer MCP może oferować zarówno akcje odczytu, jak i zapisu. AI-Public filtruje wykryte narzędzia względem allowlisty po stronie serwera i przy każdym użyciu sprawdza środowisko, właściciela i rolę. 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. Command, argumenty, klucze środowiskowe i wymagany dostęp są ograniczane i pokazywane przed zatwierdzeniem. Sekrety są lokalnie szyfrowane.
Rozwiązywanie problemów
- Punkt końcowy jest 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 konektor ponownie w bieżącym środowisku.
- Brak widocznych narzędzi: sprawdź allowlistę, dostęp do ról i aktywny status.
- Działa tylko na desktopie: serwer prawdopodobnie używa stdio lub lokalnego adresu.
Zasoby dla deweloperów
Zobacz też
Podczas edycji pobierana jest zarejestrowana konfiguracja serwera. Zapisany klucz pozostaje ukryty: zostaw pole klucza puste, aby go zachować. Przy innym URL lub metodzie uwierzytelniania wymagane jest ponowne połączenie. Błąd w jednym narzędziu MCP nie oznacza, że wszystkie narzędzia z tego serwera są niedostępne.