Podłączanie serwerów MCP do Twojego bota #

Serwery MCP pozwalają Twojemu botowi AI korzystać z narzędzi z innych systemów podczas rozmów na żywo — bez konieczności ręcznego tworzenia każdego narzędzia. Wystarczy raz wskazać botowi serwer MCP, a każde narzędzie oferowane przez ten serwer stanie się dla niego automatycznie dostępne.

Jeśli korzystałeś już z funkcji niestandardowych (Custom Functions), to jest to ta sama idea, rozwinięta o krok dalej: funkcja niestandardowa to pojedyncze narzędzie, które konfigurujesz samodzielnie, podczas gdy serwer MCP to gotowy pakiet narzędzi, które bot może samodzielnie wykryć i wywołać.

Ta strona Your AI Connector łączy się z narzędziami innego systemu: każdy system CRM, sklep, system rezerwacji lub usługa wewnętrzna, która udostępnia adres serwera MCP, może zostać tutaj podłączona, a bot odczytuje przez niego dane na żywo w momencie, gdy są mu potrzebne, dzięki czemu zmiana wprowadzona ręcznie w tym systemie jest widoczna przy następnym wywołaniu. Kierunek przeciwny, pozwalający asystentowi AI, takiemu jak Claude lub ChatGPT, na obsługę Twojego konta Your AI Connector, jest osobną funkcją: zobacz Połącz klientów AI.

Czym jest serwer MCP? #

MCP (Model Context Protocol) to otwarty standard zapewniający asystentom AI dostęp do zewnętrznych narzędzi. Wiele nowoczesnych aplikacji i usług publikuje obecnie „serwer MCP” — pojedynczy adres internetowy, który udostępnia zestaw narzędzi, z których może korzystać AI: wyszukiwanie informacji, pobieranie rekordów, uruchamianie zapytań czy tworzenie elementów.

Zamiast opisywać każde narzędzie botowi, podajesz Your AI Connector adres serwera oraz klucz dostępu. Your AI Connector pyta serwer „co potrafisz?”, otrzymuje listę narzędzi i udostępnia je Twojemu botowi. Gdy serwer doda nowe narzędzie, Twój bot może z niego korzystać bez żadnej dodatkowej konfiguracji z Twojej strony.

Funkcje niestandardowe a serwery MCP — co wybrać:

Możesz używać obu rozwiązań jednocześnie dla tego samego Agenta.

Jak to działa (wersja uproszczona) #

1. Rejestrujesz serwer MCP na stronie Serwery MCP — podając jego adres internetowy oraz nagłówek autoryzacyjny (zazwyczaj klucz API).
2. Your AI Connector nawiązuje połączenie i wykrywa narzędzia serwera, a następnie zapamiętuje ich listę.
3. Włączasz serwer dla wybranego Agenta.
4. Podczas rozmowy, gdy klient prosi o coś, co może obsłużyć dane narzędzie, bot wywołuje je, odczytuje wynik i odpowiada w naturalny sposób.

Klient nigdy nie widzi mechanizmów działania — otrzymuje po prostu odpowiedź popartą rzeczywistymi, aktualnymi informacjami.

Gdy narzędzie zwraca bezpośredni link do obrazu, wideo, pliku audio lub dokumentu, bot wysyła sam plik zamiast wklejać link, dzięki czemu katalog produktów w Twoim własnym systemie może wyświetlać rzeczywiste zdjęcia. Zobacz Pliki z własnych narzędzi.

Ile kosztuje wywołanie narzędzia MCP #

Wywołanie narzędzia z serwera MCP jest rozliczane dokładnie tak samo, jak wywołanie funkcji niestandardowej, zgodnie z poziomem jakości AI Twojego Agenta:

Co Twój serwer otrzymuje przy każdym wywołaniu #

Każde wywołanie narzędzia przenosi kontakt rozmowy w polu _meta żądania, obok argumentów wybranych przez bota. Blok ten pochodzi z rekordu kontaktu, a nie od bota, dzięki czemu Twój serwer może odczytać, kto rozmawia, zamiast polegać na numerze telefonu lub nazwie wpisanej przez bota w argumencie. Ma to znaczenie w przypadku wszelkich danych osobowych: wizyt, zamówień, dokumentacji medycznej lub finansowej.

