Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

server_url ir server_label

Paskaita 4 iš 12 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Du parametrai, be kurių neapsieisi
  2. server_url: Tikslus galinio taško adresas
  3. server_label: Serverio tapatybė pokalbyje
  4. Minimali konfigūracija abiejuose SDK
  5. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 3 d. remiantis xAI Remote MCP Tools puslapiu: server_label prideda priešdėlį įrankių kvietimams, tačiau dokumentacijoje nenurodytas tikslus priešdėlio formatas; šiame kurse naudojama label__tool notacija yra skaitymo konvencija – patikrinkite faktinį formatą savo API atsakymuose. Šaltinis: Remote MCP Tools.

Du parametrai, be kurių neapsieisi

Kiekvienas ryšys tarp Grok ir nuotolinio MCP serverio remiasi dviem parametrais: server_url ir server_label. Jie yra neprivalomi – be jų API atmeta užklausą dar prieš bandydama ką nors daryti. Visi kiti parametrai, su kuriais susidursite vėliau, tik patobulina šį pagrindą; jie jo niekada nepakeičia.

server_url
Kur yra serveris
server_label
Kaip identifikuoti serverį

server_url: Tikslus galinio taško adresas

Parametras server_url turi visą MCP serverio, prie kurio turi prisijungti Grok, URL adresą, ir šis URL turi griežtas taisykles.

Pirmoji – HTTPS. URL turi prasidėti https://, o xAI atmeta bet kokį neužšifruotą HTTP ryšį. Priežastis paprasta: keitimasis duomenimis tarp Grok ir MCP serverio apima jūsų naudotojų užklausas, įrankių rezultatus ir kartais patį autentifikavimo žetoną. Leisti tai cirkuliuoti grynu tekstu būtų nepateisinama.

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

# API atmesta
mcp(server_url="http://mcp.deepwiki.com/mcp")

Antroji taisyklė susijusi su kelio tikslumu. URL turi nukreipti tiesiai į MCP galinį tašką, o ne į domeno šaknį. Beveik visi serveriai savo galinį tašką eksponuoja specialiame kelyje, o konvencijos skiriasi. Štai trys galiojančios formos, su kuriomis susidursite:

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

Trečioji taisyklė išplaukia iš pirmųjų dviejų: localhost ir privatūs IP adresai neleidžiami. Serveris turi būti pasiekiamas iš xAI infrastruktūros, viešame domene, turint galiojantį SSL sertifikatą. Tai kelia konkretų klausimą kūrimo metu, nes MCP serverį, kurį rašote, paleidžiate savo kompiuteryje. Įprastas sprendimas – naudoti tunelį, pavyzdžiui, ngrok arba Cloudflare Tunnel, kuris jūsų lokalų egzempliorių laikinai eksponuoja už viešo HTTPS URL adreso testų metu.

server_label: Serverio tapatybė pokalbyje

server_label yra trumpas identifikatorius, kurį Grok naudoja kaip priešdėlį šio serverio įrankių kvietimams. Jo vaidmuo dvilypis: padaryti pėdsakus įskaitomus ir pašalinti bet kokį dviprasmiškumą, kai vienu metu veikia keli serveriai.

xAI dokumentacijoje nurodoma, kad etiketė pridedama kaip priešdėlis šio serverio įrankių kvietimams, tačiau nenurodomas tikslus priešdėlio formatas. Šiame kurse įrankį search_docs iš serverio deepwiki žymime kaip deepwiki__search_docs dėl aiškumo – prieš kurdami logiką, patikrinkite faktinį formatą API atsakymuose.

mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)
# Šio serverio įrankių kvietimai bus pradėti priešdėliu "deepwiki"

Renkantis gerą etiketę, vadovaukitės trimis kriterijais. Ji turi būti trumpa, nes pridedama prie kiekvieno kvietimo pavadinimo, o pernelyg išsami etiketė be reikalo išpūtų jūsų žurnalus. Ji turi būti aprašomoji, kad kvietimo šaltinis būtų aiškus iš pirmo žvilgsnio nesikonsultuojant su konfigūracija. Ji turi būti unikali jūsų konfigūracijoje, kitaip negalėsite atskirti dviejų serverių. Toliau pateikti pavyzdžiai atitinka visus tris reikalavimus:

server_label="deepwiki"     # GitHub dokumentacija
server_label="crm"          # Klientų valdymo sistema
server_label="jira"         # Užduočių sekimas
server_label="search"       # Vidinė paieškos sistema

Tai tampa daug apčiuopiamiau, kai prie tos pačios sesijos prijungiate kelis serverius. Tarkime, jūsų vidinė dokumentacija ir „DeepWiki“ abu eksponuoja įrankį pavadinimu search. Be skirtingų etikečių, įrankių pavadinimai susidurtų ir Grok neturėtų būdo žinoti, kurį taikyti. Su etiketėmis abu įrankiai gauna skirtingus priešdėlius – čia žymimus kaip deepwiki__search ir internal-docs__search – ir painiava išnyksta. Šį punktą dar kartą nagrinėsite pamokoje, skirtoje keliems serveriams.

Minimali konfigūracija abiejuose SDK

Šių dviejų parametrų pakanka, kad viešas MCP serveris veiktų. Naudojant vietinį xAI SDK:

from xai_sdk.tools import mcp

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

Ir tikslus ekvivalentas naudojant Responses API OpenAI formatu:

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

Svarbiausi punktai

  • server_url ir server_label yra vieninteliai du būtini parametrai
  • URL turi būti HTTPS su galiojančiu SSL sertifikatu, jokių localhost
  • Etiketė pridedama kaip priešdėlis visiems šio serverio įrankių kvietimams (tikslus formatas nedokumentuotas; šiame kurse jis žymimas kaip label__tool)
  • Rinkitės etiketes, kurios būtų trumpos, aprašomosios ir unikalios kiekvienam serveriui
  • Etiketė yra būtina dirbant su keliais serveriais, kad išvengtumėte pavadinimų konfliktų