Externé nástroje a podporované SDK
Na tejto strane
Tri vstupné body k rovnakému mechanizmu
xAI sprístupňuje vzdialený protokol MCP prostredníctvom troch rozhraní. Každé z nich cieli na iný typ vývojára: jedno pre nové projekty, druhé pre migrované projekty a tretie pre špecifické kontexty použitia. Správanie MCP je vo všetkých troch prípadoch úplne rovnaké; mení sa iba syntax konfigurácie a okolité nástroje. Tvoj výber preto závisí od tvojho existujúceho technologického stacku, nie od schopností samotného protokolu.
Natívne xAI SDK
Toto je metóda, ktorú xAI odporúča. Poskytuje pomocnú funkciu mcp(), ktorá zhušťuje celú konfiguráciu do jediného volania funkcie.
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"],
)
Pomocná funkcia mcp() akceptuje všetky parametre konfigurácie MCP – URL, štítok, popis, povolené nástroje, autentifikáciu – a sama sa postará o ich správne naformátovanie pre API. Ide o najstručnejšiu syntax a čo je kľúčové, o spôsob, pri ktorom je najmenej pravdepodobné, že urobíš chybu, keďže názvy kľúčov a ich vnorenie sú vybavené za teba. Túto cestu si vyber pre nový projekt bez obmedzení kompatibility, pre akúkoľvek rýchlu tvorbu prototypov a vždy, keď využívaš funkcie špecifické pre xAI, ako je vyššie uvedené podrobné streamovanie (verbose streaming).
Responses API kompatibilné s OpenAI
Toto rozhranie prijíma presne formát API od OpenAI. Existuje z konkrétneho dôvodu: aby tím, ktorý už napísal svoju aplikáciu v tomto formáte, nemusel prepisovať všetko len preto, aby vyskúšal model Grok. Zmena sa obmedzuje na API kľúč a základnú URL adresu.
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",
}],
)
Tu je server MCP deklarovaný ako prvok poľa tools, s typom "mcp" a parametrami ako páry kľúč-hodnota v tom istom objekte. Žiadna pomocná funkcia: slovník píšeš ručne, čo ponecháva väčší priestor na preklep v názve kľúča.
Táto kompatibilita má svoju cenu a mal by si ju poznať skôr, než na nej postavíš svoje riešenie. Dva parametre dostupné v natívnom SDK tu nie sú k dispozícii: require_approval, ktorý ti umožňuje vyžadovať ľudské schválenie pred vykonaním nástroja MCP, a connector_id, ktorý spravuje konektory OpenAI. Ak tvoj agent spracováva citlivé operácie a spoliehal si sa na manuálne overenie, toto obmedzenie je blokujúce a malo by ťa nasmerovať späť k natívnemu xAI SDK. Responses API zostáva správnou voľbou pre migráciu z OpenAI bez prepisovania kódu, pre projekt s viacerými poskytovateľmi, kde striedaš model Grok s inými modelmi, a pre tímy, ktoré sú už s týmto formátom oboznámené.
Voice Agent API
Tretie rozhranie je navrhnuté špeciálne pre hlasových agentov. Typickým scenárom je telefónny asistent, ktorý potrebuje uprostred konverzácie nahliadnuť do znalostnej bázy, skontrolovať stav objednávky alebo dopytovať externý systém – a to všetko bez toho, aby volajúci zaznamenal nevysvetliteľné ticho.
Konfigurácia MCP nasleduje rovnaký formát ako v ostatných SDK, s rovnakými parametrami server_url, server_label a ďalšími. Rozdiel spočíva v tom, čo sa deje po zavolaní nástroja: výsledok sa integruje do toku syntézy hlasu namiesto toho, aby sa vykreslil ako text. To ovplyvňuje spôsob, akým píšeš popisy svojich nástrojov a formuluješ ich odpovede, keďže používateľ nikdy neuvidí tabuľku ani zoznam – bude ich iba počuť.
Čo sa naprieč rozhraniami nemení
Bez ohľadu na použité SDK je postupnosť vždy rovnaká. Grok objaví nástroje vystavené serverom MCP, vyberie ten, ktorý zodpovedá požiadavke, sformuluje volanie so správnymi parametrami a následne integruje výsledok do svojej odpovede. Žiadne z troch rozhraní neurobí model viac či menej zručným pri výbere nástroja.
Rozdiely teda spočívajú inde: v stručnosti syntaxe, v dostupných doplnkových funkciách – podrobné streamovanie v xAI SDK, kompatibilita formátu v Responses API, syntéza hlasu vo Voice Agent – a v dvoch parametroch chýbajúcich vo formáte OpenAI. Rozhoduj sa na základe týchto kritérií a neurobíš chybu.
Kľúčové poznatky
- Natívne xAI SDK s funkciou
mcp()je najjednoduchšia a najkomplexnejšia metóda - Responses API (formát OpenAI) uľahčuje migráciu, ale nepodporuje
require_approvalaniconnector_id - Voice Agent API pripája hlasových agentov k nástrojom MCP
- Správanie MCP je vo všetkých troch prípadoch identické; mení sa iba syntax
- Vyberaj si na základe svojho existujúceho stacku a špecifických potrieb