Pridanie vlastného konektora MCP
Na tejto strane
Aktualizované 2. novembra 2026 — Le Chat je teraz Vibe. Od 28. mája 2026 prešiel Le Chat rebrandingom na Vibe (stále na chat.mistral.ai): ide o jedného agenta pre prácu aj kód, ktorý si zachováva tvoje konverzácie, nastavenia a predplatné. Pôvodné prostredie Le Chat zostáva dostupné v režime Chat; v režime Work sú agenti teraz zručnosti (vyvolávané pomocou
@), pamäte slúžia ako znalostná báza a hĺbkové vyhľadávanie je zručnosť Deep Research. Plány sa teraz nazývajú Mistral Free, Pro, Team a Enterprise. Táto lekcia používa názov Vibe; niektoré tu opísané ponuky mohli zmeniť názvy alebo umiestnenie.
Mimo oficiálneho adresára
Vstavané konektory pokrývajú mnoho prípadov použitia, ale tvoja organizácia pravdepodobne závisí od interných nástrojov, proprietárnych API alebo špecializovaných služieb, ktoré v adresári Vibe chýbajú. Práve tu prichádzajú na rad vlastné konektory: do Vibe môžeš pridať ľubovoľný vzdialený server MCP jednoducho uvedením jeho URL. Ten interný CRM systém postavený pred šiestimi rokmi sa tak stane použiteľným v konverzácii rovnako ako GitHub alebo Notion.
Proces pridávania
Pridanie konektora zaberie len niekoľko kliknutí v rozhraní. Otvor kartu Connectors, klikni na Add a custom connector v spodnej časti zoznamu a vyplň požadované údaje:
- Name: Výstižný názov na identifikáciu konektora (napríklad „Interný CRM“ alebo „Weather API“)
- Server URL: Verejná adresa tvojho servera MCP vrátane koncového bodu
/mcp(napríkladhttps://mon-serveur.example.com/mcp) - Description: Stručné vysvetlenie funkcie konektora (voliteľné, ale odporúčané)
- Authentication method: Žiadna, Token alebo OAuth 2.0
Nakoniec klikni na Create a ulož konektor. Vibe automaticky odosla dopyt na server, aby objavil dostupné nástroje: zobrazí sa zoznam exponovaných funkcií a môžeš ich začať používať vo svojich konverzáciách.
Tento dopyt na objavovanie vráti názov, textový popis, očakávané parametre (s ich názvom, typom a popisom) a návratový typ pre každý nástroj. Ide o jediné detaily, ktoré model Mistral využíva na rozhodovanie o tom, kedy a ako každý nástroj vyvolať – preto sa nasledujúca lekcia intenzívne zameriava na kvalitu popisov. Dobre napísaný nástroj so zlým popisom zostane pre model neviditeľný.
Metódy overovania
Najjednoduchším prípadom je žiadne overovanie: tvoj server MCP je prístupný každému, kto pozná jeho URL. Funguje to pre verejné nástroje, ktoré nespracúvajú citlivé údaje, prototypy, demá a servery MCP obaľujúce verejné API. Overovanie tokenom zahŕňa poskytnutie kľúča, ktorý sa odosiela s každou požiadavkou na server; Vibe token bezpečne uloží. Túto metódu vyber pre interné API chránené API kľúčom, servery, ktoré potrebujú identifikovať volajúceho, a akýkoľvek scenár, kde chceš obmedziť prístup. Nakoniec tu je OAuth 2.0, kompletný tok s presmerovaním na autorizačnú stránku služby: je to najbezpečnejší mechanizmus, ale aj najzložitejší na implementáciu na strane servera a bude podrobne prebraný v budúcich sprievodcoch Mistral AI.
Predpoklady pre tvoj server MCP
- Prístupnosť cez verejnú URL (žiadne localhost)
- Exponovanie koncového bodu vo formáte Streamable HTTP (
/mcp) - Odozva na požiadavky objavovania nástrojov v štandardnom formáte MCP JSON
- Správne spracovanie volaní nástrojov a vrátenie výsledkov v očakávanom formáte
Požiadavka na verejnú URL sa môže zdať ako prekážka pre lokálny vývoj, ale počas fázy ladenia existuje obchádzka. Ak vyvíjaš na svojom stroji a chceš testovať s Vibe pred nasadením, otvor tunel k svojmu lokálnemu serveru pomocou nástroja ngrok:
ngrok http 8000
ngrok ti poskytne dočasnú verejnú URL, ktorú môžeš použiť ako URL konektora vo Vibe. Tento prístup je ideálny pre vývoj a testovanie: upravíš kód, reštartuješ server a Vibe okamžite vidí novú verziu bez akéhokoľvek nasadzovania.
Testovanie pomocou MCP Inspector
Pred pridaním servera do Vibe ho otestuj pomocou nástroja MCP Inspector, open-source nástroja, ktorý overuje, či tvoj server správne odpovedá na požiadavky objavovania, vypisuje dostupné nástroje s ich popismi a parametrami, manuálne vykonáva volania nástrojov na kontrolu výsledkov a pomáha ladiť problémy s formátovaním alebo typmi. Spustíš ho jednoduchým príkazom npx:
npx @modelcontextprotocol/inspector
Inspector otvorí lokálne webové rozhranie, kde sa pripojíš k svojmu serveru MCP a otestuješ každý nástroj jednotlivo. Tento krok nie je len formalitou: ušetrí ti plytvanie správami v konverzácii pri ladení a jasne izoluje chyby servera od chýb interpretácie modelu.
Organizačná správa
Ak si súčasťou organizácie vo Vibe, uvedom si, že vlastné konektory, ktoré pridáš, sú viditeľné pre ostatných členov. Administrátor môže zakázať akýkoľvek konektor pre celú organizáciu, ak ho považuje za nevhodný alebo nezabezpečený. Každý používateľ však musí poskytnúť svoje vlastné poverenia – token alebo OAuth – pre konektory vyžadujúce overovanie: zdieľanie konektora nikdy neznamená zdieľanie prístupových údajov.
Bezpečnosť vlastných konektorov
Na rozdiel od oficiálnych konektorov validovaných spoločnosťou Mistral AI môže vlastný konektor vykonávať ľubovoľný kód na strane servera a textový popis, ktorý vidíš, nezaručuje nič o tom, čo server skutočne robí. Drž sa serverov, ktoré si vyvinul sám, tých od dôveryhodných kolegov alebo partnerov a open-source serverov, ktorých kód si si overil. Aj pri vlastných konektoroch maj počas fázy ladenia povolené ľudské overovanie; keď si istý, že všetko funguje, môžeš zvážiť nastavenie nástrojov len na čítanie na „Always Allow“.
Kľúčové poznatky
- Ako vlastný konektor vo Vibe môžeš pridať ľubovoľný vzdialený server MCP
- Server musí byť prístupný cez verejnú URL s koncovým bodom
/mcp - Podporované sú tri metódy overovania: žiadna, token a OAuth 2.0
- Na testovanie lokálneho servera s Vibe pred nasadením použi ngrok
- MCP Inspector je nevyhnutný na ladenie servera pred integráciou
- Pridávaj iba konektory z dôveryhodných zdrojov a udržuj povolené ľudské overovanie