lubWypróbuj bezpłatnie
Zaloguj się Zacznij za darmo

Serwer MCP Hypris

Jak asystenci AI łączą się z Hypris przez Model Context Protocol: transport, logowanie i model narzędzi.

Na tej stronie

Model Context Protocol (MCP) to otwarty standard, przez który asystenci AI łączą się z zewnętrznymi systemami. Hypris działa jako zdalny serwer MCP, więc Claude, ChatGPT, Cursor, Codex i inni mogą czytać i zmieniać dane workspace w Twoim imieniu, zawsze w granicach Twoich uprawnień.

Adres serwera MCP
https://mcp.staging.hypris.com

Obsługiwani klienci

Wybierz swojego klienta, żeby zobaczyć konfigurację krok po kroku:

Klienta spoza listy podłączysz tak samo, jeśli obsługuje zdalne serwery MCP przez Streamable HTTP. Wystarczy adres serwera, a logowanie OAuth klient wykryje sam.

Jak to działa

TransportStreamable HTTP
Wersja specyfikacji2025-06-18
SesjaBezstanowa, serwer nie nadaje identyfikatora sesji
UwierzytelnienieOAuth 2.1 albo klucz API w nagłówku Authorization
NarzędziaKilka stałych narzędzi, resztę asystent wyszukuje sam
ZasobyOpublikowane umiejętności workspace

Logowanie

OAuth 2.1 to domyślny i zalecany sposób. Zapytanie bez tokenu dostaje odpowiedź 401 z nagłówkiem WWW-Authenticate: Bearer resource_metadata="…". Klient odczytuje z niego adres metadanych, odnajduje serwer autoryzacji i otwiera okno logowania. Na ekranie zgody wybierasz workspace i zakresy, a token działa potem tylko w tym workspace.

Klucz API przydaje się w klientach, które nie obsługują OAuth, i w automatyzacjach. Wysyłasz go jako Authorization: Basic base64(keyId:secret). Klucz użytkownika niesie wszystkie Twoje uprawnienia, a klucz aplikacji tylko uprawnienia aplikacji. Szczegóły w przewodniku Klucze API.

Dlaczego tak mało narzędzi

Hypris ma setki operacji: bazy, rekordy, dokumenty, rozmowy, automatyzacje, pliki. Gdyby serwer wystawił je wszystkie w tools/list, opisy zajęłyby większość kontekstu modelu, zanim zrobiłby cokolwiek. Dlatego klient dostaje kilka stałych narzędzi:

  1. search_tools wyszukuje w katalogu operacje pasujące do zadania i zwraca ich schematy.

  2. execute_tool uruchamia wybraną operację.

  3. create_permission_request prosi administratora o brakujące uprawnienie.

Do tego dochodzą narzędzia do zadań w tle i plików. Pełną listę opisuje przewodnik Narzędzia i zasoby MCP, a wszystkie operacje, które asystent znajdzie przez search_tools, przejrzysz w katalogu endpointów i narzędzi.

Szybki test

Po podłączeniu napisz do asystenta: „Jakie bazy mam w Hypris?”. Powinien wywołać search_tools, a potem execute_tool, i pokazać listę Twoich baz. Zapytaj też „Jakich narzędzi możesz używać?”, żeby zobaczyć, co ma do dyspozycji.

Co dalej