Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

server_url och server_label

Lektion 4 av 12 Uppdaterad 3 november 2026 Utvecklare
På denna sida
  1. De två parametrarna du inte kan undvara
  2. server_url: Den exakta slutpunktsadressen
  3. server_label: Serverns identitet i konversationen
  4. Minimal konfiguration i båda SDK:erna
  5. Viktiga punkter

Uppdaterat den 3 november 2026 baserat på xAI:s sida Remote MCP Tools: server_label lägger till ett prefix vid verktygsanrop, men dokumentationen specificerar inte det exakta prefixformatet; notationen label__tool som används i denna kurs är en läskonvention – verifiera det faktiska formatet i dina API-svar. Källa: Remote MCP Tools.

De två parametrarna du inte kan undvara

Varje anslutning mellan Grok och en fjärr-MCP-server förlitar sig på två parametrar: server_url och server_label. De är icke-förhandlingsbara – utan dem avvisar API:t begäran innan något försök görs. Alla andra parametrar du stöter på senare förfinar denna grund; de ersätter den aldrig.

server_url
Var servern finns
server_label
Hur servern identifieras

server_url: Den exakta slutpunktsadressen

Parametern server_url innehåller den fullständiga URL:en till MCP-servern som Grok måste ansluta till, och denna URL följer strikta regler.

Den första regeln är HTTPS. URL:en måste börja med https://, och xAI avvisar alla okrypterade HTTP-anslutningar. Anledningen är enkel: utbytet mellan Grok och MCP-servern bär på dina användares förfrågningar, verktygsresultat och ibland själva autentiseringstoken. Att låta detta cirkulera i klartext skulle vara oförsvarbart.

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

# Avvisas av API:t
mcp(server_url="http://mcp.deepwiki.com/mcp")

Den andra regeln gäller sökvägens precision. URL:en måste peka på MCP-slutpunkten, inte domänroten. Nästan alla servrar exponerar sin slutpunkt på en dedikerad sökväg, och konventionen varierar från en till en annan. Här är tre giltiga former du kommer att stöta på:

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

Den tredje regeln följer av de två första: localhost och privata IP-adresser är uteslutna. Servern måste vara nåbar från xAI:s infrastruktur, på en offentlig domän, med ett giltigt SSL-certifikat. Detta väcker en konkret fråga under utvecklingen, eftersom MCP-servern du skriver körs på din egen maskin. Den vanliga lösningen är att använda en tunnel – till exempel ngrok eller Cloudflare Tunnel – som exponerar din lokala instans bakom en offentlig HTTPS-URL under dina tester.

server_label: Serverns identitet i konversationen

server_label är en kort identifierare som Grok använder för att sätta prefix på verktygsanrop från denna server. Dess roll är twofold: göra spårning läsbar och ta bort all tvetydighet när flera samexisterande servrar finns.

xAI:s dokumentation anger att etiketten sätter prefix på verktygsanrop från denna server, utan att specificera det exakta prefixformatet. I denna kurs betecknar vi ett search_docs-verktyg från deepwiki-servern som deepwiki__search_docs, för läsbarhetens skull: verifiera det faktiska formatet i API-svar innan du bygger logik ovanpå det.

mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)
# Verktygsanrop från denna server kommer att ha prefixet "deepwiki"

Tre kriterier styr valet av en bra etikett. Den måste vara kort, eftersom den läggs till i namnet på varje anrop och en utförlig etikett blåser upp dina loggar i onödan. Den måste vara beskrivande, så att källan till ett anrop är läsbar vid en första anblick utan att du behöver konsultera konfigurationen. Den måste vara unik i din konfiguration, annars kan du inte skilja mellan två servrar. Exemplen nedan uppfyller dessa tre krav:

server_label="deepwiki"     # GitHub-dokumentation
server_label="crm"          # Kundhanteringssystem
server_label="jira"         # Ärendehantering
server_label="search"       # Intern sökmotor

Detta blir mycket mer påtagligt så snart du ansluter flera servrar till samma session. Antag att din interna dokumentation och DeepWiki båda exponerar ett verktyg som heter search. Utan distinkta etiketter krockar verktygsnamnen och Grok har inget sätt att veta vilket som ska målas in. Med etiketter får de två verktygen olika prefix – här noterade som deepwiki__search och internal-docs__search – och förvirringen försvinner. Du kommer att återkomma till denna punkt i lektionen dedikerad till flera servrar.

Minimal konfiguration i båda SDK:erna

Tillsammans räcker dessa två parametrar för att få en offentlig MCP-server att fungera. Med det nativa xAI SDK:t:

from xai_sdk.tools import mcp

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

Och den exakta motsvarigheten med Responses API i OpenAI-format:

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

Viktiga punkter

  • server_url och server_label är de enda två obligatoriska parametrarna
  • URL:en måste vara HTTPS med ett giltigt SSL-certifikat, inget localhost
  • Etiketten sätter prefix på alla verktygsanrop från denna server (exakt format är inte dokumenterat; denna kurs noterar det som label__tool)
  • Välj etiketter som är korta, beskrivande och unika per server
  • Etiketten är avgörande för flera servrar för att undvika namnkollisioner