Lähe põhisisu juurde
Eesti— Vali keel
Menüü

server_url ja server_label

Õppetund 4 / 12 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Kaks parameetrit, ilma milleta ei saa
  2. server_url: täpne lõpp-punkti aadress
  3. server_label: serveri identiteet vestluses
  4. Minimaalne konfiguratsioon mõlemas SDK-s
  5. Peamised punktid

Uuendatud 3. novembril 2026 xAI Remote MCP Tools lehe põhjal: server_label lisab tööriistakutsetele eesliite, kuid dokumentatsioon ei täpsusta eesliite täpset vormingut; selles kursuses kasutatav tähistus label__tool on lugemiskonventsioon – kontrolli tegelikku vormingut oma API vastustes. Allikas: Remote MCP Tools.

Kaks parameetrit, ilma milleta ei saa

Iga Groki ja kaug-MCP-serveri vaheline ühendus tugineb kahele parameetrile: server_url ja server_label. Need on tingimusteta nõuded – ilma nendeta lükkab API taotluse tagasi juba enne mis tahes katset. Kõik muud parameetrid, millega hiljem kokku puutud, täiustavad seda alust; need ei asenda seda kunagi.

server_url
Kus server asub
server_label
Kuidas serverit tuvastada

server_url: täpne lõpp-punkti aadress

Parameeter server_url sisaldab täielikku URL-i MCP-serverisse, millega Grok peab ühenduma, ja see URL järgib rangeid reegleid.

Esimene neist on HTTPS. URL peab algama https:// ja xAI lükkab tagasi kõik krüpteerimata HTTP-ühendused. Põhjus on lihtne: vahetus Groki ja MCP-serveri vahel kannab sinu kasutajate päringuid, tööriistade tulemusi ja mõnikord isegi autentimistokenit endas. Selle lubamine levida lihttekstina oleks vastuvõetamatu.

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

# API lükkab tagasi
mcp(server_url="http://mcp.deepwiki.com/mcp")

Teine reegel puudutab raja täpsust. URL peab osutama MCP-lõpp-punktile, mitte domeeni juurele. Peaaegu kõik serverid avaldavad oma lõpp-punkti spetsiaalsel rajal ja konventsioon varieerub ühelt teisele. Siin on kolm kehtivat vormi, millega kohtud:

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

Kolmas reegel tuleneb kahest esimesest: localhost ja privaatse IP-aadressid on välistatud. Server peab olema xAI taristust kättesaadav avalikus domeenis kehtiva SSL-sertifikaadiga. See tekitab arenduse käigus konkreetse küsimuse, kuna MCP-server, mida kirjutad, töötab sinu masinas. Tavaline lahendus on kasutada tunnelit – näiteks ngrok või Cloudflare Tunnel –, mis avaldab sinu kohaliku eksemplari avaliku HTTPS-URL-i taga testide kestuse ajaks.

server_label: serveri identiteet vestluses

server_label on lühike identifikaator, mida Grok kasutab sellest serverist pärit tööriistakutsete eesliitena. Selle roll on kahekordne: muuta jäljed loetavaks ja kõrvaldada igasugune mitmetimõistetavus, kui samaaegselt eksisteerib mitu serverit.

xAI dokumentatsioon väidab, et silt lisab sellest serverist pärit tööriistakutsetele eesliite, täpsustamata eesliite täpset vormingut. Selles kursuses tähistame deepwiki serveri tööriista search_docs kui deepwiki__search_docs, et tagada loetavus: enne loogika ülesehitamist kontrolli tegelikku vormingut API vastustes.

mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)
# Sellest serverist pärit tööriistakutsed saavad eesliite "deepwiki"

Hea sildi valikut juhivad kolm kriteeriumi. See peab olema lühike, kuna see lisandub iga kutse nimele ja liiga pikk silt paisutab sinu logisid asjatult. See peab olema kirjeldav, et kutse allikas oleks pilguheituga loetav ilma konfiguratsiooni konsulteerimata. See peab olema sinu konfiguratsioonis unikaalne, vastasel juhul ei saa kahe serveri vahel vahet teha. Allpool toodud näited vastavad neile kolmele nõudele:

server_label="deepwiki"     # GitHubi dokumentatsioon
server_label="crm"          # Kliendihaldussüsteem
server_label="jira"         # Piletite jälgimine
server_label="search"       # Sisemine otsingumootor

See muutub palju käegakatsutavamaks niipea, kui ühendad samasse seanssi mitu serverit. Oletame, et nii sinu sisemine dokumentatsioon kui ka DeepWiki avaldavad tööriista nimega search. Ilma eristavate siltideta põrkuvad tööriistade nimed ja Grokil pole aimugi, kumbale sihtida. Siltidega saavad kaks tööriista erinevad eesliited – siin tähistatud kui deepwiki__search ja internal-docs__search – ja segadus kaob. Tuled selle punkti juurde tagasi mitme serveriga pühendatud tunnis.

Minimaalne konfiguratsioon mõlemas SDK-s

Koos piisab neist kahest parameetrist avaliku MCP-serveri töölepanekuks. Kasutades kohalikku xAI SDK-d:

from xai_sdk.tools import mcp

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

Ja täpne vaste Responses API-le OpenAI vormingus:

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

Peamised punktid

  • server_url ja server_label on ainsad kohustuslikud parameetrid
  • URL peab olema HTTPS kehtiva SSL-sertifikaadiga, localhost on keelatud
  • Silt lisab eesliite kõigile sellest serverist pärit tööriistakutsetele (täpne vorming ei ole dokumenteeritud; see kursus tähistab seda kui label__tool)
  • Vali sildid, mis on lühikesed, kirjeldavad ja iga serveri jaoks unikaalsed
  • Silt on mitme serveri kasutamisel hädavajalik nimede konfliktide vältimiseks