Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

server_url és server_label

4. lecke 12 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. A két paraméter, ami nélkül nincs működés
  2. server_url: A pontos végpont címe
  3. server_label: A kiszolgáló identitása a beszélgetésben
  4. Minimális konfiguráció mindkét SDK-ban
  5. Főbb megállapítások

Frissítve: 2026. november 3. az xAI Remote MCP Tools oldala alapján: a server_label előtagként szolgál az eszközhívásoknál, de a dokumentáció nem határozza meg a pontos formátumot; ebben a tananyagban használt label__eszköz jelölés olvasási konvenció – ellenőrizd a tényleges formátumot az API-válaszokban. Forrás: Remote MCP Tools.

A két paraméter, ami nélkül nincs működés

Minden Grok és távoli MCP-kiszolgáló közötti kapcsolat két paraméteren múlik: a server_url-on és a server_label-ön. Ezek nem tárgyalhatók: nélkülük az API még mielőtt bármit megpróbálna, elutasítja a kérést. Az összes többi paraméter, amivel később találkozol, csak finomítja ezt az alapot; sosem helyettesíti azt.

server_url
Ahol a kiszolgáló található
server_label
Hogyan azonosítsd a kiszolgálót

server_url: A pontos végpont címe

A server_url paraméter tartalmazza annak az MCP-kiszolgálónak a teljes URL-címét, amelyhez a Groknak csatlakoznia kell, és ez az URL szigorú szabályokat követ.

Az első szabály a HTTPS. Az URL-nek https://-sel kell kezdődnie, és az xAI elutasít minden titkosítatlan HTTP-kapcsolatot. Az ok egyszerű: a Grok és az MCP-kiszolgáló közötti kommunikáció tartalmazza a felhasználóid kéréseit, az eszközök eredményeit, és néha magát a hitelesítési tokent is. Ha ezeket nyílt szövegként engednéd keringeni, az védhetetlen lenne.

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

# Az API elutasítja
mcp(server_url="http://mcp.deepwiki.com/mcp")

A második szabály az útvonal pontosságára vonatkozik. Az URL-nek közvetlenül az MCP-végpontra kell mutatnia, nem a tartomány gyökerére. Szinte minden kiszolgáló egy dedikált útvonalon teszi elérhetővé a végpontját, és a konvenció kiszolgálónként változik. Íme három érvényes forma, amivel találkozhatsz:

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

A harmadik szabály az első kettőből következik: a localhost és a privát IP-címek kizártak. A kiszolgálónak elérhetőnek kell lennie az xAI infrastruktúrája számára, nyilvános tartományon, érvényes SSL-tanúsítvánnyal. Ez fejlesztés közben konkrét kérdést vet fel, mivel az általad írt MCP-kiszolgáló a saját gépeden fut. A szokásos megoldás egy alagút használata – például ngrok vagy Cloudflare Tunnel –, amely a tesztelés időtartamára egy nyilvános HTTPS-URL mögé helyezi a helyi példányodat.

server_label: A kiszolgáló identitása a beszélgetésben

A server_label egy rövid azonosító, amelyet a Grok előtagként használ az erről a kiszolgálóról származó eszközhívásoknál. Szerepe kettős: olvashatóvá teszi a naplókat, és megszünteti a félreértést, amikor több kiszolgáló is jelen van.

Az xAI dokumentációja szerint a címke előtagként szolgál az erről a kiszolgálóról induló eszközhívásoknál, anélkül, hogy megadná a pontos előtag formátumát. Ebben a tananyagban a deepwiki kiszolgáló search_docs eszközét deepwiki__search_docsként jelöljük az olvashatóság kedvéért: mielőtt logikát építenél rá, ellenőrizd a tényleges formátumot az API-válaszokban.

mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)
# Az erről a kiszolgálóról induló eszközhívások előtagja "deepwiki" lesz

Három kritérium vezérli a jó címke választását. Rövidnek kell lennie, mivel hozzáadódik minden hívás nevéhez, és a bőbeszédű címke feleslegesen felduzzasztja a naplóidat. Leírónak kell lennie, így a hívás forrása első pillantásra olvasható, a konfiguráció tanulmányozása nélkül. Egyedinek kell lennie a konfigurációdon belül, különben nem tudsz különbséget tenni két kiszolgáló között. Az alábbi példák megfelelnek ennek a három követelménynek:

server_label="deepwiki"     # GitHub dokumentáció
server_label="crm"          # Ügyfélkezelő rendszer
server_label="jira"         # Hibajegy-követés
server_label="search"       # Belső keresőmotor

Ez sokkal kézzelfoghatóbbá válik, amint több kiszolgálót csatlakoztatsz ugyanahhoz a munkamenethez. Tegyük fel, hogy a belső dokumentációd és a DeepWiki is kínál egy search nevű eszközt. Külön címkék nélkül az eszköznevek ütköznek, és a Groknak nincs módja eldönteni, melyiket célozza meg. Címkékkel a két eszköz különböző előtagot kap – itt deepwiki__search és internal-docs__searchként jelölve –, és a zavar megszűnik. Erre a pontra visszatérünk majd a többkiszolgálós konfigurációnak szánt leckében.

Minimális konfiguráció mindkét SDK-ban

Ez a két paraméter együtt elég ahhoz, hogy egy nyilvános MCP-kiszolgáló működjön. A natív xAI SDK-val:

from xai_sdk.tools import mcp

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

És a pontos megfelelője az OpenAI formátumú Responses API-val:

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

Főbb megállapítások

  • A server_url és a server_label az egyetlen két kötelező paraméter
  • Az URL-nek HTTPS-nek kell lennie érvényes SSL-tanúsítvánnyal; localhost nem megengedett
  • A címke előtagként szolgál az erről a kiszolgálóról induló összes eszközhívásnál (a pontos formátum nincs dokumentálva; ez a tananyag címke__eszközként jegyzi)
  • Válassz olyan címkéket, amelyek rövidek, leírók és kiszolgálónként egyediek
  • A címke elengedhetetlen többkiszolgálós környezetben a névütközések elkerüléséhez