"params": {
  "name": "my_appointments",
  "arguments": { "phone": "+31612345678" },
  "_meta": {
    "youraiconnector.com/contact": {
      "id": "8DGUvqM2QiPmzaX1ljMl",
      "channel": "whatsapp",
      "phone": "+31612345678",
      "first_name": "Ana",
      "last_name": "Lopez",
      "email": "ana@example.com"
    },
    "youraiconnector.com/conversation": {
      "campaign_id": "qxJzgilcz3zJM8wYSUn0",
      "user_id": "nCrIMMj77WMhnC1XSykM7IrQQ0e2",
      "test": false
    }
  }
}

• id to identyfikator kontaktu w Your AI Connector, ten sam, którego używa API i webhooks.
• phone, email, first_name, last_name oraz identyfikatory platformy (instagram_id, messenger_id, telegram_user_id) są uwzględniane, jeśli kontakt je posiada.
• Stopień zaufania do tożsamości zależy od kanału. W przypadku WhatsApp, SMS i Telegram numer telefonu jest tym, z którego faktycznie nadeszła wiadomość. Na Instagramie i Messengerze jest to identyfikator platformy. W przypadku widżetu czatu internetowego i kanałów niestandardowych kontaktem jest osoba, która rozpoczęła czat, więc traktuj te szczegóły jako niezweryfikowane.
• test ma wartość true, gdy wywołanie pochodzi z czatu testowego Agenta wewnątrz aplikacji.

Serwer, który ignoruje _meta, będzie działał dokładnie tak samo jak wcześniej.

Dodawanie serwera MCP (krok po kroku) #

W głównym pasku bocznym, w sekcji AI Studio, kliknij Serwery MCP. Następnie kliknij + Dodaj serwer.

Wypełnij formularz:

Wybór sposobu logowania: klucz API lub OAuth #

Your AI Connector obsługuje dwa sposoby uwierzytelniania z serwerem. Wybierz ten, który jest zalecany w dokumentacji serwera, korzystając z opcji Uwierzytelnianie u góry formularza:

• Klucz API / nagłówek: pierwotna metoda opisana powyżej. Wklejasz stałe poświadczenie (klucz API lub token) w pole Wartość nagłówka autoryzacyjnego, a Your AI Connector wysyła je przy każdym żądaniu. Najlepsze rozwiązanie dla serwerów, które udostępniają długoterminowy klucz.
• OAuth (logowanie): dla serwerów, które zamiast wklejania klucza wymagają zalogowania się. W przypadku OAuth nie ma klucza do skopiowania — zatwierdzasz dostęp poprzez zalogowanie się, podobnie jak działa „Zaloguj przez Google” w innych serwisach.

Aby połączyć się przez OAuth:

1. Wybierz OAuth jako metodę uwierzytelniania. Pola nagłówka aut. znikną, a w ich miejsce pojawi się karta Połącz — nie będziesz potrzebować klucza.

2. Wypełnij pola Nazwa i Adres URL serwera, a następnie kliknij Zapisz. Serwer zostanie dodany do listy, ale na razie będzie widoczny jako niepołączony.
3. Kliknij Połącz przy serwerze. Otworzy się bezpieczne okno logowania, w którym zatwierdzisz dostęp.
4. Po zatwierdzeniu okno zamknie się automatycznie. Serwer będzie teraz widoczny jako połączony, a Your AI Connector załaduje jego narzędzia.

To wszystko. Your AI Connector automatycznie utrzymuje aktywne połączenie w tle, więc zazwyczaj nie musisz już nic więcej robić. Jeśli serwer kiedykolwiek zerwie połączenie (na przykład wygaśnie sesja logowania lub ktoś cofnie dostęp po stronie serwera), będzie on widoczny jako rozłączony — wystarczy kliknąć Połącz ponownie i zalogować się jeszcze raz.

