Leírás és engedélyezett eszközök
Ezen az oldalon
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_descriptionsegít a Groknak megérteni, mikor használja ezt az MCP szervert allowed_toolsné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