Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Beschrijving en toegestane tools

Les 5 van 12 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Twee optionele hefbomen, twee zeer verschillende effecten
  2. server_description: geef context aan het model
  3. allowed_tools: beperk het bereik
  4. Waarom beperken, zelfs als alles werkt
  5. Laat de twee samenwerken
  6. Belangrijkste punten

Twee optionele hefbomen, twee zeer verschillende effecten

De URL en het label volstaan om de verbinding tot stand te brengen, maar ze vertellen Grok niet hoe de server gebruikt moet worden. Twee optionele parameters vullen deze leemte aan en vullen elkaar aan: server_description legt uit waar de server voor dient, terwijl allowed_tools—of allowed_tool_names afhankelijk van de SDK—bepaalt wat de server mag aanraken. De eerste stuurt, de tweede beperkt.

server_description: geef context aan het model

Deze parameter voorziet Grok van een beschrijving in natuurlijke taal van de mogelijkheden van de server. Het model gebruikt deze informatie om een afweging te maken: moet het deze server raadplegen, een andere, of helemaal geen?

mcp(
    server_url="https://api.example.com/mcp",
    server_label="docs",
    server_description="Technische documentatieserver. Hiermee kunt u artikelen doorzoeken, handleidingen raadplegen en codevoorbeelden voor de interne API opvragen."
)

Zonder deze beschrijving heeft Grok alleen de individuele namen en beschrijvingen van de beschikbare tools. Het werkt, maar het model redeneert zonder het grote geheel: het ziet een verzameling tools zonder te weten wat ze gezamenlijk vormen. Een goede beschrijving geeft het model drie dingen die geen enkele toolnaam kan overbrengen: wanneer deze server relevanter is dan een andere, welk type verzoeken er naartoe gerouteerd moeten worden, en—vaak over het hoofd gezien, maar vaak doorslaggevend—wat de server níét doet, wat oproepen die gedoemd zijn te mislukken voorkomt.

Schrijf deze beschrijving alsof u de dienst uitlegt aan een collega die bij het project komt. Wees specifiek: “Technische documentatiedatabase voor producten” is nuttig, waar “Documentatie” dat niet is. Noem de daadwerkelijk mogelijke acties, zoals “hiermee kunt u tickets doorzoeken, lezen en bijwerken”. En als het bereik beperkt is, vermeld dit dan duidelijk: “alleen-lezen toegang, geen wijzigingen” bespaart het model een mislukte poging.

allowed_tools: beperk het bereik

Standaard injecteert het verbinden van Grok met een MCP-server alle tools die die server beschikbaar stelt in de context van het model, zonder uitzondering. Bij een CRM betekent dit dat het aanmaken, wijzigen en verwijderen van contacten net zo toegankelijk zijn als het zoeken.

mcp(server_url="https://api.example.com/mcp",
    server_label="crm")
# Grok ziet ALLE tools: create_contact, update_contact,
# delete_contact, search_contacts, export_data, enz.

De parameter allowed_tool_names draait dit gedrag om door een expliciete whitelist vast te stellen. Alles wat er niet op staat, wordt onzichtbaar voor het model.

mcp(server_url="https://api.example.com/mcp",
    server_label="crm",
    allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok ziet alleen search_contacts en get_contact_details

Waarom beperken, zelfs als alles werkt

De eerste reden is beveiliging, en dit volgt het principe van de minste bevoegdheid (least privilege). Als uw applicatie alleen hoeft te lezen, laat dan geen tools voor wijziging of verwijdering binnen het bereik van het model. Een succesvolle prompt-injectie—een kwaadaardige instructie die in een document is gesmokkeld dat Grok analyseert—kan geen delete_contact activeren die nooit is blootgesteld. De whitelist maakt van een potentieel incident een non-event.

# Alleen-lezen voor een publieke chatbot
allowed_tool_names=["search_database", "get_record", "format_data"]

De tweede reden is prestatie. Elke blootgestelde tool neemt ruimte in beslag in het contextvenster, omdat de naam, beschrijving en het parameterschema daar in moeten passen. Een MCP-server die vijftig tools publiceert, verbruikt een aanzienlijk volume voordat de gebruiker zelfs maar zijn vraag heeft gesteld. Door terug te schakelen naar vijf echt nuttige tools, wint u die ruimte terug voor wat belangrijk is: het gesprek zelf.

De derde reden is precisie. Hoe uitgebreider de catalogus, hoe meer het model aarzelt tussen vergelijkbare tools—en twee tools met vergelijkbare beschrijvingen leiden tot instabiele keuzes van de ene uitvoering naar de andere. Een catalogus die strak is afgestemd op uw use-case, maakt de selectie aanzienlijk betrouwbaarder.

Laat de twee samenwerken

Het resultaat wordt pas echt schoon wanneer u beide parameters combineert, mits ze hetzelfde verhaal vertellen.

mcp(
    server_url="https://api.example.com/mcp",
    server_label="crm",
    server_description="Alleen-lezen CRM. Zoek en bekijk contacten en bedrijven.",
    allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)

Hier kondigt de beschrijving alleen-lezen toegang aan en garandeert de whitelist dit technisch. Pas op voor de omgekeerde situatie, die vaker voorkomt dan u denkt: een beschrijving die is overgeërfd van een vorige versie en schrijfmogelijkheden belooft die nu uit de whitelist zijn verwijderd. Het model zal de oproep proberen, falen, en u zult tijd besteden aan het opsporen van een bug die niet bestaat. Beoordeel deze twee parameters altijd samen, nooit afzonderlijk.

Belangrijkste punten

  • server_description helpt Grok te begrijpen wanneer deze MCP-server gebruikt moet worden
  • Zonder allowed_tools worden alle server-tools in de context geïnjecteerd
  • Het beperken van tools versterkt de beveiliging, prestaties en precisie
  • Combineer beschrijving en beperking voor optimale controle
  • Schrijf de beschrijving als een uitleg in natuurlijke taal van de mogelijkheden van de server