Opis in dovoljena orodja
Na tej strani
Dva opcijska vzvoda, dva zelo različna učinka
URL in oznaka zadostujeta za vzpostavitev povezave, vendar Groku ne povesta, kako naj strežnik uporablja. To vrzel zapolnita dva opcijska parametra, ki se medsebojno dopolnjujeta: server_description pojasni namen strežnika, allowed_tools (ali allowed_tool_names, odvisno od SDK-ja) pa določi, do česa sme dostopati. Prvi usmerja, drugi omejuje.
server_description: modelu zagotovi kontekst
Ta parameter modelu Grok zagotavlja opis zmogljivosti strežnika v naravnem jeziku. Model ga uporabi za odločitev: naj poizveduje pri tem strežniku, pri drugem ali sploh pri nobenem?
mcp(
server_url="https://api.example.com/mcp",
server_label="docs",
server_description="Strežnik za tehnično dokumentacijo. Omogoča iskanje člankov, pregled vodnikov in pridobivanje primerov kode za interni API."
)
Brez tega opisa ima Grok na voljo le posamezna imena in opise izpostavljenih orodij. Deluje, a model razmišlja brez širše slike: vidi zbirko orodij, ne ve pa, kaj tvorijo skupaj. Dober opis mu poda tri stvari, ki jih ime orodja ne more prenesti: kdaj je ta strežnik primernejši od drugega, kakšne vrste zahteve naj preusmeri tja in – kar pogosto spregledamo, a je odločilno – česa strežnik ne počne, s čimer se izognemo klicem, obsojenim na neuspeh.
Opis napiši tako, kot bi storil, ko bi storitev razlagal kolegu, ki se pridružuje projektu. Bodite specifični: „Baza tehnične dokumentacije izdelkov” je uporabno, kjer „Dokumentacija” ni. Naštej dejansko mogoča dejanja, na primer „omogoča iskanje, branje in posodabljanje kartic”. Če je obseg omejen, to jasno navedi: „dostop samo za branje, brez sprememb” bo modelu prihranilo neuspešen poskus.
allowed_tools: zoži obseg
Privzeto povezava Groka s strežnikom MCP v kontekst modela injicira vsa orodja, ki jih ta strežnik izpostavlja, brez izjem. Pri sistemu CRM to pomeni, da so ustvarjanje, spreminjanje in brisanje stikov dostopni prav tako kot iskanje.
mcp(server_url="https://api.example.com/mcp",
server_label="crm")
# Grok vidi VSA orodja: create_contact, update_contact,
# delete_contact, search_contacts, export_data itd.
Parameter allowed_tool_names to vedenje obrne z vzpostavitvijo izrecnega belega seznama. Vse, kar ni na njem, postane za model nevidno.
mcp(server_url="https://api.example.com/mcp",
server_label="crm",
allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok vidi le search_contacts in get_contact_details
Zakaj omejevati, tudi ko vse deluje
Prvi razlog je varnost in sledi načelu najmanjših privilegijev. Če tvoja aplikacija potrebuje le branje, ne puščaj orodij za spreminjanje ali brisanje v dosegu modela. Uspešna vbrizgana zahteva (prompt injection) – zlonamerni ukaz, skrit v dokumentu, ki ga Grok analizira – ne more sprožiti delete_contact, ki nikoli ni bil izpostavljen. Beli seznam morebitni incident spremeni v nepomemben dogodek.
# Samo za branje za javnega klepetalnega bota
allowed_tool_names=["search_database", "get_record", "format_data"]
Drugi razlog je zmogljivost. Vsako izpostavljeno orodje zavzame prostor v oknu konteksta, saj morajo vanj spadati njegovo ime, opis in shema parametrov. Strežnik MCP, ki objavi petdeset orodij, porabi precejšen volumen, še preden uporabnik zastavi vprašanje. Z zmanjšanjem na pet resnično uporabnih orodij ta prostor osvobodiš za tisto, kar je pomembno: sam pogovor.
Tretji razlog je natančnost. Bolj obsežen je katalog, bolj model okleva med podobnimi orodji – dve orodji s podobnima opisoma povzročita nestabilne izbire od ene izvedbe do druge. Katalog, zožen na tvoj primer uporabe, naredi izbiro bistveno zanesljivejšo.
Uskladi delovanje obeh
Rezultat postane res čist, ko združiš oba parametra, pod pogojem, da pripovedujeta isto zgodbo.
mcp(
server_url="https://api.example.com/mcp",
server_label="crm",
server_description="CRM samo za branje. Iskanje in ogled stikov ter podjetij.",
allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)
Tukaj opis napoveduje dostop samo za branje, beli seznam pa to tehnično zagotavlja. Previden bodi pri nasprotnem primeru, ki se zgodi pogosteje, kot misliš: opis, podedovan iz prejšnje različice, ki obljublja možnosti zapisovanja, zdaj pa so odstranjene iz belega seznama. Model bo poskusil klic, ta bo spodletel, ti pa boš porabil čas za iskanje napake, ki ne obstaja. Ta dva parametra vedno pregledaj skupaj, nikoli ločeno.
Ključne ugotovitve
server_descriptionpomaga Groku razumeti, kdaj uporabiti ta strežnik MCP- Brez
allowed_toolsso vsa orodja strežnika injicirana v kontekst - Omejitev orodij krepi varnost, zmogljivost in natančnost
- Združi opis in omejitev za optimalen nadzor
- Opis napiši kot razlago zmogljivosti strežnika v naravnem jeziku