server_url u server_label
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026 abbażi tal-paġna Remote MCP Tools ta’ xAI:
server_labeljippreċedi s-sejħiet tal-għodod, iżda d-dokumentazzjoni ma tispeċifikax il-format eżatt tal-prefiss; in-notazzjonilabel__tooluż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: 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_urluserver_labelhuma 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