Przejdź do głównej treści
Polski— Wybierz język
Menu

Dodawanie niestandardowego złącza MCP

Lekcja 11 z 14 Zaktualizowano 2 listopada 2026 Średnio zaawansowani
Na tej stronie
  1. Poza oficjalnym katalogiem
  2. Proces dodawania
  3. Metody uwierzytelniania
  4. Wymagania wstępne dla Twojego serwera MCP
  5. Testowanie za pomocą MCP Inspector
  6. Zarządzanie w organizacji
  7. Bezpieczeństwo niestandardowych złączy
  8. Kluczowe wnioski

Zaktualizowano 2 listopada 2026 r. — Le Chat to teraz Vibe. Od 28 maja 2026 r. Le Chat zmienił nazwę na Vibe (nadal dostępny pod adresem chat.mistral.ai): to pojedynczy agent do pracy i kodowania, który zachowuje Twoje konwersacje, ustawienia i subskrypcje. Starsza wersja Le Chat jest nadal dostępna w trybie Chat; w trybie Work agenci to teraz umiejętności (wywoływane za pomocą `@»), pamięci służą jako baza wiedzy, a głębokie wyszukiwanie to umiejętność Deep Research. Plany noszą teraz nazwy Mistral Free, Pro, Team i Enterprise. W tej lekcji używamy nazwy Vibe; niektóre opisane tu menu mogły zmienić nazwy lub lokalizację.

Poza oficjalnym katalogiem

Wbudowane złącza obsługują wiele przypadków użycia, ale Twoja organizacja prawdopodobnie polega na narzędziach wewnętrznych, prywatnych API lub niszowych usługach, których nie ma w katalogu Vibe. Tu z pomocą przychodzą niestandardowe złącza: możesz dodać do Vibe dowolny zdalny serwer MCP, podając po prostu jego adres URL. Dzięki temu wewnętrzny system CRM stworzony sześć lat temu staje się dostępny w rozmowie, tak samo jak GitHub czy Notion.

Proces dodawania

Dodanie złącza zajmuje tylko kilka kliknięć w interfejsie. Otwórz kartę Connectors (Złącza), kliknij Add a custom connector (Dodaj niestandardowe złącze) na dole listy i wypełnij wymagane dane:

  • Name (Nazwa): Opisowa nazwa identyfikująca złącze (na przykład „Wewnętrzny CRM“ lub „API pogodowe“)
  • Server URL (Adres URL serwera): Publiczny adres Twojego serwera MCP, wraz z końcówką /mcp (na przykład https://mon-serveur.example.com/mcp)
  • Description (Opis): Krótkie wyjaśnienie działania złącza (opcjonalne, ale zalecane)
  • Authentication method (Metoda uwierzytelniania): Brak, Token lub OAuth 2.0

Na koniec kliknij Create (Utwórz), aby zapisać złącze. Vibe automatycznie odpytuje serwer, aby odkryć dostępne narzędzia: pojawia się lista udostępnionych funkcji i możesz zacząć z nich korzystać w swoich rozmowach.

To żądanie odkrywania zwraca nazwę, tekstowy opis, oczekiwane parametry (z ich nazwą, typem i opisem) oraz typ zwracany dla każdego narzędzia. To jedyne dane, z których model Mistral korzysta, aby zdecydować, kiedy i jak wywołać dane narzędzie – dlatego kolejna lekcja skupia się mocno na jakości opisów. Dobrze napisane narzędzie ze słabym opisem pozostaje dla modelu niewidoczne.

Metody uwierzytelniania

Najprostszy przypadek to brak uwierzytelniania: Twój serwer MCP jest dostępny dla każdego, kto zna jego adres URL. Działa to w przypadku narzędzi publicznych, które nie przetwarzają danych wrażliwych, prototypów, demonstracji oraz serwerów MCP opakowujących publiczne API. Uwierzytelnianie tokenem polega na podaniu klucza wysyłanego z każdym żądaniem do serwera; Vibe przechowuje token w sposób bezpieczny. Wybierz tę opcję dla wewnętrznych API chronionych kluczem API, serwerów, które muszą identyfikować wywołującego, oraz w każdym scenariuszu, w którym chcesz ograniczyć dostęp. Na koniec mamy OAuth 2.0 – pełny przepływ z przekierowaniem do strony autoryzacji usługi: to najbardziej bezpieczny mechanizm, ale też najtrudniejszy do wdrożenia po stronie serwera; zostanie on szczegółowo omówiony w przyszłych przewodnikach Mistral AI.

Wymagania wstępne dla Twojego serwera MCP

Czego Vibe wymaga od serwera MCP
  • Dostępność przez publiczny adres URL (bez localhost)
  • Udostępnienie punktu końcowego w formacie Streamable HTTP (/mcp)
  • Odpowiadanie na żądania odkrywania narzędzi w standardowym formacie JSON MCP
  • Prawidłowe obsługiwanie wywołań narzędzi i zwracanie wyników w oczekiwanym formacie

Wymóg publicznego adresu URL może wydawać się blokadą dla rozwoju lokalnego, ale istnieje obejście na etapie debugowania. Jeśli rozwijasz projekt na swojej maszynie i chcesz przetestować go z Vibe przed wdrożeniem, otwórz tunel do swojego lokalnego serwera za pomocą ngrok:

ngrok http 8000

ngrok przydziela Ci tymczasowy publiczny adres URL, którego możesz użyć jako adresu URL złącza w Vibe. To podejście jest idealne do rozwoju i testów: modyfikujesz kod, restartujesz serwer, a Vibe natychmiast widzi nową wersję bez żadnego wdrożenia.

Testowanie za pomocą MCP Inspector

Przed dodaniem serwera do Vibe przetestuj go za pomocą MCP Inspector – narzędzia open source, które weryfikuje, czy Twój serwer poprawnie odpowiada na żądania odkrywania, wyświetla listę dostępnych narzędzi z ich opisami i parametrami, wykonuje ręczne wywołania narzędzi w celu sprawdzenia wyników oraz pomaga debugować problemy z formatowaniem lub typowaniem. Uruchom je prostym poleceniem npx:

npx @modelcontextprotocol/inspector

Inspector otwiera lokalny interfejs webowy, w którym łączysz się ze swoim serwerem MCP i testujesz każde narzędzie z osobna. Ten krok to nie tylko formalność: oszczędza Ci marnowania wiadomości w rozmowie na debugowanie i wyraźnie oddziela błędy serwera od błędów interpretacji modelu.

Zarządzanie w organizacji

Jeśli należysz do organizacji w Vibe, pamiętaj, że dodane przez Ciebie niestandardowe złącza są widoczne dla innych członków. Administrator może wyłączyć dowolne złącze dla całej organizacji, jeśli uzna je za niewłaściwe lub niezabezpieczone. Każdy użytkownik musi jednak samodzielnie podać swoje dane uwierzytelniające – token lub OAuth – dla złączy wymagających autoryzacji: udostępnienie złącza nigdy nie oznacza udostępnienia danych dostępowych.

Bezpieczeństwo niestandardowych złączy

W przeciwieństwie do oficjalnych złączy zweryfikowanych przez Mistral AI, niestandardowe złącze może wykonywać dowolny kod po stronie serwera, a tekstowy opis, który widzisz, nie gwarantuje niczego na temat rzeczywistych działań serwera. Korzystaj wyłącznie z serwerów, które sam opracowałeś, tych od zaufanych kolegów lub partnerów oraz serwerów open source, których kod zweryfikowałeś. Nawet w przypadku własnych złączy保持 włączoną walidację przez człowieka przez cały etap debugowania; gdy już upewnisz się, że wszystko działa poprawnie, możesz rozważyć ustawienie narzędzi tylko do odczytu na „Always Allow“ (Zawsze zezwalaj).

Kluczowe wnioski

  • Możesz dodać dowolny zdalny serwer MCP jako niestandardowe złącze w Vibe
  • Serwer musi być dostępny przez publiczny adres URL z punktem końcowym /mcp
  • Obsługiwane są trzy metody uwierzytelniania: brak, token i OAuth 2.0
  • Użyj ngrok, aby przetestować swój lokalny serwer z Vibe przed wdrożeniem
  • MCP Inspector jest niezbędny do debugowania serwera przed integracją
  • Dodawaj złącza tylko z zaufanych źródeł i保持 włączoną walidację przez człowieka