Jeśli serwera nie można skonfigurować automatycznie po kliknięciu Połącz, zostaniesz poproszony o wklejenie kilku szczegółów (adresu logowania i identyfikatora klienta), które znajdują się w dokumentacji serwera, a następnie proces łączenia zostanie zakończony.

Testowanie połączenia #

Przed zapisaniem kliknij Testuj połączenie. Your AI Connector skontaktuje się z serwerem i wyświetli listę oferowanych przez niego narzędzi. To najszybszy sposób, aby upewnić się, że adres URL i klucz są poprawne — jeśli połączenie nie powiedzie się, zobaczysz komunikat o błędzie od razu, zamiast dowiadywać się o tym w trakcie rozmowy.

Gdy test zakończy się powodzeniem, kliknij Zapisz. Twój serwer pojawi się na liście z zieloną kropką statusu oraz liczbą oferowanych narzędzi.

Odczytywanie listy serwerów #

Każdy serwer na liście pokazuje:

• Kropkę statusu — zieloną, gdy ostatnie połączenie przebiegło pomyślnie, czerwoną, gdy ostatnia próba zakończyła się niepowodzeniem (najedź kursorem, aby zobaczyć błąd), szarą przed pierwszym udanym połączeniem.
• Adres serwera oraz liczbę narzędzi, które aktualnie oferuje.
• Przełącznik włącz/wyłącz, aby szybko włączyć lub wyłączyć cały serwer bez jego usuwania.

Your AI Connector odświeża listę narzędzi każdego serwera w tle mniej więcej raz dziennie, więc nowe narzędzia pojawiają się automatycznie. Wolny lub chwilowo niedostępny serwer nigdy nie wstrzymuje rozmowy — bot po prostu korzysta z ostatniej znanej listy narzędzi i płynnie przechodzi do obsługi błędów, jeśli wywołanie nie może zostać zrealizowane.

Gdy narzędzie ciągle zawodzi w rzeczywistych rozmowach #

Jeśli to samo narzędzie MCP zawiedzie 3 razy w ciągu 24 godzin podczas rozmowy prowadzonej przez Twojego agenta AI, otrzymasz jedno powiadomienie dziennie: przez e-mail, w sekcji powiadomień (ikona dzwonka) oraz jako powiadomienie push, jeśli zostało włączone. Powiadomienie wskazuje nazwę narzędzia, pokazuje ostatni błąd i zawiera linki do odpowiednich czatów, ponieważ agent poinformuje te kontakty o napotkaniu problemu technicznego. Wiersz serwera w Ustawieniach będzie wyświetlał status Failing (Awaria) wraz z liczbą błędów i ostatnim błędem, dopóki narzędzie nie zacznie ponownie działać; jedno udane wywołanie usuwa ten status. Możesz wyłączyć te powiadomienia w sekcji Ustawienia → Powiadomienia → Błędy narzędzi.

Wybór narzędzi, z których może korzystać bot #

Serwer często oferuje więcej narzędzi, niż chcesz udostępnić botowi. Możesz włączać lub wyłączać poszczególne narzędzia bez rozłączania całego serwera.

1. Kliknij ikonę ołówka (edycja) przy serwerze na liście.
2. Przewiń do sekcji Narzędzia — wymienione jest tam każde narzędzie oferowane przez serwer, każde z własnym przełącznikiem włącz/wyłącz.
3. Wyłącz każde narzędzie, którego bot nie powinien wywoływać, lub użyj opcji Włącz wszystko / Wyłącz wszystko, aby ustawić je za jednym razem.
4. Kliknij Zapisz zmiany.

Tylko narzędzia, które pozostawisz włączone, będą oferowane botowi. Narzędzie, które jest wyłączone, jest całkowicie niewidoczne dla bota — nie może go wywołać i nie będzie ono wliczane do limitu 40 narzędzi.

Warto wiedzieć o dwóch rzeczach:

