Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Autentisering och headrar

Lektion 6 av 12 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Bevisa vem som ringer
  2. Parametern authorization
  3. headers och extra_headers
  4. En komplett produktionskonfiguration
  5. Viktiga punkter

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

  • authorization skickar åtkomsttoken till MCP-servern via HTTP-headern Authorization
  • Lagra alltid dina token i miljövariabler, aldrig hardkodade i koden
  • headers / extra_headers lä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