Przejdź do głównej zawartości
DocumentationAPI ReferenceVideo Tutorials

Serwery MCP

MCP — Model Context Protocol — to otwarty standard, który pozwala asystentom AI odkrywać i wywoływać zewnętrzne narzędzia. Jeśli prowadzisz serwer kompatybilny z MCP (własny lub jeden z wielu serwerów społecznościowych), możesz podpiąć go do Hanc.AI, a Twoi agenci otrzymają narzędzia tego serwera w momencie rozpoczęcia rozmowy.

Po połączeniu agent może wywoływać te narzędzia w trakcie rozmowy — pobierając dane na żywo, wykonując obliczenia, uruchamiając workflow w backendzie — dokładnie tak jak wbudowane integracje Calendar, HubSpot czy API Tool.

Dostępne w każdym planie

Serwery MCP są dostępne we wszystkich planach, w tym Free. Brak opłaty za serwer — płacisz tylko za minuty rozmowy, podczas których agent wywołuje narzędzia.

Kiedy używać MCP​

ScenariuszDlaczego MCP pasuje
Już prowadzisz wewnętrzny serwer narzędziJedno połączenie, wszystkie Twoje narzędzia dostępne każdemu agentowi
Chcesz dzielić narzędzia między agentamiPołącz raz, podłącz do dowolnej liczby agentów
Używasz społecznościowych serwerów MCPPodłącz popularne open-source'owe serwery MCP bez pisania własnego kodu
Powierzchnia Twoich narzędzi często się zmieniaAgent ponownie odkrywa narzędzia przy każdej rozmowie — dodaj/usuń narzędzia po stronie serwera bez ingerencji w dashboard

Jeśli masz pojedynczy doraźny endpoint, API Tool jest prostsze. Jeśli masz zestaw powiązanych narzędzi lub już utrzymujesz serwer MCP, to właściwa integracja.

Łączenie serwera MCP​

1. Otwórz stronę Integracje​

W pasku bocznym dashboardu przejdź do Integracje. Przewiń do sekcji Serwery MCP.

2. Kliknij "Połącz serwer MCP"​

Otworzy się modal. Wypełnij:

PoleOpis
EtykietaKrótka nazwa tego połączenia (np. "Sales Tools", "Internal CRM"). Etykieta jest pokazywana w wyborze narzędzi agenta i poprzedza nazwy narzędzi prezentowanych AI, więc trzymaj ją krótką i znaczącą.
URLHTTPS URL Twojego serwera MCP. Musi to być publicznie osiągalny adres — http:// i adresy prywatne/wewnętrzne są odrzucane.
UwierzytelnianieBrak, jeśli Twój serwer jest otwarty, lub Bearer token, jeśli oczekuje nagłówka Authorization: Bearer ….
Token(Tylko Bearer) Twój token autoryzacyjny. Przechowywany zaszyfrowany — tylko Twoje konto platformy może go odszyfrować do użycia.

Kliknij Zapisz. Hanc.AI weryfikuje format URL i zapisuje połączenie. Połączenie jest teraz dostępne dla każdego agenta w Twoim workspace.

Etykiety mają znaczenie

Nazwy narzędzi z każdego serwera MCP są poprzedzane etykietą połączenia, więc serwer MCP z narzędziem lookup_order połączony jako "Shop API" pojawi się agentowi jako Shop_API_lookup_order. Zapobiega to kolizjom, gdy łączysz wiele serwerów MCP, które mają narzędzia o podobnych nazwach.

3. Edycja, wyłączanie lub usuwanie​

Lista serwerów MCP pokazuje etykietę, URL, typ uwierzytelniania i status każdego połączenia, które dodałeś. Użyj akcji w wierszu, aby:

  • Edytować — zmienić etykietę, URL, typ uwierzytelniania lub token
  • Usunąć — całkowicie usunąć połączenie

Usunięcie połączenia dezaktywuje je dla każdego agenta, który je miał — agenci po prostu tracą dostęp do jego narzędzi przy następnej rozmowie.

Podłączanie narzędzi MCP do agenta​

Połączenie w Twoim workspace jest dostępne dla Twoich agentów — ale każdy agent indywidualnie decyduje, które z Twoich połączeń udostępnić. Oznacza to, że możesz mieć oddzielnych agentów Sprzedaży i Wsparcia, którzy korzystają z różnych serwerów MCP.

1. Otwórz zakładkę Akcje agenta​

Wybierz agenta. Otwórz zakładkę Akcje. Kliknij Dodaj akcję.

2. Wybierz "Serwery MCP" z grupy Live-call​

Lista rozwijana pokazuje trzy grupy: Pre fetch, Live call, Post call. Szukaj w grupie Live-call — to tam należą serwery MCP, ponieważ agent wywołuje narzędzia MCP podczas rozmowy, a nie przed nią ani po niej.

3. Przełącz, które połączenia włączyć​

Modal listuje każde połączenie MCP w Twoim workspace, każde z przełącznikiem on/off. Włącz te, których agent powinien używać. Możesz też wpisać krótką instrukcję w polu "Kiedy używać" — to właśnie agent czyta, aby zdecydować, kiedy sięgnąć po te narzędzia podczas rozmowy.

