Beskrivelse og tilladte værktøjer
På denne side
To valgfrie løftestænger, to meget forskellige effekter
URL’en og labelen er nok til at etablere forbindelsen, men de fortæller ikke Grok, hvordan serveren skal bruges. To valgfrie parametre udfylder dette hul og supplerer hinanden: server_description forklarer, hvad serveren er til, mens allowed_tools – eller allowed_tool_names afhængigt af SDK’et – afgør, hvad den har lov til at røre ved. Den første guider, den anden begrænser.
server_description: giv modellen kontekst
Denne parameter giver Grok en beskrivelse i naturligt sprog af serverens funktioner. Modellen bruger den til at træffe beslutninger: Skal den spørge denne server, en anden, eller slet ingen?
mcp(
server_url="https://api.example.com/mcp",
server_label="docs",
server_description="Teknisk dokumentationsserver. Giver dig mulighed for at søge i artikler, konsultere guider og få kodeeksempler til den interne API."
)
Uden denne beskrivelse har Grok kun de individuelle navne og beskrivelser af de eksponerede værktøjer. Det virker, men modellen ræsonnerer uden det store overblik: Den ser en samling værktøjer uden at vide, hvad de tilsammen udgør. En god beskrivelse giver den tre ting, som intet værktøjsnavn kan formidle: hvornår denne server er relevant frem for en anden, hvilken type forespørgsler der skal routings dertil, og – ofte overset, men ofte afgørende – hvad serveren ikke gør, hvilket undgår kald, der er dømt til at fejle.
Skriv denne beskrivelse, som om du forklarede tjenesten til en kollega, der lige er startet på projektet. Vær specifik: „Produktets tekniske dokumentationsdatabase” er nyttigt, hvor „Dokumentation” ikke er det. Navngiv de handlinger, der faktisk er mulige, f.eks. „giver dig mulighed for at søge, læse og opdatere tickets”. Og hvis omfanget er begrænset, så sig det tydeligt: „skrivebeskyttet adgang, ingen ændringer” vil spare modellen for et mislykket forsøg.
allowed_tools: indsnævr omfanget
Som standard injicerer en forbindelse mellem Grok og en MCP-server alle værktøjer, som den server eksponerer, i modellens kontekst uden undtagelse. På et CRM betyder det, at oprettelse, ændring og sletning af kontakter er lige så tilgængelige som søgning.
mcp(server_url="https://api.example.com/mcp",
server_label="crm")
# Grok ser ALLE værktøjer: create_contact, update_contact,
# delete_contact, search_contacts, export_data osv.
Parameteren allowed_tool_names vender denne adfærd ved at etablere en eksplicit whitelist. Alt, der ikke står på den, bliver usynligt for modellen.
mcp(server_url="https://api.example.com/mcp",
server_label="crm",
allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok ser kun search_contacts og get_contact_details
Hvorfor begrænse, selv når alt virker
Den første årsag er sikkerhed, og den følger princippet om mindst privilegium. Hvis din applikation kun behøver at læse, så lad ikke værktøjer til ændring eller sletning være inden for modellens rækkevidde. En vellykket prompt-injection – en ondsindet instruktion smuglet ind i et dokument, som Grok analyserer – kan ikke udløse et delete_contact, der aldrig blev eksponeret. Whitelisten gør en potentiel hændelse til en ikke-hændelse.
# Skrivebeskyttet til en offentlig chatbot
allowed_tool_names=["search_database", "get_record", "format_data"]
Den anden årsag er ydeevne. Hvert eksponeret værktøj optager plads i kontekstvinduet, da dets navn, beskrivelse og parameterskema skal være der. En MCP-server, der publicerer halvtreds værktøjer, bruger et betydeligt volumen, før brugeren overhovedet har stillet sit spørgsmål. Ved at reducere antallet til fem virkelig nyttige værktøjer frigør du den plads til det, der betyder noget: selve samtalen.
Den tredje årsag er præcision. Jo mere omfattende kataloget er, desto mere tøver modellen mellem lignende værktøjer – og to værktøjer med lignende beskrivelser producerer ustabile valg fra den ene kørsel til den næste. Et katalog strammet op omkring dit use case gør udvælgelsen markant mere pålidelig.
Få de to til at arbejde sammen
Resultatet bliver virkelig rent, når du kombinerer begge parametre, forudsat at de fortæller den samme historie.
mcp(
server_url="https://api.example.com/mcp",
server_label="crm",
server_description="Skrivebeskyttet CRM. Søg i og vis kontakter og virksomheder.",
allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)
Her annoncerer beskrivelsen skrivebeskyttet adgang, og whitelisten garanterer det teknisk. Pas på den modsatte situation, som sker oftere, end du tror: En beskrivelse arvet fra en tidligere version, der lover skrivefunktioner, som nu er fjernet fra whitelisten. Modellen vil forsøge kaldet, fejle, og du vil bruge tid på at jagte en fejl, der ikke eksisterer. Gennemgå altid disse to parametre sammen, aldrig hver for sig.
Vigtige pointer
server_descriptionhjælper Grok med at forstå, hvornår denne MCP-server skal bruges- Uden
allowed_toolsinjiceres alle serverens værktøjer i konteksten - Begrænsning af værktøjer styrker sikkerhed, ydeevne og præcision
- Kombiner beskrivelse og begrænsning for optimal kontrol
- Skriv beskrivelsen som en forklaring i naturligt sprog af serverens funktioner