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

Leírás és engedélyezett eszközök

5. lecke 12 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Két opcionális kar, két nagyon eltérő hatás
  2. server_description: kontextus biztosítása a modell számára
  3. allowed_tools: a hatáskör szűkítése
  4. Miért korlátozzunk, ha minden működik?
  5. Működtesd együtt a kettőt
  6. Főbb megállapítások

Két opcionális kar, két nagyon eltérő hatás

Az URL és a címke elegendő a kapcsolat létrehozásához, de nem árulják el a Groknak, hogyan használja a szervert. Két opcionális paraméter tölti be ezt a rést és egészíti ki egymást: a server_description elmagyarázza, mire szolgál a szerver, míg az allowed_tools – vagy az SDK-tól függően az allowed_tool_names – dönti el, mihez nyúlhat hozzá. Az első útmutatást ad, a második korlátoz.

server_description: kontextus biztosítása a modell számára

Ez a paraméter természetes nyelven írt leírást biztosít a Grok számára a szerver képességeiről. A modell ezt használja döntéshozatalra: ezt a szervert kérdezze le, egy másikat, vagy egyiket sem?

mcp(
    server_url="https://api.example.com/mcp",
    server_label="docs",
    server_description="Technikai dokumentációs szerver. Lehetővé teszi cikkek keresését, útmutatók konzultálását és kódpéldák lekérését a belső API-hoz."
)

E leírás nélkül a Grok csak az egyes exponált eszközök neveire és leírásaira támaszkodhat. Működik, de a modell nagy kép nélkül gondolkodik: eszközök gyűjteményét látja anélkül, hogy tudná, mit alkotnak ezek közösen. Egy jó leírás három olyan dolgot ad neki, amit egyetlen eszközneve sem képes közvetíteni: mikor releváns ez a szerver egy másik helyett, milyen típusú kéréseket kell ide irányítani, és – amit gyakran figyelmen kívül hagynak, pedig döntő fontosságú – mit nem csinál a szerver, ami megelőzi a kudarcra ítélt hívásokat.

Úgy írd meg ezt a leírást, mintha egy most csatlakozó kollégának magyaráznád el a szolgáltatást. Légy konkrét: a „Termék technikai dokumentációs adatbázisa“ hasznos, míg a „Dokumentáció“ nem. Nevezd meg a ténylegesen lehetséges műveleteket, például: „lehetővé teszi jegyek keresését, olvasását és frissítését“. Ha a hatáskör korlátozott, állítsd ezt egyértelműen: a „csak olvasható hozzáférés, nincs módosítás“ megkíméli a modellt egy sikertelen próbálkozástól.

allowed_tools: a hatáskör szűkítése

Alapértelmezés szerint a Grok egy MCP szerverhez való csatlakoztatása minden, a szerver által exponált eszközt a modell kontextusába injektál, kivétel nélkül. Egy CRM rendszer esetén ez azt jelenti, hogy a kapcsolattartók létrehozása, módosítása és törlése ugyanúgy elérhető, mint a keresés.

mcp(server_url="https://api.example.com/mcp",
    server_label="crm")
# A Grok MINDEN eszközt lát: create_contact, update_contact,
# delete_contact, search_contacts, export_data, stb.

Az allowed_tool_names paraméter megfordítja ezt a viselkedést egy explicit fehérlista létrehozásával. Ami nincs rajta, az láthatatlanná válik a modell számára.

mcp(server_url="https://api.example.com/mcp",
    server_label="crm",
    allowed_tool_names=["search_contacts", "get_contact_details"])
# A Grok csak a search_contacts és get_contact_details eszközöket látja

Miért korlátozzunk, ha minden működik?

Az első ok a biztonság, és ez a legkisebb jogosultság elvét követi. Ha az alkalmazásodnak csak olvasásra van szüksége, ne hagyd, hogy a módosító vagy törlő eszközök a modell hatókörébe essenek. Egy sikeres prompt injection – egy rosszindulatú utasítás, amelyet egy Grok által elemzett dokumentumba csempésztek – nem tud kiváltani egy delete_contact hívást, amelyet sosem tettek elérhetővé. A fehérlista egy potenciális incidensből nem-eseményt csinál.

# Csak olvasható egy nyilvános chatbot számára
allowed_tool_names=["search_database", "get_record", "format_data"]

A második ok a teljesítmény. Minden exponált eszköz helyet foglal el a kontextusablakban, mivel a nevét, leírását és paramétersémáját el kell helyezni ott. Egy ötven eszközt közzétevő MCP szerver jelentős mennyiséget fogyaszt el, mielőtt a felhasználó feltette volna a kérdését. Ha öt valóban hasznos eszközre csökkented a listát, visszanyered ezt a helyet arra, ami számít: magára a beszélgetésre.

A harmadik ok a pontosság. Minél bővebb a katalógus, annál inkább habozik a modell a hasonló eszközök között – és két hasonló leírású eszköz instabil választásokat eredményez egyik végrehajtásról a másikra. A használati esetedre szabott, szűkített katalógus jelentősen megbízhatóbbá teszi a kiválasztást.

Működtesd együtt a kettőt

Az eredmény akkor válik igazán tisztává, ha mindkét paramétert kombinálod, feltéve, hogy ugyanazt a történetet mesélik el.

mcp(
    server_url="https://api.example.com/mcp",
    server_label="crm",
    server_description="Csak olvasható CRM. Kapcsolattartók és vállalatok keresése és megtekintése.",
    allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)

Itt a leírás bejelenti a csak olvasható hozzáférést, a fehérlista pedig technikailag garantálja azt. Óvakodj az ellenkező helyzettől, ami gyakoribb, mint gondolnád: egy előző verzióból örökölt leírás, amely írási képességeket ígér, amelyeket már eltávolítottak a fehérlistáról. A modell megkísérli a hívást, az meghiúsul, te pedig időt töltesz egy nem létező hiba vadászatával. Mindig egyszerre vizsgáld felül ezt a két paramétert, soha ne külön-külön.

Főbb megállapítások

  • A server_description segít a Groknak megérteni, mikor használja ezt az MCP szervert
  • allowed_tools nélkül a szerver összes eszköze injektálódik a kontextusba
  • Az eszközök korlátozása erősíti a biztonságot, a teljesítményt és a pontosságot
  • Kombináld a leírást és a korlátozást az optimális kontroll érdekében
  • A leírást a szerver képességeinek természetes nyelvű magyarázataként írd meg