Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Egyéni MCP-csatlakozó hozzáadása

11. lecke 14 közül Frissítve 2026. november 2. Középhaladó
Ezen az oldalon
  1. Túl a hivatalos könyvtáron
  2. A hozzáadás folyamata
  3. Hitelesítési módszerek
  4. Előfeltételek az MCP-szervered számára
  5. Tesztelés az MCP Inspectorral
  6. Szervezeti kezelés
  7. Az egyéni csatlakozók biztonsága
  8. Főbb megállapítások

Frissítve: 2026. november 2. — A Le Chat mostantól Vibe. 2026. május 28-tól a Le Chat új neve Vibe (továbbra is a chat.mistral.ai címen érhető el): egyetlen ügynök munkára és kódolásra, amely megőrzi beszélgetéseidet, beállításaidat és előfizetéseidet. A régi Le Chat élmény továbbra is elérhető a Chat módban; a Work módban az ügynökök készségekké (skills) váltak (a @ jellel hívhatók meg), az emlékek tudásbázisként szolgálnak, a mély keresés pedig a Deep Research készség. A csomagok neve mostantól Mistral Free, Pro, Team és Enterprise. Ez a lecke a Vibe nevet használja; egyes itt leírt menük neve vagy helye megváltozhatott.

Túl a hivatalos könyvtáron

A beépített csatlakozók számos használati esetet lefednek, de szervezeted valószínűleg belső eszközökre, saját API-kra vagy olyan niche szolgáltatásokra támaszkodik, amelyek hiányoznak a Vibe könyvtárából. Itt jönnek képbe az egyéni csatlakozók: bármilyen távoli MCP-szervert hozzáadhatsz a Vibe-hoz egyszerűen az URL címének megadásával. Az a hat éve készült belső CRM rendszered ugyanúgy használhatóvá válik egy beszélgetés során, mint a GitHub vagy a Notion.

A hozzáadás folyamata