• Nowe narzędzia pozostają wyłączone, dopóki ich nie włączysz. Gdy już skonfigurujesz narzędzia serwera, każde narzędzie dodane później przez serwer pojawi się jako wyłączone, więc nic nowego nie stanie się dostępne dla bota, dopóki nie zdecydujesz się tego włączyć. (Serwery, których nigdy nie konfigurowałeś, zachowują wszystkie swoje narzędzia włączone, dokładnie tak jak wcześniej.)
• Jest to oddzielone od wyboru Agenta poniżej. Tutaj decydujesz, które narzędzia serwera w ogóle istnieją w ramach całego konta; w ustawieniach Agenta decydujesz, do których serwerów ten Agent ma dostęp — i jeśli chcesz, możesz jeszcze bardziej zawęzić listę narzędzi tylko dla tego konkretnego Agenta.

Ustawianie limitów wykonania dla narzędzia #

Obok przełącznika włączania/wyłączania każdego narzędzia znajduje się kontrolka Limity. Otwiera ona te same limity wykonania, które można ustawić dla funkcji niestandardowej, stosowane tylko do tego jednego narzędzia — jest to przydatne, gdy narzędzie serwera wywołuje płatną usługę zewnętrzną lub gdy narzędzie powinno zostać uruchomione tylko raz w trakcie całej konwersacji. Wszystkie te ustawienia są opcjonalne; pozostaw je puste, a narzędzie będzie działać dokładnie tak, jak wcześniej.

• Tylko do odczytu. Niektóre serwery deklarują dla każdego narzędzia, czy służy ono wyłącznie do odczytu danych. Opcja Automatycznie (ustawienie serwera) ufa tej deklaracji; możesz ją nadpisać w obie strony — oznacz narzędzie jako Tylko do odczytu, jeśli wiesz, że nigdy nie tworzy ani nie zmienia żadnych danych (pozwala to sztucznej inteligencji bezpiecznie ponowić przerwaną odpowiedź, zamiast pozostawiać klienta bez odpowiedzi), lub jako Nie tylko do odczytu, jeśli nie ufasz deklaracji serwera.
• Używaj wyników z pamięci podręcznej przy powtórnych wywołaniach. Gdy sztuczna inteligencja wywołuje narzędzie ponownie z tymi samymi danymi wejściowymi, zamiast ponownie łączyć się z serwerem, wykorzystywany jest poprzedni wynik (przez maksymalnie 24 godziny).
• Maksymalna liczba uruchomień na konwersację oraz maksymalna liczba uruchomień w przedziale czasowym działają dokładnie tak samo jak w przypadku funkcji niestandardowych: liczą się tylko udane uruchomienia, a po osiągnięciu limitu sztuczna inteligencja otrzymuje informację o przyczynie i odpowiada na podstawie posiadanych już danych — klient nigdy nie zostaje bez odpowiedzi. Konwersacje testowe są wyłączone z tego limitu.
• Wysyłanie ofert, umów lub faktur na LinkedIn. Działa dokładnie tak samo jak w przypadku funkcji niestandardowych: przy ustawieniu Automatycznie, narzędzie, którego nazwa lub opis sugeruje wysyłanie oferty, umowy, wyceny, faktury, linku do płatności lub dostępu, nie jest uruchamiane, gdy sztuczna inteligencja odpowiada na LinkedIn; opcja Dozwolone pozwala na jego uruchomienie, a Nigdy na LinkedIn blokuje narzędzie, którego automatyczna weryfikacja mogłaby nie wykryć. Inne kanały nie są objęte tym ograniczeniem, a ustawienie ma zastosowanie również w trybie wypróbowania (Try Out).

Jedna szczera uwaga dotycząca zaufania: limity kontrolują, czy i jak często wywołujemy serwer — nie mogą one zmienić tego, co serwer robi wewnętrznie po wywołaniu. Ponadto nadpisanie narzędzia zewnętrznego jako „Tylko do odczytu” jest silniejszym założeniem niż w przypadku własnej funkcji niestandardowej, ponieważ jest to kod kogoś innego; rób to tylko dla narzędzi, które rozumiesz.

Włączanie serwera dla Agenta #

Rejestracja serwera sprawia, że staje się on dostępny; nadal jednak wybierasz, którzy Agenci mogą z niego korzystać.

1. Otwórz Agenta i przejdź do karty Możliwości AI.
2. Znajdź sekcję Serwery MCP.
3. Włącz każdy serwer, z którego ma korzystać bot tego Agenta.
4. Kliknij Zapisz zmiany — wybory zostaną zastosowane dopiero po zapisaniu.

