Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Pridėti tinkintą MCP jungtį

Paskaita 11 iš 14 Atnaujinta 2026 m. lapkričio 2 d. Vidutinis lygis
Šiame puslapyje
  1. Už oficialaus katalogo ribų
  2. Pridėjimo procesas
  3. Autentifikavimo būdai
  4. Jūsų MCP serverio reikalavimai
  5. Testavimas naudojant „MCP Inspector“
  6. Organizacinis valdymas
  7. Tinkintų jungčių saugumas
  8. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 2 d. – „Le Chat“ dabar vadinasi „Vibe“. Nuo 2026 m. gegužės 28 d. „Le Chat“ buvo pervadintas į „Vibe“ (vis tiek adresu chat.mistral.ai): tai vienas agentas darbui ir kodui, perkeliantis jūsų pokalbius, nustatymus ir prenumeratas. Senoji „Le Chat“ patirtis vis dar pasiekiama režimu „Chat“; režimu „Work“ agentai dabar yra įgūdžiai (kviečiami naudojant @), atmintys veikia kaip žinių bazė, o išsami paieška yra įgūdis „Deep Research“. Planai dabar vadinami „Mistral Free“, „Pro“, „Team“ ir „Enterprise“. Šioje pamokoje naudojamas pavadinimas „Vibe“; kai kurių čia aprašytų meniu pavadinimai arba vietos galėjo pasikeisti.

Už oficialaus katalogo ribų

Integruotos jungtys apima daugelį naudojimo atvejų, tačiau jūsų organizacija tikriausiai remiasi vidiniais įrankiais, nuosavomis API arba nišinėmis paslaugomis, kurių nėra „Vibe“ kataloge. Čia į pagalbą ateina tinkintos jungtys: bet kurį nuotolinį MCP serverį galite pridėti prie „Vibe“ tiesiog nurodydami jo URL. Tas prieš šešerius metus sukurtas vidinis CRM tampa naudojamas pokalbyje taip pat lengvai kaip „GitHub“ arba „Notion“.

Pridėjimo procesas

