Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Externe tools en ondersteunde SDK's

Les 3 van 12 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Drie ingangspunten voor hetzelfde mechanisme
  2. De native xAI SDK
  3. De Responses API, compatibel met OpenAI
  4. De Voice Agent API
  5. Wat niet verandert tussen interfaces
  6. Belangrijkste punten

Drie ingangspunten voor hetzelfde mechanisme

xAI stelt remote MCP beschikbaar via drie interfaces. Deze richten zich op verschillende ontwikkelaars: één voor nieuwe projecten, een tweede voor gemigreerde projecten en een derde voor specifieke gebruiksscenario’s. Het gedrag van MCP is in alle drie de gevallen exact hetzelfde; alleen de configuratiesyntaxis en de randapparatuur wijzigen. Uw keuze hangt daarom af van uw bestaande stack, niet van de mogelijkheden van het protocol.

De native xAI SDK

Dit is de methode die xAI aanbeveelt. Deze biedt een mcp()-helper die de configuratie samenvat tot één functieaanroep.

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"],
)

De mcp()-helper accepteert alle MCP-configuratieparameters—URL, label, beschrijving, toegestane tools, authenticatie—en zorgt voor de juiste opmaak voor de API. Dit is de beknoptste syntaxis en, cruciaal, de methode waarbij u het minst snel fouten maakt, omdat sleutelnamen en nesting automatisch voor u worden afgehandeld. Kies deze weg voor een nieuw project zonder compatibiliteitsbeperkingen, voor rapid prototyping, en wanneer u gebruikmaakt van xAI-specifieke functies zoals de hierboven zichtbare verbose streaming.

De Responses API, compatibel met OpenAI

Deze interface accepteert exact het OpenAI API-formaat. Deze bestaat om een specifieke reden: zodat een team dat zijn applicatie reeds in dit formaat heeft geschreven, niet alles hoeft te herschrijven om Grok te proberen. De wijziging beperkt zich tot de API-sleutel en de basis-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",
    }],
)

Hier wordt de MCP-server gedeclareerd als een element van de tools-array, met het type "mcp" en parameters als sleutel-waardeparen in hetzelfde object. Geen helper: u schrijft het dictionary handmatig, wat meer ruimte laat voor typefouten in een sleutelnaam.

Deze compatibiliteit heeft een prijs, en die moet u kennen voordat u hierop voortbouwt. Twee parameters die beschikbaar zijn in de native SDK, ontbreken hier: require_approval, waarmee u menselijke validatie kunt vereisen voordat een MCP-tool wordt uitgevoerd, en connector_id, dat OpenAI-connectors beheert. Als uw agent gevoelige bewerkingen uitvoert en u rekende op handmatige validatie, dan is deze beperking een blokkade en moet u terugkeren naar de native xAI SDK. De Responses API blijft de juiste keuze voor migratie vanaf OpenAI zonder herschrijven, voor een project met meerdere providers waarbij u wisselt tussen Grok en andere modellen, en voor een team dat al vertrouwd is met dit formaat.

De Voice Agent API

De derde interface is ontworpen voor voice agents. Het typische scenario is een telefonische assistent die midden in een gesprek een kennisbank moet raadplegen, de status van een bestelling moet controleren of een extern systeem moet bevragen—zonder dat de beller onverklaarbare stilte ervaart.

De MCP-configuratie volgt hetzelfde formaat als in de andere SDK’s, met dezelfde parameters zoals server_url, server_label en anderen. Het verschil ligt in wat er gebeurt na de tool-aanroep: het resultaat wordt geïntegreerd in de spraaksynthesestroom in plaats van als tekst te worden weergegeven. Dit bepaalt hoe u uw tool-beschrijvingen schrijft en hun antwoorden formuleert, aangezien de gebruiker nooit een tabel of lijst zal zien—ze zullen deze alleen horen.

Wat niet verandert tussen interfaces

Ongeacht de SDK is de volgorde hetzelfde. Grok ontdekt de tools die door de MCP-server worden blootgesteld, selecteert de tool die overeenkomt met het verzoek, formuleert de aanroep met de juiste parameters en integreert vervolgens het resultaat in zijn antwoord. Geen van de drie interfaces maakt het model bekwaamer of minder bekwaam in het kiezen van een tool.

De verschillen liggen dus ergens anders: beknoptheid van de syntaxis, beschikbare randfuncties—verbose streaming op de xAI SDK, formaatcompatibiliteit op de Responses API, spraaksynthese op de Voice Agent—en de twee parameters die ontbreken in het OpenAI-formaat. Beslis op basis van deze criteria en u zit goed.

Belangrijkste punten

  • De native xAI SDK met mcp() is de eenvoudigste en meest complete methode
  • De Responses API (OpenAI-formaat) vergemakkelijkt migratie maar ondersteunt geen require_approval of connector_id
  • De Voice Agent API verbindt voice agents met MCP-tools
  • Het gedrag van MCP is in alle drie de gevallen identiek; alleen de syntaxis verandert
  • Kies op basis van uw bestaande stack en specifieke behoeften