Możesz włączyć do 5 serwerów na Agenta. Tylko serwery, które włączysz, będą dostępne dla bota danego Agenta, co pozwala skupić bota na narzędziach, które są istotne.

Wybór narzędzi, z których może korzystać Agent #

Gdy serwer zostanie włączony dla Agenta, możesz również zawęzić, które z jego narzędzi dany Agent może wywoływać — jest to przydatne, gdy jeden Agent powinien tylko odczytywać dane, podczas gdy inny może również tworzyć rekordy.

1. W zakładce AI Abilities, pod włączonym serwerem, kliknij wiersz “… tools enabled for this agent”, aby rozwinąć listę narzędzi.
2. Wyłącz każde narzędzie, którego ten Agent nie powinien używać, a następnie kliknij Save changes.

Dwie zasady zapewniają przewidywalność tego procesu:

• Agent może tylko zawężać, nigdy rozszerzać. Narzędzia, które wyłączyłeś w skali całego konta (na stronie MCP Servers), nie pojawiają się tutaj i nie mogą zostać ponownie włączone dla pojedynczego Agenta.
• Agenci dziedziczą domyślnie. Agent, w przypadku którego nie ingerowałeś w listę narzędzi, po prostu korzysta z wyboru dokonanego w skali konta — w tym z narzędzi, które włączysz tam później. Gdy zawęzisz listę Agenta, nowe narzędzia pozostaną dla niego wyłączone, dopóki ich nie włączysz.

Gotowy przykład: Połącz sklep Shopify #

Każdy sklep Shopify jest wyposażony we wbudowany serwer MCP — nie trzeba instalować żadnej aplikacji ani tworzyć klucza. Shopify hostuje go pod adresem internetowym sklepu z dopiskiem /api/mcp na końcu.

Co bot zyskuje dzięki temu:

• Wyszukiwanie produktów — znajdowanie produktów poprzez opisanie potrzeb klienta („ciepła kurtka do biegania poniżej 100 USD”), wraz z aktualnymi cenami, wariantami i stanami magazynowymi.
• Szczegóły produktu — pełne informacje o konkretnym produkcie, w tym opcje i dostępność.
• Zasady sklepu i FAQ — odpowiedzi na pytania dotyczące wysyłki, zwrotów, refundacji i prywatności, pobierane bezpośrednio ze stron sklepu.
• Koszyk — tworzenie koszyka dla klienta i przekazywanie mu linku do kasy.

Aby połączyć sklep, dodaj serwer z następującymi danymi:

Zapisz, kliknij Testuj połączenie i włącz serwer w swoim agencie — to cała konfiguracja.

Warto wiedzieć o dwóch rzeczach:

• Zamówienia nie znajdują się na tym serwerze. Shopify celowo nie udostępnia danych o zamówieniach w tym publicznym punkcie końcowym. W przypadku pytań typu „gdzie jest moje zamówienie?”, połącz ten serwer z jedną funkcją niestandardową — zobacz przykład statusu zamówienia Shopify.
• Działa dla każdego sklepu Shopify — w tym dla sklepu klienta, jeśli zarządzasz kontami innych osób. Wystarczy adres internetowy sklepu.

Bezpieczeństwo — łącz się tylko z serwerami, którym ufasz #

Serwer MCP, z którym się łączysz, może być wywoływany przez Twojego bota i może zwracać tekst, który bot odczytuje i na podstawie którego podejmuje działania. Traktuj go jak każdą inną integrację, która posiada klucz dostępu do Twoich systemów:

• Rejestruj tylko serwery, które kontrolujesz lub którym w pełni ufasz. Opis narzędzia jest tworzony przez osobę zarządzającą serwerem, a bot odczytuje te opisy, aby zdecydować, kiedy użyć narzędzia.
• Używaj dedykowanego, ograniczonego klucza API, a nie danych logowania administratora. Twój klucz jest przechowywany bezpiecznie i nigdy nie jest pokazywany w eksportach danych. To samo dotyczy logowania przez OAuth — tokeny dostępu są przechowywane bezpiecznie i usuwane z wszelkich eksportów.
• Adres URL musi być publicznym adresem https://. Adresy wewnętrzne, localhost oraz adresy sieci prywatnych są odrzucane ze względów bezpieczeństwa.
• Wyłącz serwer w momencie, gdy przestaniesz mu ufać — przełącz go na wyłączony lub usuń, a natychmiast zniknie on z każdego Agenta.

