Integracja niestandardowego serwera z Vibe
Na tej stronie
Aktualizacja z 2 listopada 2026 r. — Le Chat to teraz Vibe. Od 28 maja 2026 r. Le Chat zmienił nazwę na Vibe (nadal pod adresem chat.mistral.ai): to pojedynczy agent do pracy i kodowania, który zachowuje Twoje konwersacje, ustawienia i subskrypcje. Legacyjne doświadczenie Le Chat pozostaje dostępne w trybie Chat; w trybie Work agenci stali się umiejętnościami (wywoływanymi za pomocą
@), pamięci przekształciły się w bazę wiedzy, a głębokie wyszukiwanie stało się umiejętnością Deep Research. Plany noszą teraz nazwy Mistral Free, Pro, Team i Enterprise. W tej lekcji używamy nazwy Vibe; pamiętaj, że niektóre opisane tu menu mogły zmienić nazwy lub lokalizację.
Podłącz swój serwer MCP do Vibe
Twój serwer jest wdrożony i odpowiada przez HTTPS pod stabilnym adresem. Teraz czas na krok, który nadaje sens całej Twojej dotychczasowej pracy: udostępnienie go w rozmowie docelowym odbiorcom, w tym osobom, które nigdy nie otworzą terminala. Vibe akceptuje każdy zgodny serwer MCP jako niestandardowy konektor. Ta lekcja obejmuje dodawanie konektora, przechodzenie przez przepływy wywołań w rozmowie oraz diagnozowanie błędów – ponieważ pierwsza próba często kończy się niepowodzeniem.
Dodawanie konektora
Otwórz Vibe pod adresem chat.mistral.ai i przejdź do zakładki Connectors na pasku bocznym. Znajdziesz tam dwie odrębne sekcje: polecane konektory, skonfigurowane wcześniej przez Mistral (GitHub, Notion i inne), oraz Twoje własne konektory niestandardowe, początkowo puste. Kliknij Add Custom Connector i wypełnij pola:
- Name: Opisowa nazwa (np. „Menedżer zadań“)
- Server URL: Pełny adres URL Twojego punktu końcowego MCP (np.
https://my-server.com/tasks/mcp) - Description: Co robi Twój serwer (opcjonalne, ale zalecane)
Następnie wybierz metodę uwierzytelniania: No authentication dla serwera publicznego, Token, jeśli wklejasz swój token API, lub OAuth 2.0 dla pełnego przepływu zgody. Kliknięcie Connect uruchamia wykrywanie: jeśli operacja się powiedzie, Vibe wyświetla listę narzędzi znalezionych na Twoim serwerze, pokazując nazwę i opis każdego z nich. To Twoja pierwsza rzeczywista informacja zwrotna na temat jakości docstringów – czytasz je tutaj dokładnie tak, jak otrzyma je model.
Co dzieje się podczas rozmowy
Po podłączeniu Twój serwer pojawia się w sekcji Tools na pasku bocznym czatu, oznaczony ikoną wskazującą na dostępność zewnętrznego narzędzia. Użytkownik formułuje swoje żądanie w języku naturalnym, a model je tłumaczy:
Użytkownik: Utwórz zadanie o wysokim priorytecie, aby przygotować demo MCP
Vibe: [Wywoływanie create_task z następującymi argumentami]
- title: "Przygotuj demo MCP"
- priority: "wysoki"
→ Czy chcesz autoryzować to wywołanie narzędzia?
Użytkownik: [Autoryzuj]
Vibe: Zadanie „Przygotuj demo MCP“ zostało pomyślnie utworzone
z wysokim priorytetem. Jego identyfikator to abc123.
To monit potwierdzający jest domyślnym zachowaniem. Możesz zatwierdzać go doraźnie lub przełączyć narzędzie na trwałą autoryzację. Oprzyj się pokusie robienia tego dla dowolnego serwera, którego nie jesteś właścicielem. Potwierdzenie chroni nie tylko przed błędami; jest Twoją jedyną obroną przed iniekcjami promptów, gdzie instrukcje ukryte w danych zwracanych przez narzędzie kierują model do wywołań, których nikt nie żądał. To właśnie obserwacja przewijających się argumentów przed walidacją pozwala Ci wykryć anomalie.
Kiedy coś nie działa
Komunikat „Unable to connect“ prawie zawsze wynika z jednej z czterech przyczyn: adres URL jest nieosiągalny z zewnątrz, protokół nie jest HTTPS (czego wymaga Vibe), serwer po prostu nie działa lub nie skonfigurowano CORS, mimo że Vibe wysyła żądania z przeglądarki. Poniższe polecenie pozwala rozróżnić dwie pierwsze hipotezy w kilka sekund:
# Test dostępności
curl -X POST https://your-url/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'
Jeśli połączenie zostanie nawiązane, ale żadne narzędzia się nie pojawią, prześledź łańcuch z powrotem po stronie serwera: sprawdź, czy dekorator @app.tool() znajduje się na każdej funkcji, czy nie brakuje docstringów i czy serwer MCP jest zamontowany na trasie, o której myślisz. Przed wszelkimi innymi badaniami użyj MCP Inspector.
Najbardziej mylącym przypadkiem jest sytuacja, gdy wszystko działa, ale model wywołuje niewłaściwe narzędzie lub nie wywołuje żadnego. Problem nie leży wtedy w warstwie technicznej: model wybiera na podstawie opisów, a jeśli dwa narzędzia wyglądają podobnie lub jedno pozostaje niejasne, wybór będzie błędny. Użyj trzech dźwigni, w tej kolejności: spraw, by opis był bardziej szczegółowy, wyjaśniając przypadek użycia; zmień nazwę narzędzia, aby usunąć niejednoznaczność; i zmniejsz liczbę narzędzi aktywnych jednocześnie. Na koniec, jeśli narzędzie zwraca błąd, sprawdź logi serwera, odtwórz wywołanie ręcznie w inspektorze i upewnij się, że zmienne środowiskowe są ustawione, a token lub zakresy OAuth przyznają oczekiwane uprawnienia.
MCP Inspector: użyj go przed Vibe
Inspektor testuje Twoje narzędzia bez angażowania modelu, izolując połowę zmiennych w problemie:
npx @modelcontextprotocol/inspector
Otwiera interfejs webowy, w którym łączysz się ze zdalnym serwerem poprzez jego adres URL, wyświetlasz listę wszystkich narzędzi z ich opisami i parametrami, wykonujesz narzędzie z wybranymi przez siebie argumentami i odczytujesz surową odpowiedź serwera. Wyrób sobie nawyk przeprowadzania tej проверки systematycznie przed dodaniem serwera do Vibe, ponieważ daje ona natychmiastową diagnozę: jeśli narzędzie odpowiada poprawnie w inspektorze, ale zawodzi w Vibe, wina nie leży po stronie serwera, a problem tkwi w opisie lub prompcie.
Funkcjonowanie z wieloma serwerami
Gdy już zainstalujesz kilka konektorów, dyscyplina staje się głównym czynnikiem wpływającym na jakość. Vibe pozwala przełączać każdy konektor: utrzymuj aktywne tylko narzędzia niezbędne dla bieżącego zadania, ponieważ model zalany pięćdziesięcioma narzędziami wybiera mniej dokładnie i odpowiada wolniej. Ta higiena opiera się na separacji domen omówionej w Lekcji 10 – jeden serwer do zarządzania projektami, jeden do monitoringu, jeden do narzędzi wewnętrznych – ponieważ wtedy musisz aktywować tylko ten pasujący do bieżącej rozmowy.
Na koniec dostosuj swoje prompty do faktycznie udostępnionych możliwości:
# Dobrze: odzwierciedla możliwości narzędzia
„Utwórz zadanie o wysokim priorytecie zatytułowane 'Przygotuj demo'“
# Źle: zbyt ogólnie, model nie wie, którego narzędzia użyć
„Zarządzaj moim projektem“
Jeszcze jedna warta uwagi kwestia przed zaprojektowaniem Twoich serwerów: konektory MCP skonfigurowane w Vibe pozostają dostępne w aplikacji mobilnej. Twoje narzędzia wewnętrzne stają się thus dostępne z telefonu, otwierając scenariusze użytkowania w terenie, o których mogłeś nie pomyśleć, rozwijając oprogramowanie na komputerze stacjonarnym.
Kluczowe wnioski
- Dodanie niestandardowego konektora w Vibe zajmuje 3 kroki: nazwa, URL, auth
- Pozostaw ręczne potwierdzanie wywołań narzędzi włączone ze względów bezpieczeństwa
- Użyj MCP Inspector, aby przetestować i debugować przed integracją z Vibe
- Ulepsz opisy narzędzi, jeśli model nie używa ich poprawnie
- Utrzymuj aktywne tylko narzędzia niezbędne dla bieżącego zadania
- Twoje serwery MCP są również dostępne na urządzeniach mobilnych