Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

server_url un server_label

Nodarbība 4 no 12 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Divi parametri, bez kuriem neiztikt
  2. server_url: Precīza galapunkta adrese
  3. server_label: Servera identitāte sarunā
  4. Minimālā konfigurācija abos SDK
  5. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz xAI lapu Remote MCP Tools: server_label pievieno prefiksu rīku izsaukumiem, taču dokumentācija precīzi nenorāda prefiksa formātu; šajā kursā izmantotais apzīmējums label__tool ir 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
Kur atrodas serveris
server_label
Kā identificēt serveri

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_url un server_label ir 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