Zunanja orodja in podprti SDK-ji
Na tej strani
Trije vstopni punti do istega mehanizma
xAI omogoča oddaljeni dostop do MCP prek treh vmesnikov. Vsak cilja na drugačne razvijalce: enega za nove projekte, drugega za migrirane projekte in tretjega za specifične primere uporabe. Obnašanje MCP je v vseh treh primerih popolnoma enako; spreminjata se le sintaksa konfiguracije in pomožna orodja. Tvoja izbira zato temelji na tvojem obstoječem tehnološkem skladišču, ne pa na zmožnostih protokola.
Izvirni xAI SDK
To je metoda, ki jo xAI priporoča. Ponuja pomočnika mcp(), ki konfiguracijo stisne v en sam klic funkcije.
from xai_sdk import Client
from xai_sdk.tools import mcp
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(
model="grok-4.20-0309-reasoning",
tools=[
mcp(server_url="https://mcp.deepwiki.com/mcp")
],
include=["verbose_streaming"],
)
Pomočnik mcp() sprejme vse parametre konfiguracije MCP – URL, oznako, opis, dovoljena orodja, avtentikacijo – in jih samodejno pravilno oblikuje za API. To je najbolj jedrnata sintaksa in kar je najpomembneje, tista, pri kateri je najmanj verjetno, da boš naredil napako, saj so imena ključev in gnezdenje urejeni namesto tebe. To pot izberi za nov projekt brez omejitev združljivosti, za hitro prototipiranje in kadar izkoriščaš funkcije, specifične za xAI, kot je zgoraj vidno podrobno pretakanje (verbose streaming).
Responses API, združljiv z OpenAI
Ta vmesnik sprejme točno format API-ja OpenAI. Obstaja iz specifičnega razloga: da ekipi, ki je svoj aplikacijski kodeks že napisala v tem formatu, ni treba vsega prepisovati, da bi preizkusila Grok. Sprememba je omejena na ključ API in osnovni URL.
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input=[{"role": "user", "content": "Explain the React project"}],
tools=[{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki",
}],
)
Tukaj je strežnik MCP deklariran kot element polja tools, z vrsto "mcp" in parametri kot pari ključ-vrednost v istem objektu. Brez pomočnika: slovar napišeš ročno, kar pušča več prostora za tipkarske napake v imenih ključev.
Ta združljivost ima svojo ceno in vedeti jo moraš, preden gradiš na njej. Dva parametra, ki sta na voljo v izvirnem SDK-ju, tukaj nista dostopna: require_approval, ki ti omogoča zahtevati človeško potrditev pred izvajanjem orodja MCP, in connector_id, ki upravlja povezovalnike OpenAI. Če tvoj agent upravlja občutljive operacije in si računal na ročno potrditev, je ta omejitev blokator in te mora usmeriti nazaj k izvirnemu xAI SDK-ju. Responses API ostaja prava izbira za migracijo z OpenAI brez prepisovanja kode, za projekt z več ponudniki, kjer izmenjuješ med Grokom in drugimi modeli, ter za ekipe, ki so s tem formatom že seznanjene.
Voice Agent API
Tretji vmesnik je zasnovan za glasovne agente. Tipičen scenarij je telefonski asistent, ki mora sredi pogovora consultirati bazo znanja, preveriti status naročila ali poizvedovati v zunanjem sistemu – ne da bi klicatelj doživel nepojasnjeno tišino.
Konfiguracija MCP sledi istemu formatu kot v drugih SDK-jih, z istimi parametri server_url, server_label in drugimi. Razlika je v tem, kar se zgodi po klicu orodja: rezultat se integrira v tok sinteze govora, namesto da bi bil izpisan kot besedilo. To oblikuje način, kako pišeš opise svojih orodij in oblikuješ njihove odgovore, saj uporabnik nikoli ne bo videl tabele ali seznama – slišal jih bo le.
Kaj se med vmesniki ne spremeni
Ne glede na SDK je zaporedje enako. Grok odkrije orodja, ki jih izpostavlja strežnik MCP, izbere tisto, ki ustreza zahtevi, oblikuje klic s pravilnimi parametri in nato rezultat integrira v svoj odgovor. Noben od treh vmesnikov modela ne naredi bolj ali manj spretnega pri izbiri orodja.
Razlike so torej drugje: jedrnatost sintakse, razpoložljive obrobne funkcije – podrobno pretakanje pri xAI SDK-ju, združljivost formata pri Responses API-ju, sinteza govora pri Voice Agent – in dva parametra, ki manjkata v formatu OpenAI. Odloči se na podlagi teh meril in ne boš zgrešil.
Ključne ugotovitve
- Izvirni xAI SDK s
mcp()je najpreprostejša in najbolj celovita metoda - Responses API (format OpenAI) olajša migracijo, vendar ne podpira
require_approvalaliconnector_id - Voice Agent API povezuje glasovne agente z orodji MCP
- Obnašanje MCP je v vseh treh primerih identično; spremeni se le sintaksa
- Izbira naj temelji na tvojem obstoječem tehnološkem skladišču in specifičnih potrebah