Kliknij Zapisz. Agent ma teraz dostęp do narzędzi z każdego włączonego połączenia MCP.

Łącz dowolnie

Możesz mieć jedno połączenie MCP włączone u pięciu agentów, a inne włączone tylko u jednego — każdy agent ma własne narzędzie Serwery MCP z własnym zestawem przełączników.

Jak to działa w trakcie rozmowy​

Gdy rozpoczyna się rozmowa, agent łączy się z każdym ze swoich włączonych serwerów MCP i pyta "jakie narzędzia oferujesz?" Cokolwiek serwer zwróci, jest udostępniane AI jako narzędzie, które może wywołać podczas rozmowy.

Kilka rzeczy, które warto wiedzieć:

  • Narzędzia są odkrywane przy starcie rozmowy. Jeśli dodasz lub usuniesz narzędzia na swoim serwerze MCP, zmiana pojawi się przy następnej rozmowie — nie musisz nic aktualizować w Hanc.AI.
  • Nazwy narzędzi są poprzedzane etykietą połączenia (więc "Shop API" + narzędzie search_products → Shop_API_search_products). Wbudowane narzędzia agenta i inne narzędzia MCP nie będą się zderzać.
  • Opisy narzędzi i schematy parametrów pochodzą z Twojego serwera MCP. Pisz tam dobre opisy — to z nich AI korzysta, decydując, kiedy i jak wywołać narzędzie.
  • Błędy są raportowane z powrotem do agenta. Jeśli wywołanie narzędzia się nie powiedzie, agent widzi komunikat błędu i może zdecydować o ponowieniu, przeprosinach lub spróbowaniu innego narzędzia.

Wymagania dla Twojego serwera MCP​

Aby działać z Hanc.AI, Twój serwer musi:

WymaganieSzczegół
HTTPSZwykłe http:// nie jest akceptowane. Używaj prawdziwego certyfikatu TLS.
Publiczny URLURL musi rozwiązywać się do publicznego adresu — Hanc.AI nie może dosięgnąć serwerów w prywatnej sieci ani na localhost.
Transport MCP Streamable HTTPAktualny transport MCP HTTP przez pojedynczy endpoint. Transporty tylko SSE i stdio nie są obsługiwane w tej integracji.
Bearer auth (opcjonalne)Jeśli Twój serwer wymaga uwierzytelnienia, musi akceptować standardowy nagłówek Authorization: Bearer <token>.

Jeśli hostujesz własny serwer za firewallem, udostępnij go przez tunel lub reverse proxy z publicznym endpointem HTTPS.

Bezpieczeństwo i prywatność​

Twoje tokeny bearer są przechowywane zaszyfrowane at rest. Tylko infrastruktura rozmów Hanc.AI może je odszyfrować i tylko w momencie, gdy rozpoczyna się rozmowa, a agent musi się połączyć z Twoim serwerem.

Wywołania narzędzi przepływają agent → Hanc.AI → Twój serwer MCP → z powrotem. Nie logujemy payloadów wywołań narzędzi. Twój serwer loguje to, co sam zdecydujesz logować po swojej stronie.

Jeśli zmienisz lub zrotujesz token, edytuj połączenie w dashboardzie — nowa wartość wchodzi w życie przy następnej rozmowie.

Dostępność w planach​

PlanSerwery MCP
FreeDostępne
Starter / Pro / Business / EnterpriseDostępne

Brak opłaty za połączenie — płacisz tylko za minuty rozmów, podczas których agent wywołuje narzędzia.

Rozwiązywanie problemów​

"Połączenie nie chce się zapisać"​

  • Upewnij się, że URL zaczyna się od https://, a nie http://.
  • Upewnij się, że host jest publicznie osiągalny — localhost, 127.0.0.1 i adresy wewnętrzne są celowo blokowane.
  • Sprawdź ponownie token bearer, jeśli go ustawiłeś — dodatkowe białe znaki lub cudzysłowy zepsują zapis.

"Agent nie widzi narzędzi"​

  • Sprawdź, czy wpis serwera MCP na zakładce Akcje agenta ma co najmniej jedno połączenie przełączone on i czy wpis jest zapisany.
  • Upewnij się, że Twój serwer MCP odpowiada na żądanie tools/list i nie wymaga interaktywnego flow uwierzytelniania.
  • Zajrzyj w log rozmowy agenta po komunikaty z połączenia MCP zaraz na początku rozmowy.

"Narzędzie pada w trakcie rozmowy"​

  • Agent zobaczy ten błąd, który zwróci Twój serwer. Sprawdź logi swojego serwera.
  • Długo działające narzędzia mogą upłynąć — utrzymuj wykonanie narzędzia MCP poniżej kilku sekund na wywołanie, aby odwiedzający nie siedział w ciszy.

"Zmieniłem narzędzia na swoim serwerze, ale agent nadal używa starych"​

  • Narzędzia są ponownie odkrywane na początku każdej rozmowy, nie są cache'owane między rozmowami. Następna nowa rozmowa widzi zaktualizowany zestaw narzędzi. Trwające rozmowy zachowują narzędzia, które otrzymały na starcie.

Powiązane​