server_url un server_label
Šajā lapā
Atjaunināts 2026. gada 3. novembrī, pamatojoties uz xAI lapu Remote MCP Tools:
server_labelpievieno prefiksu rīku izsaukumiem, taču dokumentācija precīzi nenorāda prefiksa formātu; šajā kursā izmantotais apzīmējumslabel__toolir lasīšanas konvencija — pārbaudi faktisko formātu savās API atbildēs. Avots: Remote MCP Tools.
Divi parametri, bez kuriem neiztikt
Katrs savienojums starp Grok un attālo MCP serveri balstās uz diviem parametriem: server_url un server_label. Tie ir obligāti — bez tiem API noraida pieprasījumu, pat nemēģinot neko darīt. Visi pārējie parametri, ar ko sastapsies vēlāk, tikai precizē šo pamatu; tie to nekad neaizstāj.
server_url: Precīza galapunkta adrese
Parametrs server_url satur pilnu MCP servera URL, kuram Grok ir jāpieslēdzas, un šim URL ir jāievēro stingri noteikumi.
Pirmais noteikums ir HTTPS. URL ir jāsākas ar https://, un xAI noraida jebkuru nešifrētu HTTP savienojumu. Iemesls ir vienkāršs: apmaiņa starp Grok un MCP serveri ietver tavu lietotāju pieprasījumus, rīku rezultātus un dažkārt pat pašu autentifikācijas tokenu. Ļaut šiem datiem apritēt atklātā tekstā būtu nepieņemami.
# Pareizi
mcp(server_url="https://mcp.deepwiki.com/mcp")
# API noraida
mcp(server_url="http://mcp.deepwiki.com/mcp")
Otrais noteikums attiecas uz ceļa precizitāti. URL ir jānorāda tieši uz MCP galapunktu, nevis uz domēna sakni. Gandrīz visi serveri piedāvā savu galapunktu īpašā ceļā, un konvencijas katram serverim var atšķirties. Lūk, trīs derīgi formāti, ar ko sastapsies:
https://mcp.deepwiki.com/mcp
https://api.example.com/mcp
https://tools.monentreprise.com/v1/mcp
Trešais noteikums izriet no pirmajiem diviem: localhost un privātās IP adreses ir izslēgtas. Serverim ir jābūt sasniedzamam no xAI infrastruktūras, tas jāizvieto publiskā domēnā ar derīgu SSL sertifikātu. Izstrādes laikā tas rada konkrētu jautājumu, jo MCP serveris, ko raksti, darbojas tavā datorā. Parastais risinājums ir izmantot tuneli — piemēram, ngrok vai Cloudflare Tunnel — kas uz testu laiku padara tavu lokālo instanci pieejamu caur publisku HTTPS URL.
server_label: Servera identitāte sarunā
server_label ir īss identifikators, ko Grok izmanto, lai pievienotu prefiksu šī servera rīku izsaukumiem. Tam ir divi uzdevumi: padarīt izsekojamību lasāmu un novērst neskaidrības, ja vienlaikus darbojas vairāki serveri.
xAI dokumentācija norāda, ka etiķete (label) pievieno prefiksu šī servera rīku izsaukumiem, taču precīzi nenorāda prefiksa formātu. Šajā kursā mēs apzīmējam rīku search_docs no servera deepwiki kā deepwiki__search_docs, lai nodrošinātu lasāmību: pirms loģikas veidošanas uz šī pamata pārbaudi faktisko formātu API atbildēs.
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
# Šī servera rīku izsaukumiem tiks pievienots prefikss "deepwiki"
Laba nosaukuma izvēli nosaka trīs kritēriji. Tam jābūt īsam, jo tas tiek pievienots katra izsaukuma nosaukumam, un pārāk garš nosaukums lieki uzbriedina žurnālus. Tam jābūt aprakstošam, lai izsaukuma avots būtu saprotams ar vienu skatienu, neveicot papildu konfigurācijas pārbaudes. Tam jābūt unikālam tavā konfigurācijā, pretējā gadījumā nevarēsi atšķirt divus serverus. Zemāk redzamie piemēri atbilst visām trim prasībām:
server_label="deepwiki" # GitHub dokumentācija
server_label="crm" # Klientu vadības sistēma
server_label="jira" # Biļešu izsekošana
server_label="search" # Iekšējā meklētājprogramma
Tas kļūst daudz taustāmāk, tiklīdz vienai sesijai pievieno vairākus serverus. Pieņemsim, ka gan tava iekšējā dokumentācija, gan DeepWiki piedāvā rīku ar nosaukumu search. Bez atšķirīgiem nosaukumiem rīku nosaukumi saduras un Grok nevar noteikt, uz kuru mērķēt. Izmantojot nosaukumus, abiem rīkiem tiek pievienoti dažādi prefiksi — šeit apzīmēti kā deepwiki__search un internal-docs__search — un neskaidrība pazūd. Pie šī punkta atgriezīsies nodarbībā, kas veltīta vairāku serveru izmantošanai.
Minimālā konfigurācija abos SDK
Kopā šie divi parametri ir pietiekami, lai publiskais MCP serveris darbotos. Izmantojot natīvo xAI SDK:
from xai_sdk.tools import mcp
tools = [
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
]
Un precīzs ekvivalents, izmantojot Responses API OpenAI formātā:
tools = [{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki",
}]
Galvenās atziņas
server_urlunserver_labelir vienīgie divi obligātie parametri- URL ir jābūt HTTPS ar derīgu SSL sertifikātu; localhost nav atļauts
- Nosaukums (label) pievieno prefiksu visiem šī servera rīku izsaukumiem (precīzs formāts nav dokumentēts; šajā kursā to apzīmējam kā
label__tool) - Izvēlies nosaukumus, kas ir īsi, aprakstoši un unikāli katram serverim
- Nosaukums ir būtisks, strādājot ar vairākiem serveriem, lai izvairītos no nosaukumu konfliktiem