Dodajanje prilagojenega povezovalnika MCP
Na tej strani
Posodobljeno 2. novembra 2026 — Le Chat je zdaj Vibe. Od 28. maja 2026 dalje je bil Le Chat preimenovan v Vibe (še vedno na chat.mistral.ai): en sam agent za delo in kodo, ki ohranja tvoja pogovora, nastavitve in naročnine. Stara izkušnja Le Chat ostaja na voljo v načinu Chat; v načinu Work so agenti zdaj veščine (priklicane z
@), spomini služijo kot baza znanja, globoko iskanje pa je veščina Deep Research. Načrti se zdaj imenujejo Mistral Free, Pro, Team in Enterprise. Ta lekcija uporablja ime Vibe; nekateri meniji, opisani tukaj, so morda spremenili imena ali lokacije.
Onkraj uradnega imenika
Vgrajeni povezovalniki pokrivajo številne primere uporabe, vendar se tvoja organizacija verjetno zanaša na interna orodja, lastniške API-je ali nišne storitve, ki jih v imeniku Vibe ni. Tu nastopijo prilagojeni povezovalniki: vsak oddaljeni strežnik MCP lahko dodaš v Vibe preprosto tako, da navedeš njegov URL. Tisti interni CRM, zgrajen pred šestimi leti, postane uporaben v pogovoru, prav tako kot GitHub ali Notion.
Postopek dodajanja
Dodajanje povezovalnika zahteva le nekaj klikov v vmesniku. Odpri zavihek Connectors, na dnu seznama klikni Add a custom connector in izpolni zahtevane podatke:
- Name: Opisno ime za identifikacijo povezovalnika (na primer „Internal CRM” ali „Weather API”)
- Server URL: Javni naslov tvojega strežnika MCP, vključno s končno točko
/mcp(na primerhttps://mon-serveur.example.com/mcp) - Description: Kratek opis funkcije povezovalnika (izbirno, a priporočljivo)
- Authentication method: None, Token ali OAuth 2.0
Na koncu klikni Create, da shraniš povezovalnik. Vibe samodejno poizveduje strežnik, da odkrije razpoložljiva orodja: prikaže se seznam izpostavljenih funkcij in začneš jih lahko uporabljati v svojih pogovorih.
Ta zahteva za odkrivanje vrne ime, besedilni opis, pričakovane parametre (z njihovim imenom, tipom in opisom) ter vrsto vračila za vsako orodje. To so edini podatki, ki jih model Mistral uporabi za odločitev, kdaj in kako priklicati vsako orodje – zato se naslednja lekcija močno osredotoča na kakovost opisov. Dobro napisano orodje s slabim opisom ostane modelu nevidno.
Metode avtentikacije
Najpreprostejši primer je odsotnost avtentikacije: tvoj strežnik MCP je dostopen vsakomur, ki pozna njegov URL. To deluje za javna orodja, ki ne obdelujejo občutljivih podatkov, prototipe, demonstracije in strežnike MCP, ki ovijajo javne API-je. Avtentikacija s žetonom vključuje zagotovitev ključa, poslanega z vsako zahtevo strežniku; Vibe žeton varno shrani. Izberi to za interne API-je, zaščitene s ključem API, strežnike, ki morajo identificirati klicatelja, in vsak scenarij, kjer želiš omejiti dostop. Nazadnje, tu je še OAuth 2.0, celoten potek s preusmeritvijo na stran za avtorizacijo storitve: to je najvarnejši mehanizem, a tudi najbolj zapleten za implementacijo na strani strežnika, podrobneje pa bo obravnavan v prihodnjih vodnikih Mistral AI.
Predpogoji za tvoj strežnik MCP
- Dostopen prek **javnega URL-ja** (brez localhost)
- Izpostavlja končno točko v formatu **Streamable HTTP** (
/mcp) - Odziva se na zahteve za **odkrivanje orodij** v standardni obliki JSON MCP
- Pravilno obravnava **klice orodij** in vrača rezultate v pričakovani obliki
Zahteva po javnem URL-ju se morda zdi ovira za lokalni razvoj, vendar obstaja obvod med fazo odpravljanja napak. Če razvijaš na svojem računalniku in želiš testirati z Vibe pred uvedbo, odpri predor do svojega lokalnega strežnika z uporabo ngrok:
ngrok http 8000
ngrok ti dodeli začasni javni URL, ki ga lahko uporabiš kot URL povezovalnika v Vibe. Ta pristop je idealen za razvoj in testiranje: spremeniš kodo, ponovno zaženeš in Vibe takoj vidi novo različico brez kakršne koli uvedbe.
Testiranje z MCP Inspector
Preden dodaš svoj strežnik v Vibe, ga testiraj z MCP Inspector, odprtokodnim orodjem, ki preveri, ali se tvoj strežnik pravilno odziva na zahteve za odkrivanje, našteje razpoložljiva orodja z njihovimi opisi in parametri, ročno izvrši klice orodij za preverjanje rezultatov ter pomaga odpraviti težave z oblikovanjem ali tipkanjem. Zaženi ga s preprostim ukazom npx:
npx @modelcontextprotocol/inspector
Inspector odpre lokalni spletni vmesnik, kjer povežeš svoj strežnik MCP in testiraš vsako orodje posebej. Ta korak ni zgolj formalnost: prihrani ti porabo sporočil v pogovoru za odpravljanje napak in jasno loči napake strežnika od napak interpretacije modela.
Upravljanje v organizaciji
Če si del organizacije v Vibe, upoštevaj, da so prilagojeni povezovalniki, ki jih dodaš, vidni drugim članom. Skrbnik lahko onemogoči kateri koli povezovalnik za celotno organizacijo, če ga oceni kot neustreznega ali negotovega. Vendar pa mora vsak uporabnik za povezovalnike, ki zahtevajo avtentikacijo, zagotoviti svoje poverilnice – žeton ali OAuth: deljenje povezovalnika nikoli ne pomeni deljenja poverilnic za dostop.
Varnost prilagojenih povezovalnikov
Za razliko od uradnih povezovalnikov, ki jih validira Mistral AI, lahko prilagojeni povezovalnik na strani strežnika izvaja poljubno kodo, besedilni opis, ki ga vidiš, pa ne zagotavlja ničesar o tem, kaj strežnik dejansko počne. Drži se strežnikov, ki si jih razvil sam, tistih od zaupanja vrednih sodelavcev ali partnerjev, in odprtokodnih strežnikov, katerih kodo si preveril. Tudi pri lastnih povezovalnikih med fazo odpravljanja napak ohrani človeško validacijo vklopljeno; ko si prepričan, da vse deluje, lahko razmisliš o nastavitvi orodij samo za branje na „Always Allow”.
Ključne ugotovitve
- Vsak oddaljeni strežnik MCP lahko dodaš kot prilagojeni povezovalnik v Vibe
- Strežnik mora biti dostopen prek javnega URL-ja s končno točko
/mcp - Podprte so tri metode avtentikacije: none, token in OAuth 2.0
- Za testiranje lokalnega strežnika z Vibe pred uvedbo uporabi ngrok
- MCP Inspector je bistven za odpravljanje napak na tvojem strežniku pred integracijo
- Dodajaj le povezovalnike iz zaupanja vrednih virov in ohrani človeško validacijo vklopljeno