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

Egyéni szerver integrálása a Vibe-ba

13. lecke 14 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Az MCP szervered csatlakoztatása a Vibe-hoz
  2. A csatlakozó hozzáadása
  3. Mi történik a beszélgetés során?
  4. Amikor nem működik
  5. Az MCP Inspector: Használd a Vibe előtt!
  6. Több szerverrel élni
  7. Főbb megállapítások

Frissítés: 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ához és kódoláshoz, 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ökből készségek (skills) lettek (a @ jellel hívhatók meg), az emlékekből tudásbázis, a mély keresésből pedig a Deep Research készség vált. A csomagok neve mostantól Mistral Free, Pro, Team és Enterprise. Ez a lecke a Vibe nevet használja; vedd figyelembe, hogy az itt leírt egyes menük neve vagy elhelyezkedése megváltozhatott.

Az MCP szervered csatlakoztatása a Vibe-hoz

A szervered üzemel, és HTTPS-en keresztül válaszol egy stabil címen. Most következik az a lépés, amely értelmet ad minden eddigi munkádnak: elérhetővé tenni a beszélgetésekben a célközönséged számára, beleértve azokat is, akik sosem nyitnak meg terminált. A Vibe bármely szabványos MCP szervert elfogad egyéni csatlakozóként (connector). Ez a lecke bemutatja a csatlakozó hozzáadását, végigvezet a beszélgetésbeli hívási folyamatokon, és segít a hibák diagnosztizálásában – mert az első próbálkozás gyakran sikertelen.

A csatlakozó hozzáadása

