Dodawanie własnego serwera MCP
Własny serwer MCP łączy AI-Corporate z aplikacją wewnętrzną, ź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 | 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żyj pełnego publicznego endpointu, włącznie ze ścieżką MCP, na przykład:
https://mcp.example.com/mcp
Endpoint musi używać HTTPS, być dostępny przez publiczny DNS bez przekierowań oraz odpowiadać poprawnym handshake MCP initialize. Nazwy użytkowników i hasła nie powinny znajdować się w URL. Adresy lokalne, prywatne sieci i endpointy metadanych chmury są blokowane.
Dodawanie serwera
- Otwórz Preferencje → Narzędzia.
- Wybierz Dodaj narzędzie lub Dodaj serwer MCP.
- Przejrzyj dostępne presety odpowiednie dla organizacji.
- Wybierz Dodaj własny serwer MCP.
- Wprowadź nazwę, pełny endpoint i metodę uwierzytelniania.
- Zapisz konfigurację i poczekaj na weryfikację 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-Corporate 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 governance
Udostępniaj tylko narzędzia, których pracownicy faktycznie potrzebują. Serwer MCP może oferować akcje do odczytu i zapisu. AI-Corporate filtruje wykryte narzędzia na podstawie allowlisty po stronie serwera oraz sprawdza tenant, 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. Renderer nie może uruchamiać dowolnych poleceń shell: polecenie, argumenty, klucze środowiskowe i wymagany dostęp są ograniczone i wyświetlane przed zatwierdzeniem. Sekrety są lokalnie szyfrowane.
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ę, dostęp na podstawie roli i status aktywności.
- Działa tylko na desktopie: prawdopodobnie serwer używa stdio lub lokalnego adresu.