Egy csatlakozó hozzáadása csak néhány kattintást vesz igénybe a felületen. Nyisd meg a Connectors (Csatlakozók) fület, kattints a lista alján található Add a custom connector (Egyéni csatlakozó hozzáadása) gombra, és töltsd ki a szükséges adatokat:

  • Name (Név): Leíró név a csatlakozó azonosításához (például: „Belső CRM“ vagy „Időjárás API“)
  • Server URL (Szerver URL): Az MCP-szervered nyilvános címe, beleértve a /mcp végpontot is (például: https://mon-serveur.example.com/mcp)
  • Description (Leírás): Rövid magyarázat arról, mit csinál a csatlakozó (opcionális, de ajánlott)
  • Authentication method (Hitelesítési módszer): None (Nincs), Token vagy OAuth 2.0

Végül kattints a Create (Létrehozás) gombra a csatlakozó mentéséhez. A Vibe automatikusan lekérdezi a szervert a rendelkezésre álló eszközök felfedezéséhez: megjelenik a feltárt függvények listája, és máris kezdheted használni őket a beszélgetéseidben.

Ez a felderítő kérés visszaadja az egyes eszközök nevét, szöveges leírását, a várt paramétereket (névvel, típussal és leírással), valamint a visszatérési típust. Csak ezeket az adatokat használja fel a Mistral modell annak eldöntésére, mikor és hogyan hívjon meg egy-egy eszközt – ezért fókuszál a következő lecke olyan erősen a leírások minőségére. Egy jól megírt eszköz rossz leírással láthatatlan marad a modell számára.

Hitelesítési módszerek

A legegyszerűbb eset, amikor nincs hitelesítés: az MCP-szervered bárki számára elérhető, aki ismeri az URL címét. Ez működik nyilvános eszközöknél, amelyek nem kezelnek érzékeny adatokat, prototípusoknál, demóknál és nyilvános API-kat burkoló MCP-szervereknél. A tokenes hitelesítés során egy kulcsot adsz meg, amelyet minden kéréssel elküld a szervernek; a Vibe biztonságosan tárolja a tokent. Ezt válaszd belső API-k esetén, amelyeket API-kulcs véd, olyan szervereknél, amelyeknek azonosítaniuk kell a hívót, és minden olyan esetben, amikor korlátozni szeretnéd a hozzáférést. Végül ott van az OAuth 2.0, a teljes folyamat a szolgáltatás engedélyezési oldalára történő átirányítással: ez a legbiztonságosabb mechanizmus, de szerveroldalon a legbonyolultabb is megvalósítani; ezt a jövőbeli Mistral AI útmutatók részletesen tárgyalják majd.

Előfeltételek az MCP-szervered számára

Amit a Vibe elvár egy MCP-szervertől
  • Elérhető legyen egy nyilvános URL-en keresztül (nem localhost)
  • Kitégyen egy végpontot Streamable HTTP formátumban (/mcp)
  • Válaszoljon a szabványos MCP JSON formátumú eszköz-felderítési kérésekre
  • Helyesen kezelje az eszközhívásokat, és a várt formátumban adja vissza az eredményeket

A nyilvános URL követelménye elsőre akadályozhatja a helyi fejlesztést, de van egy megoldás a hibakeresési fázisra. Ha a saját gépeden fejlesztesz, és telepítés előtt szeretnéd tesztelni a Vibe-bal, nyiss egy alagutat a helyi szerveredhez az ngrok használatával:

ngrok http 8000

Az ngrok egy ideiglenes nyilvános URL-t biztosít, amelyet csatlakozói URL-ként használhatsz a Vibe-ban. Ez a megközelítés ideális fejlesztéshez és teszteléshez: módosítod a kódodat, újraindítod a szervert, és a Vibe azonnal látja az új verziót bármilyen telepítés nélkül.

Tesztelés az MCP Inspectorral

Mielőtt hozzáadnád a szerveredet a Vibe-hoz, teszteld le az MCP Inspector segítségével. Ez egy nyílt forráskódú eszköz, amely ellenőrzi, hogy a szervered helyesen válaszol-e a felderítési kérésekre, felsorolja-e a rendelkezésre álló eszközöket leírásaikkal és paramétereikkel, manuálisan végrehajtja az eszközhívásokat az eredmények ellenőrzésére, valamint segít a formázási vagy típusbeli hibák feltárásában. Indítsd el egy egyszerű npx paranccsal:

npx @modelcontextprotocol/inspector

Az Inspector egy helyi webes felületet nyit meg, ahol csatlakoztathatod az MCP-szerveredet, és egyesével tesztelheted az egyes eszközöket. Ez a lépés nem csupán formalitás: megkímél attól, hogy beszélgetési üzeneteket pazarolj hibakeresésre, és egyértelműen elkülöníti a szerverhibákat a modellértelmezési hibáktól.

Szervezeti kezelés

Ha része vagy egy szervezetnek a Vibe-on, vedd figyelembe, hogy a hozzáadott egyéni csatlakozók láthatók lesznek más tagok számára is. Egy rendszergazda letilthat bármilyen csatlakozót az egész szervezet számára, ha azt nem megfelelőnek vagy nem biztonságosnak ítéli. Ugyanakkor minden felhasználónak meg kell adnia a saját hitelesítő adatait – tokent vagy OAuth-t – a hitelesítést igénylő csatlakozókhoz: egy csatlakozó megosztása soha nem jelenti a hozzáférési adatok megosztását.

Az egyéni csatlakozók biztonsága

Ellentétben a Mistral AI által validált hivatalos csatlakozókkal, egy egyéni csatlakozó tetszőleges kódot futtathat szerveroldalon, és a látott szöveges leírás semmit sem garantál arról, amit a szerver valójában csinál. Csak olyan szervereket használj, amelyeket te magad fejlesztettél, megbízható kollégáktól vagy partnerektől származnak, illetve olyan nyílt forráskódú szervereket, amelyek kódját ellenőrizted. Még a saját csatlakozóid esetén is tartsd bekapcsolva az emberi jóváhagyást a teljes hibakeresési fázis alatt; ha már biztos vagy abban, hogy minden működik, akkor fontolóra veheted, hogy az csak olvasási eszközöket „Mindig engedélyezve“ (Always Allow) állapotra állítod.

Főbb megállapítások

  • Bármilyen távoli MCP-szervert hozzáadhatsz egyéni csatlakozóként a Vibe-hoz
  • A szervernek elérhetőnek kell lennie egy nyilvános URL-en keresztül, /mcp végponttal
  • Három hitelesítési módszer támogatott: nincs, token és OAuth 2.0
  • Használd az ngrok-ot a helyi szervered Vibe-bal történő teszteléséhez telepítés előtt
  • Az MCP Inspector elengedhetetlen a szervered hibakereséséhez az integráció előtt
  • Csak megbízható forrásból származó csatlakozókat adj hozzá, és tartsd bekapcsolva az emberi jóváhagyást