server_url és server_label
Ezen az oldalon
Frissítve: 2026. november 3. az xAI Remote MCP Tools oldala alapján: a
server_labelelő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áltlabel__eszközjelö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: 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 aserver_labelaz 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