Spring til hovedindhold
Dansk— Vælg et sprog
Menu

server_url og server_label

Lektion 4 af 12 Opdateret 3. november 2026 Udvikler
På denne side
  1. De to parametre, du ikke kan undvære
  2. server_url: Den nøjagtige endpoint-adresse
  3. server_label: Serverens identitet i samtalen
  4. Minimal konfiguration i begge SDK’er
  5. Vigtige pointer

Opdateret 3. november 2026 baseret på xAI’s side om Remote MCP Tools: server_label fungerer som præfiks for værktøjskald, men dokumentationen specificerer ikke det nøjagtige format for præfikset; notationen label__tool, der bruges i dette kursus, er en læsekonvention – verificér det faktiske format i dine API-svar. Kilde: Remote MCP Tools.

De to parametre, du ikke kan undvære

Hver forbindelse mellem Grok og en fjern MCP-server afhænger af to parametre: server_url og server_label. De er ikke-forhandlingsbare – uden dem afviser API’en anmodningen, før den overhovedet forsøger noget. Alle andre parametre, du støder på senere, forfiner dette fundament; de erstatter det aldrig.

server_url
Hvor serveren befinder sig
server_label
Hvordan serveren identificeres

server_url: Den nøjagtige endpoint-adresse

Parameteren server_url indeholder den fulde URL til den MCP-server, som Grok skal forbinde til, og denne URL følger strenge regler.

Den første regel er HTTPS. URL’en skal starte med https://, og xAI afviser enhver ukrypteret HTTP-forbindelse. Årsagen er ligetil: Udvekslinger mellem Grok og MCP-serveren bærer dine brugeres anmodninger, værktøjsresultater og nogle gange selve autentificeringstokenet. At lade dette cirkulere som klartekst ville være uforsvarligt.

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

# Afvist af API'en
mcp(server_url="http://mcp.deepwiki.com/mcp")

Den anden regel vedrører præcision i stien. URL’en skal pege direkte på MCP-endpointet, ikke på domæneroden. Næsten alle servere eksponerer deres endpoint på en dedikeret sti, og konventionen varierer fra den ene til den anden. Her er tre gyldige former, du vil støde på:

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

Den tredje regel følger af de to første: localhost og private IP-adresser er udelukket. Serveren skal være tilgængelig fra xAI’s infrastruktur på et offentligt domæne med et gyldigt SSL-certifikat. Dette rejser et konkret spørgsmål under udvikling, da den MCP-server, du skriver, kører på din egen maskine. Den sædvanlige løsning er at bruge en tunnel – f.eks. ngrok eller Cloudflare Tunnel – som eksponerer din lokale instans bag en offentlig HTTPS-URL i testperioden.

server_label: Serverens identitet i samtalen

server_label er en kort identifikator, som Grok bruger til at sætte præfiks på værktøjskald fra denne server. Dens rolle er dobbelt: gøre spor læsbare og fjerne enhver tvetydighed, når flere servere eksisterer sideløbende.

xAI’s dokumentation angiver, at label’en fungerer som præfiks for værktøjskald fra denne server, uden at specificere det nøjagtige format for præfikset. I dette kursus betegner vi et search_docs-værktøj fra deepwiki-serveren som deepwiki__search_docs for læsbarhedens skyld: verificér det faktiske format i API-svar, før du bygger logik ovenpå det.

mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)
# Værktøjskald fra denne server vil få præfikset "deepwiki"

Tre kriterier styrer valget af en god label. Den skal være kort, da den føjes til navnet på hvert kald, og en verbose label unødigt oppuster dine logs. Den skal være beskrivende, så kilden til et kald er læsbar ved første øjekast uden at skulle konsultere konfigurationen. Den skal være unik i din konfiguration, ellers kan du ikke skelne mellem to servere. Eksemplerne nedenfor opfylder disse tre krav:

server_label="deepwiki"     # GitHub-dokumentation
server_label="crm"          # Kundestyringssystem
server_label="jira"         # Billetsporing
server_label="search"       # Intern søgemaskine

Dette bliver meget mere håndgribeligt, så snart du forbinder flere servere til den samme session. Antag, at både din interne dokumentation og DeepWiki eksponerer et værktøj kaldet search. Uden distinkte label’er kolliderer værktøjsnavnene, og Grok har ingen måde at vide, hvilken der skal målrettes. Med label’er får de to værktøjer forskellige præfikser – her noteret som deepwiki__search og internal-docs__search – og forvirringen forsvinder. Du vil genoptage dette punkt i lektionen dedikeret til flere servere.

Minimal konfiguration i begge SDK’er

Sammen er disse to parametre nok til at få en offentlig MCP-server til at fungere. Med det native xAI SDK:

from xai_sdk.tools import mcp

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

Og den nøjagtige modpart med Responses API i OpenAI-format:

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

Vigtige pointer

  • server_url og server_label er de eneste to påkrævede parametre
  • URL’en skal være HTTPS med et gyldigt SSL-certifikat; ingen localhost
  • Label’en sætter præfiks på alle værktøjskald fra denne server (det nøjagtige format er ikke dokumenteret; dette kursus noterer det som label__tool)
  • Vælg label’er, der er korte, beskrivende og unikke pr. server
  • Label’en er essentiel ved brug af flere servere for at undgå navnekonflikter