Godkendelse og headere
På denne side
Bevis hvem der ringer
DeepWiki og andre offentlige MCP-servere accepterer alle kaldere, hvilket stemmer overens med deres formål. Så snart du eksponerer dine egne værktøjer, ændrer situationen sig: uden godkendelse kan alle, der gætter URL’en, forespørge dit CRM eller udløse dine processer. xAI tilbyder to parametre til at håndtere dette: authorization til adgangstokenet og headers eller extra_headers til alt andet.
Parameteren authorization
Den sender et godkendelsestoken til MCP-serveren. Mere specifikt indsættes den streng, du angiver, nøjagtig som den er i HTTP-headern Authorization for hver anmodning, der sendes til den pågældende server.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-your-token-here"
)
Det forventede format afhænger helt af målserveren, da authorization accepterer enhver streng: det er MCP-serveren, der validerer den, ikke xAI. Tre former dækker næsten alle tilfælde, du vil støde på.
- Bearer-token:
"Bearer sk-xxxx"— den mest almindelige, brugt af flertallet af REST-API’er - API-nøgle:
"ApiKey your-key"— nogle tjenester bruger et brugerdefineret præfiks - Basic auth:
"Basic base64(user:password)"— grundlæggende godkendelse kodet i base64
Da dette token følger med hver anmodning, kræver håndteringen omhu. Hardcod aldrig tokenet i din kildekode: en hemmelighed skrevet i en versionsstyret fil ender før eller siden i et repository, en logfil eller et skærmbillede. Brug altid en miljøvariabel. Hvis serveren tillader det, så foretræk et scoped token, der kun åbner de værktøjer, du faktisk har brug for — dette er server-sidens modstykke til begrænsningen allowed_tool_names. Og planlæg for regelmæssig rotation, især i produktion, hvor et evigt token er et token, der før eller siden vil lække.
import os
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)
headers og extra_headers
Tokenet besvarer spørgsmålet “hvem er du”. Mange servere har brug for yderligere svar: for hvilken organisation, i hvilket miljø, med hvilken API-version. Disse oplysninger sendes via parameteren headers eller extra_headers, afhængigt af SDK’en.
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 mest almindelige tilfælde er multi-tenant-platforme, hvor det samme endpoint betjener flere klienter og stole på en header til at rute anmodningen til de rigtige data. Dernæst kommer API-versionering, med en header som "X-API-Version": "2024-01", der låser en specifik version og beskytter dig mod serverændringer. Nogle systemer forventer også sporingsmetadata — sessions-ID, agent-ID — for at spore oprindelsen af kald, eller headere til rate limiting, der bestemmer den anvendte betalingsplan.
Parameternavnet varierer afhængigt af den grænseflade, du bruger. Den native xAI SDK bruger headers i de fleste tilfælde; Responses API i OpenAI-format kan kræve extra_headers for at undgå kollision med headere, som denne SDK administrerer automatisk for sig selv. Adfærden er dog præcis den samme: headere tilføjes til hver anmodning til MCP-serveren. Hvis dine anmodninger sendes uden dine headere, så tjek først dette parameternavn, før du leder andre steder.
En komplet produktionskonfiguration
Her er hvordan disse parametre samles med dem fra tidligere lektioner i et realistisk internt server-scenarie.
from xai_sdk.tools import mcp
import os
tools = [
mcp(
server_url="https://api.monentreprise.com/mcp",
server_label="internal",
server_description="Interne værktøjer: CRM, dokumentation, 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"]
)
]
Denne konfiguration forbinder til den interne MCP-server over HTTPS, godkender med et Bearer-token gemt i en miljøvariabel, sender organisations-ID’et i en header og begrænser adgangen til tre læseoperationer. Bemærk, at hver linje låser et andet aspekt: kryptering beskytter transporten, tokenet beviser identiteten, headeren definerer dataomfanget, og allowlisten begrænser potentiel skade. Intet af disse lag erstatter de andre.
Vigtige pointer
authorizationsender adgangstokenet til MCP-serveren via HTTP-headern Authorization- Gem altid dine tokens i miljøvariabler, aldrig hardcodet i koden
headers/extra_headerstilføjer ekstra HTTP-headere til hver anmodning- Headere bruges til multi-tenant-identifikation, API-versionering og sporing
- Kombiner godkendelse og værktøjsbegrænsning for maksimal sikkerhed