Externa verktyg och SDK:er som stöds
På denna sida
Tre ingångar till samma mekanism
xAI exponerar fjärr-MCP via tre gränssnitt. De riktar sig till olika utvecklare: ett för nya projekt, ett annat för migrerade projekt och ett tredje för specifika användningskontexter. MCP-beteendet är exakt detsamma i alla tre fallen; endast konfigurationssyntaxen och kringliggande verktyg skiljer sig åt. Ditt val beror därför på din befintliga teknikstack, inte på protokollets kapacitet.
Det nativa xAI SDK:t
Detta är metoden som xAI rekommenderar. Det tillhandahåller en hjälpare mcp() som kondenserar konfigurationen till ett enda funktionsanrop.
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"],
)
Hjälparen mcp() accepterar alla MCP-konfigurationsparametrar – URL, etikett, beskrivning, tillåtna verktyg, autentisering – och hanterar formateringen korrekt för API:et. Detta är den mest koncisa syntaxen och, avgörande nog, den där risken för fel är minst, eftersom nyckelnamn och nästling hanteras åt dig. Välj denna väg för nya projekt utan kompatibilitetskrav, för snabb prototyputveckling och närhelst du utnyttjar xAI-specifika funktioner som den detaljerade strömningen (verbose streaming) som visas ovan.
Responses API, OpenAI-kompatibelt
Detta gränssnitt accepterar exakt samma format som OpenAI API. Det finns av en specifik anledning: så att ett team som redan har skrivit sin applikation i detta format inte behöver skriva om allt för att testa Grok. Ändringen begränsas till API-nyckeln och bas-URL:en.
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",
}],
)
Här deklareras MCP-servern som ett element i tools-arrayen, med typen "mcp" och parametrar som nyckel-värde-par i samma objekt. Ingen hjälpare: du skriver ordlistan för hand, vilket lämnar mer utrymme för stavfel i nyckelnamn.
Denna kompatibilitet har ett pris, och du bör känna till det innan du bygger vidare på den. Två parametrar som finns tillgängliga i det nativa SDK:t saknas här: require_approval, som låter dig kräva mänsklig validering innan ett MCP-verktyg körs, och connector_id, som hanterar OpenAI-kontakter. Om din agent hanterar känsliga operationer och du räknade med manuell validering är denna begränsning ett hinder och bör leda dig tillbaka till det nativa xAI SDK:t. Responses API förblir det rätta valet för migrering från OpenAI utan omskrivning, för projekt med flera leverantörer där du växlar mellan Grok och andra modeller, och för team som redan är bekanta med detta format.
Voice Agent API
Det tredje gränssnittet är designat för röstagenter. Det typiska scenariot är en telefonassistent som mitt i en konversation behöver konsultera en kunskapsbas, kontrollera orderstatus eller fråga ett externt system – utan att den som ringer upplever oförklarlig tystnad.
MCP-konfigurationen följer samma format som i de andra SDK:erna, med samma parametrar server_url, server_label med flera. Skillnaden ligger i vad som händer efter verktygsanropet: resultatet integreras i flödet för röstsyntes istället för att renderas som text. Detta formar hur du skriver dina verktygsbeskrivningar och ramar in deras svar, eftersom användaren aldrig kommer att se en tabell eller en lista – de kommer bara att höra dem.
Vad som inte ändras mellan gränssnitten
Oavsett vilket SDK du använder är sekvensen densamma. Grok upptäcker verktygen som exponeras av MCP-servern, väljer det som matchar begäran, formulerar anropet med korrekta parametrar och integrerar sedan resultatet i sitt svar. Inget av de tre gränssnitten gör modellen mer eller mindre skicklig på att välja ett verktyg.
Skillnaderna ligger alltså någon annanstans: syntaxens koncisitet, tillgängliga kringfunktioner – detaljerad strömning i xAI SDK:t, formatkompatibilitet i Responses API, röstsyntes i Voice Agent – samt de två parametrar som saknas i OpenAI-formatet. Besluta utifrån dessa kriterier, så kommer du inte att göra fel.
Viktiga punkter
- Det nativa xAI SDK:t med
mcp()är den enklaste och mest kompletta metoden - Responses API (OpenAI-format) underlättar migrering men stöder inte
require_approvalellerconnector_id - Voice Agent API kopplar röstagenter till MCP-verktyg
- MCP-beteendet är identiskt i alla tre fallen; endast syntaxen ändras
- Välj utifrån din befintliga teknikstack och specifika behov