Samenvatting en praktische oefening
Op deze pagina
Wat we hebben behandeld
Deze cursus heeft u van het concept Model Context Protocol naar een productieklare configuratie geleid. Als u maar één ding onthoudt, laat het dan dit zijn: met MCP kan Grok via HTTPS verbinding maken met externe tool-servers, waarbij beschikbare tools automatisch worden ontdekt en gebruikt zonder handmatige configuratie aan de clientzijde.
Architecturaal wordt alles door vier punten gestructureerd. Remote MCP werkt uitsluitend via HTTPS, wat plain HTTP, localhost en stdio-transport voor lokale servers uitsluit. Er worden twee transports ondersteund: het moderne stateless Streaming HTTP en het persistente SSE; de server bepaalt welke van de twee wordt gebruikt, niet u. Tot slot bieden drie interfaces toegang tot dit mechanisme: de native xAI SDK (aanbevolen), de Responses API voor compatibiliteit met OpenAI, en de Voice Agent API voor voice-agents.
De zes parameters in één oogopslag
| Parameter | Verplicht | Functie |
|---|---|---|
server_url | Ja | HTTPS-adres van de MCP-server |
server_label | Ja | Unieke identificatie, prefix voor tools |
server_description | Nee | Beschrijving in natuurlijke taal om Grok te sturen |
allowed_tool_names | Nee | Toegestane lijst (allowlist) van beschikbare tools |
authorization | Nee | Authenticatietoken (Bearer, API-sleutel) |
headers | Nee | Aanvullende HTTP-headers |
Twee verplicht, vier optioneel: dat is het volledige configuratieoppervlak voor remote MCP. De optionele parameters zijn echter niet louter comfortfuncties. allowed_tool_names regelt uw beveiliging en server_description zorgt voor een accurate selectie wanneer meerdere servers naast elkaar bestaan.
Controles voordat u naar productie gaat
Drie categorieën controles vereisen expliciete verificatie. Wat beveiliging betreft: zorg ervoor dat URL’s HTTPS gebruiken met geldige certificaten, dat elke interne server zijn eigen authenticatietoken heeft, dat deze tokens in omgevingsvariabelen staan, dat tools beperkt zijn tot het noodzakelijke minimum en dat regelmatige token-rotatie gepland is in plaats van gehoopt.
Wat configuratie betreft: elke server moet een uniek, beschrijvend server_label hebben en de server_description moet nauwkeurig en actueel zijn; een beschrijving die verwijst naar een eerdere serverversie misleidt het model. Houd het totale aantal tools beperkt, ongeveer tien tot twintig per sessie, en verwijder servers uit de configuratie waarvan de tools niet meer worden aangeroepen.
Wat observability betreft: bereid incidenten vooraf voor: traceer tool-aanroepen in uw logs, stel alerts in op MCP-verbindingsfouten, volg het tokengebruik per server op en meet de call-latentie. Dit laatste wordt vaak verwaarloosd, terwijl het het eerste signaal is van een verslechterende server.
Uw eerste agent, in drie stappen
De beste manier om deze cursus te consolideren, is door geleidelijk op te bouwen. Begin met een openbare server, zonder authenticatie, om te valideren dat de mechaniek end-to-end werkt.
from xai_sdk import Client
from xai_sdk.tools import mcp
import os
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",
server_label="deepwiki"
)
],
)
Test met een verzoek dat het model dwingt de repository te raadplegen, zoals “leg me de architectuur van het fastapi/fastapi-project uit”. Als het antwoord binnenkomt en de daadwerkelijke projectstructuur citeert, is uw MCP-verbinding operationeel.
Voeg vervolgens een native tool toe om te zien hoe Grok arbitreert tussen twee bronnen van verschillende aard. De serverbeschrijving wordt hier nuttig, juist omdat er nu een keuze gemaakt moet worden.
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Documentatie voor open-source GitHub-projecten"
),
{"type": "web_search"},
]
Neem tot slot de stap naar een interne server, met authenticatie en tool-beperking. Dit is de stap waarin alles wat u over beveiliging heeft gezien concreet wordt.
tools=[
mcp(server_url="https://mcp.deepwiki.com/mcp", server_label="deepwiki"),
mcp(
server_url="https://api.your-server.com/mcp",
server_label="internal",
server_description="Interne gegevens en tools van het bedrijf",
authorization=f"Bearer {os.getenv('INTERNAL_TOKEN')}",
allowed_tool_names=["search", "get_document"]
),
{"type": "web_search"},
]
Wat na deze cursus waar blijft
Vier beperkingen zullen al uw MCP-projecten met Grok begeleiden. De Responses API in OpenAI-indeling ondersteunt noch require_approval noch connector_id, wat u terugbrengt naar de native SDK wanneer u menselijke validatie vóór uitvoering wilt. Stdio-transport, en dus lokale MCP-servers, blijft buiten bereik: alleen HTTPS. Elke blootgestelde tool verbruikt context, waardoor minimalisme een architecturale beslissing wordt in plaats van een nagedachte toevoeging. En netwerkwachttijd telt op bij elke aanroep, dus een agent die meerdere MCP-tools ketent, zal langzamer reageren dan een agent die er slechts één aanroept.
Geen van deze beperkingen zijn blokkades. Allemaal worden ze omzeild door ontwerpprincipes die met volledige kennis van zaken zijn genomen, wat precies is wat deze cursus u heeft geboden.
Belangrijkste punten
- Remote MCP verbindt Grok via HTTPS met externe tools in enkele configuratieregels
- Zes parameters volstaan om een MCP-server te configureren (twee verplicht, vier optioneel)
- Beveiliging rust op het trio HTTPS + authenticatie + tool-beperking
- Begin met een openbare server (DeepWiki) en ga vervolgens over naar geverifieerde multi-server-opstellingen
- Combineer MCP en native tools om veelzijdige agents te creëren
Test uw kennis
Remote MCP-servers in de Grok API: u heeft deze samenvatting verdiend.
1. Wat maakt de MCP-ondersteuning van de Grok API mogelijk?
Antwoord: Externe MCP-servers verbinden als modeltools: Grok roept hun mogelijkheden aan tijdens de generatie; uw systemen en het MCP-ecosysteem worden extensies.
2. Hoe declareert u een MCP-server in een verzoek?
Antwoord: Via server_url en server_label, met beschrijving en een toegestane lijst (allowlist) van geautoriseerde tools – en de authenticatie-headers die voor toegang vereist zijn.
3. Wat maakt multi-server-configuratie mogelijk?
Antwoord: Meerdere MCP-servers combineren in één verzoek – elk gelabeld – en ze mengen met ingebouwde tools (web, X): de orchestratie blijft bij het model.
4. Welke transports worden ondersteund?
Antwoord: Streaming HTTP en SSE – de remote transports van het protocol: de server staat waar u wilt, de API verbindt ermee.
5. Welke beveiligingsregels gelden voor remote servers?
Antwoord: Autoriseer alleen noodzakelijke tools, authenticeer serieus en behandel serverantwoorden als gegevens die gevalideerd moeten worden; een MCP-server van derden is een potentieel aanvalsoppervlak.
Declareren, beperken, authenticeren, combineren: remote MCP breidt Grok uit naar uw systemen – volgens uw regels.