Nyisd meg a Vibe-ot a chat.mistral.ai oldalon, és navigálj a oldalsávon található Connectors (Csatlakozók) fülhöz. Két különálló szakaszt találsz itt: a Mistral által előre konfigurált kiemelt csatlakozókat (GitHub, Notion és mások), valamint a saját egyéni csatlakozóidat, amelyek kezdetben üresek. Kattints az Add Custom Connector (Egyéni csatlakozó hozzáadása) gombra, és töltsd ki a mezőket:

  1. Name (Név): Egy leíró név (pl. „Feladatkezelő“)
  2. Server URL: Az MCP végpontod teljes URL-címe (pl. https://my-server.com/tasks/mcp)
  3. Description (Leírás): Mit csinál a szervered (opcionális, de ajánlott)

Ezután válaszd ki a hitelesítési módszert: No authentication (Nincs hitelesítés) egy nyilvános szerverhez, Token, ha beilleszted az API-tokenedet, vagy OAuth 2.0 egy teljes jóváhagyási folyamathoz. A Connect (Csatlakozás) gombra kattintva elindul a felderítés: ha sikeres, a Vibe megjeleníti a szervereden található eszközök listáját, bemutatva mindegyik nevét és leírását. Ez az első valódi visszajelzésed a docstringjeid minőségéről – itt pontosan úgy olvasod őket, ahogy a modell megkapja majd.

Mi történik a beszélgetés során?

Csatlakoztatás után a szervered megjelenik a chat oldalsávjának Tools (Eszközök) szakaszában, egy ikonnal jelezve a külső eszközök elérhetőségét. A felhasználó természetes nyelven fogalmazza meg kérését, a modell pedig lefordítja azt:

User: Create a high-priority task to prepare the MCP demo

Vibe: [Calling create_task with the following arguments]
  - title: "Prepare the MCP demo"
  - priority: "high"

  → Do you want to authorize this tool call?

User: [Authorize]

Vibe: The task "Prepare the MCP demo" has been successfully created
with high priority. Its ID is abc123.

Ez a megerősítő prompt az alapértelmezett viselkedés. Jóváhagyhatod eseti jelleggel, vagy véglegesítheted az engedélyezést egy eszközhöz. Állj ellen a kísértésnek, hogy ezt bármely olyan szerverrel megtedd, amely nem a tiéd. A megerősítés nemcsak a hibák ellen véd; ez az egyetlen védelmed a prompt-injekciókkal szemben, amikor egy eszköz által visszaadott adatokba rejtett utasítások a modellt olyan hívásokra terelik, amelyeket senki nem kért. Az argumentumok ellenőrzés előtti végigpörgetése teszi lehetővé, hogy észleld a rendellenességet.

Amikor nem működik

Az „Unable to connect“ (Nem sikerült csatlakozni) üzenet szinte mindig ezen négy ok egyikéből adódik: az URL kívülről nem érhető el, a protokoll nem HTTPS (amit a Vibe megkövetel), a szerver egyszerűen nem fut, vagy a CORS nincs konfigurálva, annak ellenére, hogy a Vibe böngészőből küld kéréseket. Az alábbi parancs másodpercek alatt különválasztja az első két hipotézist:

# Test accessibility
curl -X POST https://your-url/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

Ha a kapcsolat létrejön, de nem jelennek meg eszközök, kövesd vissza a láncolatot a szerver oldalán: ellenőrizd, hogy az @app.tool() dekorátor jelen van-e minden függvénynél, hogy nem hiányoznak-e a docstringek, és hogy az MCP szerver arra az útvonalra van-e csatlakoztatva, amelyre gondolod. Bármely egyéb vizsgálat előtt használd az MCP Inspectort.

A legzavaróbb eset az, amikor minden működik, de a modell rossz eszközt hív meg, vagy egyet sem. Ilyenkor a probléma nem technikai: a modell a leírások alapján választ, és ha két eszköz hasonlónak tűnik, vagy ha az egyik homályos marad, rossz döntést hoz. Használd a következő három kart, ebben a sorrendben: tedd specifikusabbá a leírást a használati eset tisztázásával, nevezd át az eszközt a kétértelműség megszüntetésére, és csökkentsd az egyszerre aktív eszközök számát. Végül, ha egy eszköz hibát ad vissza, ellenőrizd a szervernaplókat, játszd le manuálisan a hívást az inspectorban, és győződj meg arról, hogy a környezeti változók be vannak állítva, valamint hogy a token vagy az OAuth hatókörök biztosítják a várt engedélyeket.

Az MCP Inspector: Használd a Vibe előtt!

Az inspector teszteli az eszközeidet a modell bevonása nélkül, ezzel a probléma változóinak felét izolálva:

npx @modelcontextprotocol/inspector

Ez megnyit egy webes felületet, ahol csatlakozhatsz a távoli szerveredhez az URL-címén keresztül, listázhatod az összes eszközt a leírásaikkal és paramétereikkel együtt, végrehajthatsz egy eszközt a választott argumentumokkal, és elolvashatod a nyers szerverválaszt. Szoktasd rá magad, hogy rendszeresen elvégezd ezt az ellenőrzést, mielőtt szervert adnál hozzá a Vibe-hoz, mivel ez azonnali diagnózist ad: ha egy eszköz helyesen válaszol az inspectorban, de hibázik a Vibe-ban, akkor a szerver nem a hibás, és a probléma a leírásban vagy a promptban rejlik.

Több szerverrel élni

Miután több csatlakozót is telepítettél, a fegyelem válik a minőség elsődleges tényezőjévé. A Vibe lehetővé teszi az egyes csatlakozók ki- és bekapcsolását: csak a jelenlegi feladathoz szükséges eszközöket tartsd aktívan, mert egy modell, amelyet ötven eszköz borít el, kevésbé pontosan választ és lassabban válaszol. Ez a higiénia a 10. leckében tárgyalt domén-elválasztáson alapul – egy szerver a projektmenedzsmenthez, egy a monitorozáshoz, egy a belső eszközökhöz –, mivel így csak azt kell aktiválnod, amelyik az aktuális beszélgetéshez illik.

Végül igazítsd a promptjaidat a ténylegesen elérhető képességekhez:

# Good: reflects tool capabilities
"Create a high-priority task titled 'Prepare the demo'"

# Bad: too vague, the model doesn't know which tool to use
"Manage my project"

Egy utolsó pont, amit érdemes tudnod a szervereid tervezése előtt: a Vibe-ban konfigurált MCP csatlakozók a mobilalkalmazásban is elérhetők maradnak. Belső eszközeid így telefonról is hozzáférhetővé válnak, olyan terepi használati forgatókönyveket nyitva meg, amelyekre asztali gépen fejlesztve esetleg nem is gondoltál volna.

Főbb megállapítások

  • Egyéni csatlakozó hozzáadása a Vibe-hoz 3 lépésből áll: név, URL, hitelesítés
  • A biztonsági előírások miatt tartsd bekapcsolva az eszköz hívások kézi megerősítését
  • Használd az MCP Inspectort tesztelésre és hibakeresésre, mielőtt integrálnád a Vibe-ba
  • Javítsd az eszközök leírásait, ha a modell nem használja őket helyesen
  • Csak a jelenlegi feladathoz szükséges eszközöket tartsd aktívan
  • Az MCP szervereid mobilon is elérhetők