Autentisering och headrar
På denna sida
Bevisa vem som ringer
DeepWiki och andra offentliga MCP-servrar accepterar alla anropare, vilket stämmer överens med deras syfte. Så snart du exponerar dina egna verktyg förändras läget: utan autentisering kan alla som gissar URL:en fråga ditt CRM eller utlösa dina processer. xAI tillhandahåller två parametrar för att hantera detta – authorization för åtkomsttoken och headers eller extra_headers för allt annat.
Parametern authorization
Den skickar en autentiseringstoken till MCP-servern. Specifikt placeras strängen du anger exakt som den är i HTTP-headern Authorization för varje begäran som skickas till den servern.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-your-token-here"
)
Det förväntade formatet beror helt på målservern, eftersom authorization accepterar vilken sträng som helst: det är MCP-servern som validerar den, inte xAI. Tre former täcker nästan alla fall du kommer att stöta på.
- Bearer-token:
"Bearer sk-xxxx"– den vanligaste, används av majoriteten av REST-API:er - API-nyckel:
"ApiKey your-key"– vissa tjänster använder ett anpassat prefix - Basic auth:
"Basic base64(user:password)"– grundläggande autentisering kodad i base64
Eftersom denna token följer med varje begäran krävs noggrann hantering. Hardkoda den aldrig i din källkod: en hemlighet som skrivs i en versionshanterad fil hamnar förr eller senare i ett arkiv, en loggfil eller en skärmdump. Använd alltid en miljövariabel. Om servern tillåter det, föredra en token med begränsad behörighet som endast öppnar de verktyg du faktiskt behöver – detta är serverns motsvarighet till begränsningen allowed_tool_names. Planera också för regelbunden rotation, särskilt i produktion, där en evig token är en token som förr eller senare kommer att läcka.
import os
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)
headers och extra_headers
Token svarar på frågan “vem är du”. Många servrar behöver ytterligare svar: för vilken organisation, i vilken miljö, med vilken API-version. Denna information skickas via parametern headers, eller extra_headers beroende på 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"
}
)
Det vanligaste fallet är flerkundplattformar (multi-tenant), där samma slutpunkt betjänar flera kunder och förlitar sig på en header för att routa begäran till rätt data. Därefter kommer API-versionering, med en header som "X-API-Version": "2024-01" som låser en specifik version och skyddar dig mot serverändringar. Vissa system förväntar sig också spårningsmetadata – sessions-ID, agent-ID – för att spåra ursprunget till anrop, eller headrar för hastighetsbegränsning som avgör vilken faktureringsplan som tillämpas.
Parameterns namn varierar beroende på vilket gränssnitt du använder. Den nativa xAI SDK:n använder headers i de flesta fall; Responses API i OpenAI-format kan kräva extra_headers för att undvika kollisioner med headrar som denna SDK hanterar automatiskt själv. Beteendet är dock exakt detsamma: headrar läggs till i varje begäran till MCP-servern. Om dina begäranden skickas utan dina headrar, kontrollera detta parameternamn först innan du letar någon annanstans.
En komplett produktionskonfiguration
Så här sätts dessa parametrar ihop med dem från tidigare lektioner i ett realistiskt scenario med en intern 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"]
)
]
Denna konfiguration ansluter till den interna MCP-servern över HTTPS, autentiserar med en Bearer-token lagrad i en miljövariabel, skickar organisations-ID:t i en header och begränsar åtkomsten till tre läsåtgärder. Observera att varje rad låser en annan aspekt: kryptering skyddar transporten, token bevisar identiteten, headern definierar dataomfånget och allowlistan begränsar potentiell skada. Inget av dessa lager ersätter de andra.
Viktiga punkter
authorizationskickar åtkomsttoken till MCP-servern via HTTP-headern Authorization- Lagra alltid dina token i miljövariabler, aldrig hardkodade i koden
headers/extra_headerslägger till extra HTTP-headrar i varje begäran- Headrar används för identifiering av flerkundsmiljöer, API-versionering och spårning
- Kombinera autentisering och verktygsbegränsning för maximal säkerhet