Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Authentifizierung und Header

Lektion 6 von 12 Aktualisiert am 29. Juli 2026 Entwickler
Auf dieser Seite
  1. Wer ruft auf? Nachweisen
  2. Der authorization-Parameter
  3. headers und extra_headers
  4. Eine vollständige Produktionskonfiguration
  5. Kernaussagen

Wer ruft auf? Nachweisen

DeepWiki und andere öffentliche MCP-Server akzeptieren jeden Aufrufer, was mit ihrem Zweck übereinstimmt. Sobald Sie jedoch Ihre eigenen Tools exponieren, ändert sich die Situation: Ohne Authentifizierung kann jede Person, die die URL errät, auf Ihr CRM zugreifen oder Ihre Prozesse auslösen. xAI stellt zwei Parameter bereit, um dies zu adressieren: authorization für den Zugriffstoken und headers bzw. extra_headers für alles Weitere.

Der authorization-Parameter

Dieser Parameter sendet einen Authentifizierungstoken an den MCP-Server. Konkret wird der von Ihnen bereitgestellte String unverändert im HTTP-Header Authorization jeder Anfrage an diesen Server platziert.

mcp(
    server_url="https://api.example.com/mcp",
    server_label="internal",
    authorization="Bearer sk-your-token-here"
)

Das erwartete Format hängt vollständig vom Zielserver ab, da authorization jeden String akzeptiert: Der MCP-Server validiert den Token, nicht xAI. Drei Formen decken fast alle Fälle ab, die Sie antreffen werden.

  • Bearer-Token: "Bearer sk-xxxx" – die häufigste Form, die von den meisten REST-APIs verwendet wird
  • API-Schlüssel: "ApiKey your-key" – einige Dienste verwenden einen eigenen Präfix
  • Basic-Auth: "Basic base64(user:password)" – eine in Base64 codierte Basisauthentifizierung

Da dieser Token mit jeder Anfrage mitgesendet wird, erfordert seine Handlung Sorgfalt. Codieren Sie ihn niemals hartcodiert in Ihrem Quellcode: Ein Geheimnis, das in einer versionierten Datei geschrieben steht, landet am Ende in einem Repository, einem Log oder einem Screenshot. Verwenden Sie stattdessen immer eine Umgebungsvariable. Wenn der Server dies zulässt, bevorzugen Sie einen eingeschränkten Token, der nur die Tools öffnet, die Sie tatsächlich benötigen – dies ist die serverseitige Entsprechung zur Einschränkung allowed_tool_names. Und planen Sie regelmäßige Rotationen ein, insbesondere in der Produktion, wo ein ewiger Token ein Token ist, der am Ende doch undicht wird.

import os

mcp(
    server_url="https://api.example.com/mcp",
    server_label="internal",
    authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)

headers und extra_headers

Der Token beantwortet die Frage „Wer sind Sie?”. Viele Server benötigen zusätzliche Antworten: Für welche Organisation, in welcher Umgebung, mit welcher API-Version. Diese Informationen werden über den Parameter headers oder extra_headers übermittelt, je nach 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"
    }
)

Der häufigste Fall sind Multi-Tenant-Plattformen, bei denen dieselbe Endpunkt mehrere Clients bedient und auf einen Header angewiesen ist, um die Anfrage an die richtigen Daten zu routen. Als Nächstes folgt die API-Versionierung mit einem Header wie "X-API-Version": "2024-01", der eine spezifische Version festlegt und Sie vor Serveränderungen schützt. Manche Systeme erwarten auch Tracking-Metadaten – Sitzungs-ID, Agenten-ID –, um den Ursprung der Aufrufe zu verfolgen, oder Rate-Limiting-Header, die den angewendeten Abrechnungsplan bestimmen.

Der Parametername variiert je nach Schnittstelle, die Sie verwenden. Das native xAI-SDK verwendet in den meisten Fällen headers; die OpenAI-format Responses-API kann extra_headers erfordern, um Kollisionen mit Headern zu vermeiden, die dieses SDK automatisch für sich selbst verwaltet. Das Verhalten ist jedoch exakt dasselbe: Header werden jeder Anfrage an den MCP-Server hinzugefügt. Wenn Ihre Anfragen ohne Ihre Header ausgehen, prüfen Sie zuerst diesen Parameternamen, bevor Sie anderswo suchen.

Eine vollständige Produktionskonfiguration

Hier sehen Sie, wie diese Parameter mit denen aus den vorherigen Lektionen in einem realistischen Fall eines internen Servers zusammengefügt werden.

from xai_sdk.tools import mcp
import os

tools = [
    mcp(
        server_url="https://api.monentreprise.com/mcp",
        server_label="internal",
        server_description="Interne Tools: 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"]
    )
]

Diese Konfiguration verbindet sich über HTTPS mit dem internen MCP-Server, authentifiziert sich mit einem Bearer-Token, der in einer Umgebungsvariablen gespeichert ist, sendet die Organisations-ID in einem Header und beschränkt den Zugriff auf drei Leseoperationen. Beachten Sie, dass jede Zeile einen anderen Aspekt absichert: Verschlüsselung schützt die Übertragung, der Token beweist die Identität, der Header definiert den Datenbereich und die Whitelist begrenzt das potenzielle Schadensausmaß. Keine dieser Ebenen ersetzt die anderen.

Kernaussagen

  • authorization sendet den Zugriffstoken an den MCP-Server über den HTTP-Header Authorization
  • Speichern Sie Ihre Token immer in Umgebungsvariablen, niemals hartcodiert im Code
  • headers / extra_headers fügen zusätzliche HTTP-Header jeder Anfrage hinzu
  • Header dienen der Identifikation in Multi-Tenant-Umgebungen, der API-Versionierung und dem Tracking
  • Kombinieren Sie Authentifizierung und Tool-Beschränkung für maximale Sicherheit