Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

server_url en server_label

Les 4 van 12 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. De twee parameters zonder welke u niet kunt
  2. server_url: Het exacte eindpuntadres
  3. server_label: De identiteit van de server in het gesprek
  4. Minimale configuratie in beide SDK’s
  5. Belangrijkste punten

Bijgewerkt op 3 november 2026 op basis van de pagina Remote MCP Tools van xAI: server_label voegt een voorvoegsel toe aan tool-aanroepen, maar de documentatie specificeert niet het exacte formaat van dit voorvoegsel; de notatie label__tool die in deze cursus wordt gebruikt, is een leesconventie—verifieer het feitelijke formaat in uw API-responses. Bron: Remote MCP Tools.

De twee parameters zonder welke u niet kunt

Elke verbinding tussen Grok en een externe MCP-server rust op twee parameters: server_url en server_label. Ze zijn niet onderhandelbaar—zonder deze parameters wijst de API het verzoek af voordat er ook maar iets wordt geprobeerd. Alle andere parameters die u later tegenkomt, verfijnen deze basis; ze vervangen deze nooit.

server_url
Waar de server zich bevindt
server_label
Hoe de server te identificeren

server_url: Het exacte eindpuntadres

De parameter server_url bevat de volledige URL van de MCP-server waarmee Grok verbinding moet maken, en deze URL volgt strikte regels.

De eerste regel is HTTPS. De URL moet beginnen met https://; xAI wijst elke niet-versleutelde HTTP-verbinding af. De reden is eenvoudig: uitwisselingen tussen Grok en de MCP-server dragen verzoeken van uw gebruikers, tool-resultaten en soms zelfs het authenticatietoken zelf. Dit in platte tekst laten circuleren zou onverdedigbaar zijn.

# Correct
mcp(server_url="https://mcp.deepwiki.com/mcp")

# Geweigerd door de API
mcp(server_url="http://mcp.deepwiki.com/mcp")

De tweede regel betreft de precisie van het pad. De URL moet wijzen naar het MCP-eindpunt, niet naar de root van het domein. Bijna alle servers stellen hun eindpunt bloot via een toegewijd pad, en de conventie verschilt per server. Hier zijn drie geldige vormen die u zult tegenkomen:

https://mcp.deepwiki.com/mcp
https://api.example.com/mcp
https://tools.monentreprise.com/v1/mcp

De derde regel volgt uit de eerste twee: localhost en privé-IP-adressen zijn uitgesloten. De server moet bereikbaar zijn vanaf de infrastructuur van xAI, op een publiek domein, met een geldig SSL-certificaat. Dit roept tijdens de ontwikkeling een concrete vraag op, aangezien de MCP-server die u schrijft op uw eigen machine draait. De gebruikelijke oplossing is het gebruik van een tunnel—bijvoorbeeld ngrok of Cloudflare Tunnel—die uw lokale instantie tijdelijk blootstelt achter een publieke HTTPS-URL voor de duur van uw tests.

server_label: De identiteit van de server in het gesprek

De server_label is een korte identifier die Grok gebruikt om tool-aanroepen van deze server te voorzien van een voorvoegsel. De rol is tweeledig: traces leesbaar maken en elke ambiguïteit wegnemen wanneer meerdere servers naast elkaar bestaan.

De documentatie van xAI stelt dat het label tool-aanroepen van deze server voorziet van een voorvoegsel, zonder het exacte formaat van dit voorvoegsel te specificeren. In deze cursus noteren we een search_docs-tool van de deepwiki-server als deepwiki__search_docs, voor de leesbaarheid: verifieer het feitelijke formaat in API-responses voordat u hier logica op bouwt.

mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)
# Tool-aanroepen van deze server worden voorafgegaan door "deepwiki"

Drie criteria leiden de keuze van een goed label. Het moet kort zijn, omdat het aan de naam van elke aanroep wordt toegevoegd en een uitgebreid label uw logs onnodig opblaast. Het moet beschrijvend zijn, zodat de bron van een aanroep in één oogopslag leesbaar is zonder de configuratie te raadplegen. Het moet uniek zijn binnen uw configuratie, anders kunt u geen onderscheid maken tussen twee servers. De onderstaande voorbeelden voldoen aan deze drie vereisten:

server_label="deepwiki"     # GitHub-documentatie
server_label="crm"          # Klantbeheersysteem
server_label="jira"         # Tickettracking
server_label="search"       # Interne zoekmachine

Dit wordt veel tastbaarder zodra u meerdere servers verbindt met dezelfde sessie. Stel dat uw interne documentatie en DeepWiki beide een tool genaamd search blootstellen. Zonder distincte labels botsen de tool-namen en heeft Grok geen manier om te weten welke hij moet targeten. Met labels krijgen de twee tools een verschillend voorvoegsel—hier genoteerd als deepwiki__search en internal-docs__search—en verdwijnt de verwarring. U komt hierop terug in de les die gewijd is aan meerdere servers.

Minimale configuratie in beide SDK’s

Samen zijn deze twee parameters voldoende om een publieke MCP-server werkend te krijgen. Met de native xAI SDK:

from xai_sdk.tools import mcp

tools = [
    mcp(
        server_url="https://mcp.deepwiki.com/mcp",
        server_label="deepwiki"
    )
]

En het exacte equivalent met de Responses API in OpenAI-formaat:

tools = [{
    "type": "mcp",
    "server_url": "https://mcp.deepwiki.com/mcp",
    "server_label": "deepwiki",
}]

Belangrijkste punten

  • server_url en server_label zijn de enige twee verplichte parameters
  • De URL moet HTTPS zijn met een geldig SSL-certificaat; geen localhost
  • Het label voorziet alle tool-aanroepen van deze server van een voorvoegsel (het exacte formaat is niet gedocumenteerd; deze cursus noteert het als label__tool)
  • Kies labels die kort, beschrijvend en uniek zijn per server
  • Het label is essentieel bij gebruik van meerdere servers om naamconflicten te voorkomen