Rozwiązywanie problemów #

• Czerwona kropka statusu / połączenie nieudane: Otwórz ponownie serwer i kliknij Testuj połączenie, aby zobaczyć dokładny błąd. Najczęstsze przyczyny to błędny lub wygasły klucz, literówka w adresie URL lub serwer wymagający innej nazwy nagłówka niż Authorization.
• Serwer OAuth przestał działać / prosi o ponowne połączenie: Logowanie przez OAuth może zostać cofnięte lub wygasnąć po stronie serwera. Otwórz serwer i kliknij ponownie Połącz, aby zalogować się ponownie. Pamiętaj, że loginy OAuth nigdy nie są kopiowane między kontami, więc serwery skopiowanego Agenta muszą zostać ponownie połączone na koncie, do którego go skopiowano.
• Bot nie używa narzędzia: Najpierw sprawdź, czy narzędzie jest włączone w sekcji Narzędzia serwera (edytuj serwer, aby zobaczyć listę) — wyłączone narzędzie jest niewidoczne dla bota. Następnie upewnij się, że serwer jest włączony dla tego konkretnego Agenta oraz że żądanie klienta wyraźnie pasuje do działania narzędzia. Podobnie jak w przypadku funkcji niestandardowych, jasne nazwy i opisy narzędzi po stronie serwera pomagają botowi dokonać właściwego wyboru.
• Narzędzie oferowane przez serwer nie pojawia się dla bota: Jeśli zarządzałeś narzędziami tego serwera, pamiętaj, że każde narzędzie dodane po zakończeniu zarządzania jest domyślnie wyłączone. Edytuj serwer, otwórz sekcję Narzędzia i włącz je.
• Czy konektor obsługuje sesje MCP HTTP? Tak. Jeśli Twój serwer wydaje nagłówek mcp-session-id podczas nawiązywania połączenia, przechowujemy go i odsyłamy przy każdym kolejnym żądaniu, wraz z nagłówkiem MCP-Protocol-Version. Serwery stanowe działają bez żadnej dodatkowej konfiguracji po Twojej stronie.
• Czy to działa z serwerami korzystającymi ze starszego połączenia SSE? Tak. Wklej adres serwera w podanej formie, włącznie z końcówką taką jak /sse. Your AI Connector automatycznie używa starszego typu połączenia, gdy serwer nie obsługuje nowszego. Niektóre serwery (na przykład Baserow) umieszczają klucz w samym adresie; w takich przypadkach pozostaw wybraną opcję Klucz API / nagłówek, a pole Wartość nagłówka autoryzacji pozostaw puste.
• Narzędzie zostało pominięte: Agent może używać jednocześnie maksymalnie 5 serwerów i 40 narzędzi MCP. Jeśli serwer oferuje bardzo dużą liczbę narzędzi, niektóre z nich mogą nie zostać załadowane — wyłącz narzędzia, których nie potrzebujesz, w sekcji Narzędzia serwera lub ogranicz każdy serwer do narzędzi, których faktycznie używasz.

Wymagania planu #

Serwery MCP są częścią zestawu narzędzi programistycznych, obok funkcji niestandardowych. Jeśli nie widzisz MCP Servers w sekcji AI Studio na pasku bocznym, Twój obecny plan ich nie obejmuje — przejdź na plan z narzędziami programistycznymi, aby je włączyć.

Następne kroki #

• Funkcje niestandardowe — ręczne skonfigurowanie pojedynczego narzędzia zamiast podłączania całego serwera.
• Agenci AI — miejsce, w którym serwery MCP są włączane dla bota.
• Agenci AI — główna strona grupy AI Studio, w której znajdują się serwery MCP.