Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

server_url u server_label

Lezzjoni 4 / 12 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Iż-żewġ parametri li ma tistax tagħmel mingħajrhom
  2. server_url: L-indirizz eżatt tal-endpoint
  3. server_label: L-identità tas-server fil-konversazzjoni
  4. Konfigurazzjoni minima fiż-żewġ SDKs
  5. Punti Ewlenin

Aġġornat fit-3 ta’ Novembru, 2026 abbażi tal-paġna Remote MCP Tools ta’ xAI: server_label jippreċedi s-sejħiet tal-għodod, iżda d-dokumentazzjoni ma tispeċifikax il-format eżatt tal-prefiss; in-notazzjoni label__tool użata f’dan il-kors hija konvenzjoni ta’ qari—ivverifika l-format attwali fir-risponsi tal-API tiegħek. Sors: Remote MCP Tools.

Iż-żewġ parametri li ma tistax tagħmel mingħajrhom

Kull konnessjoni bejn Grok u server MCP remot tiddependi fuq żewġ parametri: server_url u server_label. Dawn mhumiex negozjabbli—mingħajrhom, l-API tiċħad it-talba qabel ma tipprova xi ħaġa. Il-parametri l-oħra kollha li tiltaqa’ magħhom aktar ‘il quddiem jirfinaw din il-bażi; qatt ma jissostitwixxuha.

server_url
Fejn jinsab is-server
server_label
Kif tidentifika s-server

server_url: L-indirizz eżatt tal-endpoint

Il-parametru server_url fih l-URL sħiħ tas-server MCP li magħhom irid jikkonnettja Grok, u dan l-URL isegwi regoli stretti.

L-ewwel waħda hija HTTPS. L-URL irid jibda b’https://, u xAI tiċħad kwalunkwe konnessjoni HTTP mhux ikkrittata. Ir-raġuni hija sempliċi: l-iskambji bejn Grok u s-server MCP iġorru t-talbiet tal-utenti tiegħek, ir-riżultati tal-għodod, u xi kultant it-token tal-awtentikazzjoni nnifsu. Li tħalli dan jiċċirkola b’test ċar ikun indefendibbli.

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

# Miċħuda mill-API
mcp(server_url="http://mcp.deepwiki.com/mcp")

It-tieni regola tikkonċerna l-preċiżjoni tal-mogħdija (path). L-URL irid jipponta lejn l-endpoint MCP, mhux lejn il-għerq tad-dominju. Kważi s-servers kollha jesponu l-endpoint tagħhom fuq mogħdija ddedikata, u l-konvenzjoni tvarja minn wieħed għall-ieħor. Hawnhekk huma tliet forom validi li se tiltaqa’ magħhom:

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

It-tielet regola tirriżulta mill-ewwel tnejn: localhost u indirizzi IP privati huma esklużi. Is-server irid ikun aċċessibbli mill-infrastruttura ta’ xAI, fuq dominju pubbliku, b’ċertifikat SSL validu. Dan iqajjem mistoqsija konkreta waqt l-iżvilupp, peress li s-server MCP li qed tikteb jaħdem fuq il-magna tiegħek. Is-soluzzjoni tas-soltu hija li tuża mina (tunnel)—ngrok jew Cloudflare Tunnel, pereżempju—li tesponi l-istanza lokali tiegħek wara URL HTTPS pubbliku għat-tul tat-testijiet tiegħek.

server_label: L-identità tas-server fil-konversazzjoni

Is-server_label huwa identifikatur qasir li Grok juża biex jippreċedi s-sejħiet tal-għodod minn dan is-server. Ir-rwol tiegħu huwa doppju: jagħmel it-traċċi leġġibbli, u jneħħi kwalunkwe ambigwità meta jkunu jeżistu servers multipli flimkien.

Id-dokumentazzjoni ta’ xAI tgħid li l-label jippreċedi s-sejħiet tal-għodod minn dan is-server, mingħajr ma tispeċifika l-format eżatt tal-prefiss. F’dan il-kors, nindikaw għodda search_docs mis-server deepwiki bħala deepwiki__search_docs, għal-leġġibbiltà: ivverifika l-format attwali fir-risponsi tal-API qabel ma tibni loġika fuqha.

mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)
# Sejħiet tal-għodod minn dan is-server se jiġu ppreċeduti b'"deepwiki"

Tliet kriterji jiggwidaw l-għażla ta’ label tajba. Trid tkun qasira, peress li żżid mal-isem ta’ kull sejħa u label verbjuża tintefa’ l-logs tiegħek mingħajr bżonn. Trid tkun deskrittiva, sabiex is-sors ta’ sejħa jkun leġġibbli f’daqqa t’għajn mingħajr ma tikkonsulta l-konfigurazzjoni. Trid tkun unika fil-konfigurazzjoni tiegħek, inkella ma tkunx tista’ tagħmel distinzjoni bejn żewġ servers. L-eżempji hawn taħt jissodisfaw dawn it-tliet rekwiżiti:

server_label="deepwiki"     # Dokumentazzjoni ta' GitHub
server_label="crm"          # Sistema ta' ġestjoni tal-klijenti
server_label="jira"         # Traċċar tat-tickets
server_label="search"       # Magna tat-tiftix interna

Dan isir ħafna aktar tanġibbli hekk kif tikkonnettja servers multipli għall-istess sessjoni. Ejja ngħidu li d-dokumentazzjoni interna tiegħek u DeepWiki t-tnejn jesponu għodda msejħa search. Mingħajr labels distinti, l-ismijiet tal-għodod jikkollidu u Grok ma jkollu l-ebda mod kif jaf liema wieħed jimmira. Bil-labels, iż-żewġ għodod jiġu ppreċeduti b’mod differenti—indikati hawnhekk bħala deepwiki__search u internal-docs__search—u l-konfużjoni tisparixxi. Se terġa’ taraha din il-punt fil-lezzjoni ddedikata għas-servers multipli.

Konfigurazzjoni minima fiż-żewġ SDKs

Flimkien, dawn iż-żewġ parametri huma biżżejjed biex jagħmlu server MCP pubbliku jaħdem. Mas-SDK nattiva ta’ xAI:

from xai_sdk.tools import mcp

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

U l-ekwivalenti eżatt bl-API tar-Risposti fil-format ta’ OpenAI:

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

Punti Ewlenin

  • server_url u server_label huma l-uniki żewġ parametri meħtieġa
  • L-URL irid ikun HTTPS b’ċertifikat SSL validu, l-ebda localhost
  • Il-label jippreċedi s-sejħiet kollha tal-għodod minn dan is-server (il-format eżatt mhuwiex iddokumentat; dan il-kors jinnotah bħala label__tool)
  • Agħżel labels li huma qosra, deskrittivi, u uniċi għal kull server
  • Il-label hija essenzjali għas-servers multipli biex jiġu evitati kunflitti fl-ismijiet