Jungties pridėjimas sąsajoje trunka vos kelis spustelėjimus. Atidarykite skirtuką „Connectors“ (Jungtys), sąrašo apačioje spustelėkite „Add a custom connector“ (Pridėti tinkintą jungtį) ir užpildykite reikiamą informaciją:

  • Name (Pavadinimas): Aprašomasis pavadinimas jungčiai identifikuoti (pavyzdžiui, „Internal CRM“ arba „Weather API“)
  • Server URL (Serverio URL): Viešasis jūsų MCP serverio adresas, įskaitant galūnę /mcp (pavyzdžiui, https://mon-serveur.example.com/mcp)
  • Description (Aprašymas): Trumpas paaiškinimas, ką jungtis daro (nebūtina, bet rekomenduojama)
  • Authentication method (Autentifikavimo būdas): None (Nėra), Token (Prieigos raktas) arba OAuth 2.0

Galiausiai spustelėkite „Create“ (Sukurti), kad išsaugotumėte jungtį. „Vibe“ automatiškai užklausia serverį, kad aptiktų galimus įrankius: atsiranda atskleistų funkcijų sąrašas ir galite pradėti jas naudoti savo pokalbiuose.

Šis aptikimo užklausos atsakas grąžina kiekvieno įrankio pavadinimą, tekstinį aprašymą, tikėtinus parametrus (su jų pavadinimu, tipu ir aprašymu) bei grąžinamą tipą. Tai vieninteliai duomenys, kuriuos „Mistral“ modelis naudoja spręsdamas, kada ir kaip iškviesti kiekvieną įrankį – būtent todėl kita pamoka daug dėmesio skiria aprašymų kokybei. Gerai parašytas įrankis su prastu aprašymu modeliui lieka nematomas.

Autentifikavimo būdai

Paprastiausias atvejis – autentifikavimo nėra: jūsų MCP serveris pasiekiamas bet kam, kas žino jo URL. Tai tinka viešiems įrankiams, kurie neapdoroja jautrių duomenų, prototipams, demonstracinėms versijoms ir MCP serveriams, apgaubiantiems viešas API. Autentifikavimas prieigos raktu (Token) reiškia, kad pateikiate raktą, siunčiamą su kiekviena užklausa serveriui; „Vibe“ saugiai saugo šį raktą. Rinkitės šį būdą vidinėms API, saugomoms API rakto, serveriams, kuriems reikia identifikuoti kvietėją, ir bet kuriam scenarijui, kai norite apriboti prieigą. Galiausiai egzistuoja OAuth 2.0 – visas srautas su nukreipimu į paslaugos autorizacijos puslapį: tai saugiausias mechanizmas, tačiau ir sudėtingiausias įgyvendinti serverio pusėje; jis bus išsamiai nagrinėjamas būsimuose „Mistral AI“ vadovuose.

Jūsų MCP serverio reikalavimai

Ko „Vibe“ reikalauja iš MCP serverio
  • Prieinamas per **viešą URL** (ne localhost)
  • Pateikia galutinį tašką formatu **„Streamable HTTP“** (/mcp)
  • Atsako į **įrankių aptikimo** užklausas standartiniu MCP JSON formatu
  • Tinkamai apdoroja **įrankių kvietimus** ir grąžina rezultatus numatytu formatu

Reikalavimas naudoti viešą URL gali atrodyti kaip kliūtis vietinei plėtrai, tačiau derinimo etape yra apėjimo būdas. Jei kuriate savo kompiuteryje ir norite testuoti su „Vibe“ prieš diegdami, atidarykite tunelį į savo vietinį serverį naudodami ngrok:

ngrok http 8000

„ngrok“ suteikia laikiną viešą URL, kurį galite naudoti kaip jungties URL „Vibe“ sistemoje. Šis metodas idealiai tinka kūrimui ir testavimui: modifikuojate kodą, paleidžiate iš naujo ir „Vibe“ iškart mato naują versiją be jokio diegimo.

Testavimas naudojant „MCP Inspector“

Prieš pridėdami serverį prie „Vibe“, ištestuokite jį naudodami „MCP Inspector“ – atviro kodo įrankį, kuris patikrina, ar jūsų serveris tinkamai atsako į aptikimo užklausas, išvardija galimus įrankius su jų aprašymais ir parametrais, rankiniu būdu vykdo įrankių kvietimus rezultatams patikrinti ir padeda derinti formatavimo arba tipų klaidas. Paleiskite jį paprasta npx komanda:

npx @modelcontextprotocol/inspector

„Inspector“ atidaro vietinę žiniatinklio sąsają, kurioje prisijungiate prie savo MCP serverio ir testuojate kiekvieną įrankį atskirai. Šis žingsnis nėra vien formalumas: jis sutaupo pokalbių žinučių derinimui ir aiškiai atskiria serverio klaidas nuo modelio interpretavimo klaidų.

Organizacinis valdymas

Jei esate „Vibe“ organizacijos narys, atkreipkite dėmesį, kad jūsų pridėtos tinkintos jungtys matomos kitiems nariams. Administratorius gali išjungti bet kurią jungtį visai organizacijai, jei mano, kad ji netinkama arba nesaugi. Tačiau kiekvienas vartotojas turi pateikti savo prisijungimo duomenis – prieigos raktą arba OAuth – jungtims, kurioms reikia autentifikavimo: dalinimasis jungtimi niekada nereiškia dalinimosi prieigos duomenimis.

Tinkintų jungčių saugumas

Skirtingai nei oficialios jungtys, patvirtintos „Mistral AI“, tinkinta jungtis serverio pusėje gali vykdyti savavališką kodą, o matomas tekstinis aprašymas negarantuoja, ką serveris iš tikrųjų daro. Naudokite tik serverius, kuriuos sukūrėte patys, gautus iš patikimų kolegų ar partnerių, arba atviro kodo serverius, kurių kodą patikrinote. Net ir naudodami savo jungtis, derinimo etape palikite įjungtą žmogaus patvirtinimą; kai būsite tikri, kad viskas veikia sklandžiai, galite svarstyti galimybę nustatyti tik skaitymo įrankius kaip „Always Allow“ (Visada leisti).

Svarbiausi punktai

  • Bet kurį nuotolinį MCP serverį galite pridėti kaip tinkintą jungtį „Vibe“ sistemoje
  • Serveris turi būti pasiekiamas per viešą URL su galutine dalimi /mcp
  • Palaikomi trys autentifikavimo būdai: nėra, prireigos raktas ir OAuth 2.0
  • Prieš diegdami naudokite ngrok, kad ištestuotumėte vietinį serverį su „Vibe“
  • MCP Inspector yra būtinas norint derinti serverį prieš integruojant
  • Pridėkite jungtis tik iš patikimų šaltinių ir palikite įjungtą žmogaus patvirtinimą