Dodawanie własnego serwera MCP
Z własnym serwerem MCP łączysz AI-Corporate z wewnętrzną 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 endpointu, w tym ścieżki MCP, na przykład:
https://mcp.example.com/mcp
Endpoint musi używać HTTPS, być dostępny publicznie bez przekierowań i odpowiadać poprawnym handshake initialize MCP. Nazwy użytkowników i hasła nie powinny znajdować się w adresie URL. Lokalne adresy, adresy prywatnych sieci i endpointy metadanych chmury są blokowane.
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.
- Przejrzyj dostępne presety odpowiednie dla organizacji.
- Wybierz Dodaj własny serwer MCP.
- Wypełnij 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 zarejestrować serwer dla całego środowiska przez Administracja → Narzędzia → MCP.
Uwierzytelnianie i sekrety
AI-Corporate obsługuje OAuth konektora i statyczne sekrety. Tokeny OAuth, tokeny odświeżania, klucze API i hasła są przechowywane w magazynie tylko dla serwera. Czat otrzymuje wyłącznie zarejestrowany connectorId, nigdy tajnej konfiguracji.
Po zmianie adresu URL lub uwierzytelniania nowa konfiguracja jest najpierw ponownie sprawdzana. Jeśli to sprawdzenie się nie powiedzie, wcześniej zatwierdzona konfiguracja może pozostać aktywna do czasu rozwiązania problemu.
Uprawnienia do narzędzi i governance
Udostępniaj tylko te narzędzia, których pracownicy rzeczywiście potrzebują. Serwer MCP może oferować zarówno operacje odczytu, jak i zapisu. AI-Corporate filtruje wykryte narzędzia względem allowlisty po stronie serwera i przy każdym użyciu sprawdza tenant, właściciela i rolę. Organizacja pozostaje odpowiedzialna za odpowiednie zakresy, logowanie, okresy retencji i autoryzację w systemie źródłowym.
Lokalne serwery desktopowe
Lokalny serwer stdio instalujesz w aplikacji desktopowej. Renderer nie może uruchamiać dowolnych poleceń powłoki: command, argumenty, klucze środowiskowe i wymagany dostęp są ograniczane oraz pokazywane przed zatwierdzeniem. Sekrety są szyfrowane lokalnie.
Rozwiązywanie problemów
- Endpoint niedostępny: sprawdź HTTPS, DNS, firewall i pełną ścieżkę
/mcp. - Wymagane ponowne połączenie: odśwież zgodę OAuth lub zapisany secret.
- Należy do innego środowiska: zarejestruj konektor ponownie w bieżącym środowisku.
- Brak widocznych narzędzi: sprawdź allowlistę, dostęp na poziomie roli i aktywny status.
- Działa tylko na desktopie: serwer prawdopodobnie używa stdio lub lokalnego adresu.
Zasoby dla deweloperów
Zobacz także
Podczas edycji pobierana jest zarejestrowana konfiguracja serwera. Zapisany klucz pozostaje ukryty: zostaw 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 z tego serwera są niedostępne.