Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Godkendelse og headere

Lektion 6 af 12 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Bevis hvem der ringer
  2. Parameteren authorization
  3. headers og extra_headers
  4. En komplet produktionskonfiguration
  5. Vigtige pointer

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

  • authorization sender adgangstokenet til MCP-serveren via HTTP-headern Authorization
  • Gem altid dine tokens i miljøvariabler, aldrig hardcodet i koden
  • headers / extra_headers tilfø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