Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

server_url in server_label

Lekcija 4 od 12 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Dva parametra, brez katerih ne gre
  2. server_url: Točen naslov končne točke
  3. server_label: Identiteta strežnika v pogovoru
  4. Minimalna konfiguracija v obeh SDK-jih
  5. Ključne ugotovitve

Posodobljeno 3. novembra 2026 na podlagi strani xAI Remote MCP Tools: server_label dodaja predpono klicem orodij, vendar dokumentacija ne določa natančne oblike predpone; zapis label__tool, uporabljen v tem tečaju, je bralna konvencija – dejansko obliko preveri v odgovorih svojega API-ja. Vir: Remote MCP Tools.

Dva parametra, brez katerih ne gre

Vsaka povezava med Grokom in oddaljenim strežnikom MCP temelji na dveh parametrih: server_url in server_label. Nista pogajalna – brez njiju API zavrne zahtevo, še preden poskusi karkoli. Vsi drugi parametri, na katere naletiš kasneje, le izpopolnjujejo to osnovo; nikoli je ne nadomestijo.

server_url
Kje se strežnik nahaja
server_label
Kako identificirati strežnik

server_url: Točen naslov končne točke

Parameter server_url vsebuje celoten URL strežnika MCP, na katerega se mora Grok povezati, ta URL pa sledi strogim pravilom.

Prvo pravilo je HTTPS. URL se mora začeti z https://, xAI pa zavrne vsako nešifrirano povezavo HTTP. Razlog je preprost: izmenjave med Grokom in strežnikom MCP prenašajo zahteve tvojih uporabnikov, rezultate orodij in včasih tudi sam avtentikacijski žeton. Če bi to krožilo v čistem besedilu, bi bilo to neopravičljivo.

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

# Zavrnjeno s strani API-ja
mcp(server_url="http://mcp.deepwiki.com/mcp")

Drugo pravilo zadeva natančnost poti. URL mora kazati na končno točko MCP, ne na koren domene. Skoraj vsi strežniki izpostavljajo svojo končno točko na namenski poti, konvencija pa se od strežnika do strežnika razlikuje. Tukaj so tri veljavne oblike, na katere boš naletel:

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

Tretje pravilo izhaja iz prvih dveh: localhost in zasebni IP-naslovi so izključeni. Strežnik mora biti dosegljiv iz infrastrukture xAI, na javni domeni, z veljavnim potrdilom SSL. To med razvojem postavlja konkretno vprašanje, saj strežnik MCP, ki ga pišeš, teče na tvojem računalniku. Običajna rešitev je uporaba tunela – na primer ngrok ali Cloudflare Tunnel –, ki za čas tvojih testov izpostavi tvojo lokalno instanco za javnim URL-jem HTTPS.

server_label: Identiteta strežnika v pogovoru

server_label je kratek identifikator, ki ga Grok uporablja za dodajanje predpone klicem orodij s tega strežnika. Njegova vloga je dvojna: omogočiti berljive sledi in odstraniti vsako dvoumnost, ko sočasno obstaja več strežnikov.

Dokumentacija xAI navaja, da predpona označuje klice orodij s tega strežnika, vendar ne določa natančne oblike predpone. V tem tečaju orodje search_docs s strežnika deepwiki označujemo kot deepwiki__search_docs zaradi berljivosti: pred gradnjo logike na tem preveri dejansko obliko v odgovorih API-ja.

mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)
# Klici orodij s tega strežnika bodo imeli predpono "deepwiki"

Pri izbiri dobre oznake te vodijo tri merila. Biti mora kratka, saj se doda imenu vsakega klica in dolgovezna oznaka nepotrebno napihuje tvoje dnevnike. Biti mora opisna, da je vir klica razviden na prvi pogled, ne da bi moral consultirati konfiguracijo. Biti mora edinstvena v tvoji konfiguraciji, sicer ne boš mogel razlikovati med dvema strežnikoma. Spodnji primeri izpolnjujejo vse tri zahteve:

server_label="deepwiki"     # Dokumentacija GitHub
server_label="crm"          # Sistem za upravljanje strank
server_label="jira"         # Sledenje karticam
server_label="search"       # Interni iskalnik

To postane veliko bolj otipljivo, takoj ko povežeš več strežnikov z isto sejo. Recimo, da tvoja interna dokumentacija in DeepWiki oba izpostavljata orodje z imenom search. Brez različnih oznak se imena orodij trčijo in Grok nima načina, da bi vedel, katerega ciljati. Z oznakami sta obe orodji različno predponjeni – tukaj zapisani kot deepwiki__search in internal-docs__search – in zmeda izgine. To točko boš ponovno obravnaval v lekciji, namenjeni več strežnikom.

Minimalna konfiguracija v obeh SDK-jih

Skupaj sta ta dva parametra dovolj, da javni strežnik MCP deluje. Z izvornim SDK-jem xAI:

from xai_sdk.tools import mcp

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

In popolnoma enakovredno z API-jem Responses v formatu OpenAI:

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

Ključne ugotovitve

  • server_url in server_label sta edina dva zahtevana parametra
  • URL mora biti HTTPS z veljavnim potrdilom SSL, brez localhosta
  • Oznaka doda predpono vsem klicem orodij s tega strežnika (natančna oblika ni dokumentirana; ta tečaj jo beleži kot label__tool)
  • Izberi oznake, ki so kratke, opisne in edinstvene za vsak strežnik
  • Oznaka je bistvena za več strežnikov, da se izogneš konfliktem imen