# 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ć. --- ## 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ć:** | | Funkcje niestandardowe | Serwery MCP | | ------------------ | --------------------------------------------------- | -------------------------------------------------------------- | | **Co konfigurujesz** | Jedno narzędzie na raz, w pełni ręcznie (URL, dane wejściowe, mapowanie odpowiedzi). | Jeden adres serwera — bot automatycznie wykrywa wszystkie jego narzędzia. | | **Najlepsze dla** | Pojedynczego, konkretnego wywołania do własnego systemu. | Łączenia z usługą, która obsługuje MCP i oferuje wiele narzędzi. | | **Utrzymanie** | Aktualizujesz funkcję, gdy zmienia się narzędzie. | Nowe narzędzia z serwera pojawiają się automatycznie. | 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. ### 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: | Poziom jakości AI | Kredyty za wywołanie narzędzia MCP | Z podłączonym własnym kluczem Anthropic (BYOK) | |---|---|---| | Pro | 1 kredyt | 0 kredytów — działa na Twoim kluczu | | Economy (przestarzałe) | 0,5 kredytu | 0 kredytów — działa na Twoim kluczu | | Max | 0,25 kredytu | nadal 0,25 kredytu, naliczane nawet przy podłączonym własnym kluczu, ponieważ Max działa na naszym modelu | | Mini | 0,15 kredytu | nadal 0,15 kredytu, naliczane nawet przy podłączonym własnym kluczu, ponieważ Mini działa na naszym modelu | --- ## 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: | Pole | Co wpisać | Przykład | | -------------------- | ----------------------------------------------------------------------------- | --------------------------------- | | **Nazwa** | Krótka etykieta serwera (używana również do nazywania jego narzędzi dla bota). | `Order System` | | **URL serwera** | Adres MCP serwera (czasami nazywany "punktem końcowym"), zaczynający się od `https://`. | `https://tools.mystore.com/mcp` | | **Nazwa nagłówka aut.** | Nagłówek, którego serwer oczekuje do uwierzytelnienia. Pozostaw `Authorization`, chyba że dokumentacja serwera mówi inaczej. | `Authorization` | | **Wartość nagłówka aut.**| Same dane uwierzytelniające w formacie oczekiwanym przez serwer. | `Bearer sk_live_abc123` | ### 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. ### 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](custom-functions.md#execution-limits), 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. **Automatyczny (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 AI na bezpieczne ponowienie przerwanej odpowiedzi zamiast pozostawiania klienta bez odpowiedzi), lub jako **Nie tylko do odczytu**, jeśli nie ufasz deklaracji serwera. - **Zwracaj wyniki z pamięci podręcznej przy powtórnych wywołaniach.** Gdy AI wywoła narzędzie ponownie z tymi samymi danymi wejściowymi, poprzedni wynik zostanie użyty ponownie (przez maksymalnie 24 godziny) zamiast ponownego wywoływania serwera. - **Maksymalna liczba uruchomień na konwersację** oraz **maksymalna liczba uruchomień w oknie czasowym** działają dokładnie tak samo, jak w przypadku funkcji niestandardowych: dotyczą tylko udanych uruchomień, a po osiągnięciu limitu AI otrzymuje informację o przyczynie i odpowiada na podstawie posiadanych już danych — klient nigdy nie zostaje bez odpowiedzi. Konwersacje testowe są wyłączone z tych limitów. 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](../ai-agents/ai-agents.md) i przejdź do karty **Możliwości AI**. (W przypadku kampanii, która nadal posiada własne ustawienia AI bezpośrednio, a nie przez oddzielnego Agenta, ta sama lista pojawia się w kroku **Możliwości AI** danej kampanii). 2. Znajdź sekcję **Serwery MCP**. 3. Włącz każdy serwer, z którego bot tego Agenta ma móc korzystać. 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: | Pole | Co wpisać | |---|---| | **Nazwa** | `Shopify Store` (lub nazwa sklepu) | | **Adres URL serwera** | Adres internetowy sklepu plus `/api/mcp` — na przykład `https://mystore.com/api/mcp`. Działa również techniczny adres sklepu: `https://mystore.myshopify.com/api/mcp`. | | **Uwierzytelnianie** | Pozostaw wybraną opcję **Klucz API / nagłówek** i pozostaw pole **Wartość nagłówka autoryzacji** puste — ten serwer nie wymaga klucza. | 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](custom-functions.md#complete-example-shopify-order-status). - **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 nazwy nagłówka innej niż `Authorization`. - **Serwer OAuth przestał działać / prosi o ponowne połączenie:** Logowania OAuth mogą zostać cofnięte lub wygasnąć po stronie serwera. Otwórz serwer i kliknij ponownie **Połącz**, aby zalogować się ponownie. Pamiętaj, że logowania OAuth nigdy nie są kopiowane między kontami, więc serwery skopiowanego Agenta lub kampanii muszą zostać ponownie połączone na koncie, do którego zostały skopiowane. - **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 danego Agenta i że prośba 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 wyświetla 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 wysyła nagłówek `mcp-session-id` po ustanowieniu 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 z Twojej strony. - **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 niepotrzebne narzędzia w sekcji **Narzędzia** serwera lub ogranicz każdy serwer do narzędzi, z których faktycznie korzystasz. --- ## 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](custom-functions.md) — ręczne skonfigurowanie pojedynczego narzędzia zamiast podłączania całego serwera. - [Agenci AI](../ai-agents/ai-agents.md) — miejsce, w którym serwery MCP są włączane dla bota. - [Agenci AI](../ai-agents/ai-agents.md) — główna strona grupy AI Studio, w której znajdują się serwery MCP.