Authenticatie en headers
Op deze pagina
Bewijs wie er belt
DeepWiki en andere openbare MCP-servers accepteren elke beller, wat strookt met hun doel. Zodra u echter uw eigen tools exposeert, verandert de situatie: zonder authenticatie kan iedereen die de URL raadt uw CRM bevragen of uw processen activeren. xAI biedt twee parameters om dit op te lossen: authorization voor de toegangstoken, en headers of extra_headers voor al het andere.
De parameter authorization
Deze parameter verzendt een authenticatietoken naar de MCP-server. Concreet wordt de string die u opgeeft letterlijk geplaatst in de HTTP Authorization-header van elk verzoek dat naar die server wordt verzonden.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-your-token-here"
)
Het verwachte formaat hangt volledig af van de doelserver, omdat authorization elke string accepteert: de MCP-server valideert deze, niet xAI. Drie vormen dekken bijna alle gevallen die u zult tegenkomen.
- Bearer-token:
"Bearer sk-xxxx"— de meest voorkomende, gebruikt door de meeste REST-API’s - API-sleutel:
"ApiKey your-key"— sommige diensten gebruiken een aangepast voorvoegsel - Basisauthenticatie:
"Basic base64(user:password)"— basisauthenticatie gecodeerd in base64
Omdat dit token bij elk verzoek wordt meegestuurd, vereist de behandeling ervan zorgvuldigheid. Hardcode het nooit in uw broncode: een geheim dat in een versiebeheerd bestand staat, belandt uiteindelijk in een repository, een logboek of een screenshot. Gebruik altijd een omgevingsvariabele. Als de server dit toelaat, geef dan de voorkeur aan een token met beperkte reikwijdte dat alleen de tools opent die u daadwerkelijk nodig hebt; dit is het tegenhanger aan de serverzijde van de allowed_tool_names-beperking. Voorzie ook regelmatige rotatie, vooral in productie, waar een eeuwigdurend token een token is dat uiteindelijk zal lekken.
import os
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)
headers en extra_headers
Het token beantwoordt de vraag “wie bent u”. Veel servers hebben aanvullende antwoorden nodig: voor welke organisatie, in welke omgeving, met welke API-versie. Deze informatie wordt doorgegeven via de parameter headers, of extra_headers afhankelijk van de SDK.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-token",
headers={
"X-Organization-Id": "org-123",
"X-Project-Id": "proj-456"
}
)
De meest voorkomende casus betreft multi-tenant platformen, waar hetzelfde eindpunt meerdere clients bedient en vertrouwt op een header om het verzoek naar de juiste gegevens te routeren. Daarna volgt API-versionering, met een header zoals "X-API-Version": "2024-01" die een specifieke versie vastpint en u beschermt tegen serverwijzigingen. Sommige systemen verwachten ook traceer-metadata—sessie-ID, agent-ID—om de oorsprong van oproepen te traceren, of headers voor snelheidsbeperking die het toegepaste facturatieplan bepalen.
De naam van de parameter varieert afhankelijk van de interface die u gebruikt. De native xAI SDK gebruikt in de meeste gevallen headers; de Responses API in OpenAI-formaat vereist mogelijk extra_headers om botsingen te voorkomen met headers die deze SDK automatisch voor zichzelf beheert. Het gedrag is echter exact hetzelfde: headers worden toegevoegd aan elk verzoek naar de MCP-server. Als uw verzoeken vertrekken zonder uw headers, controleer dan eerst deze parameternaam voordat u elders gaat zoeken.
Een volledige productieconfiguratie
Hier ziet u hoe deze parameters samenkomen met die uit eerdere lessen, in een realistisch geval van een interne server.
from xai_sdk.tools import mcp
import os
tools = [
mcp(
server_url="https://api.monentreprise.com/mcp",
server_label="internal",
server_description="Internal tools: CRM, documentation, tickets",
authorization=f"Bearer {os.getenv('INTERNAL_MCP_TOKEN')}",
headers={
"X-Organization-Id": os.getenv("ORG_ID"),
"X-Environment": "production"
},
allowed_tool_names=["search_docs", "get_ticket", "search_contacts"]
)
]
Deze configuratie verbindt met de interne MCP-server via HTTPS, authenticeert met een Bearer-token dat in een omgevingsvariabele is opgeslagen, verzendt de organisatie-ID in een header en beperkt de toegang tot drie leesbewerkingen. Merk op dat elke regel een ander aspect vergrendelt: encryptie beschermt het transport, het token bewijst de identiteit, de header definieert het databereik en de toegestane lijst beperkt potentiële schade. Geen van deze lagen vervangt de andere.
Belangrijkste punten
authorizationverzendt de toegangstoken naar de MCP-server via de HTTP Authorization-header- Bewaar uw tokens altijd in omgevingsvariabelen, nooit hardgecodeerd in de code
headers/extra_headersvoegen extra HTTP-headers toe aan elk verzoek- Headers dienen voor multi-tenant identificatie, API-versionering en tracering
- Combineer authenticatie en tool-beperking voor maximale beveiliging