Ověření totožnosti a hlavičky
Na této stránce
Dokaž, kdo volá
DeepWiki a další veřejné servery MCP přijímají jakéhokoli volajícího, což odpovídá jejich účelu. Jakmile však zpřístupníš své vlastní nástroje, situace se mění: bez ověření může kdokoli, kdo uhodne URL, dotazovat tvé CRM nebo spouštět tvé procesy. xAI poskytuje dva parametry k řešení této situace – authorization pro přístupový token a headers nebo extra_headers pro vše ostatní.
Parametr authorization
Tento parametr odesílá ověřovací token na server MCP. Konkrétně znamená, že řetězec, který uvedeš, je vložen tak, jak je, do HTTP hlavičky Authorization u každého požadavku odeslaného na tento server.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-your-token-here"
)
Očekávaný formát závisí výhradně na cílovém serveru, protože authorization přijímá jakýkoli řetězec: validaci provádí server MCP, nikoli xAI. Tři formy pokrývají téměř všechny případy, se kterými se setkáš.
- Bearer token:
"Bearer sk-xxxx"– nejběžnější, používaný většinou REST API - API klíč:
"ApiKey your-key"– některé služby používají vlastní prefix - Basic auth:
"Basic base64(user:password)"– základní ověření kódované v base64
Protože je tento token součástí každého požadavku, vyžaduje jeho zpracování opatrnost. Nikdy ho neukládej přímo do zdrojového kódu: tajný údaj zapsaný ve verzovaném souboru se dříve či později ocitne v repozitáři, logu nebo na screenshotu. Vždy používej proměnnou prostředí. Pokud to server umožňuje, upřednostni token s omezeným rozsahem (scoped token), který otevírá pouze nástroje, které skutečně potřebuješ – toto je serverová obdoba omezení allowed_tool_names. A naplánuj si pravidelnou rotaci, zejména v produkčním prostředí, kde je věčný token tokenem, který dříve či později unikne.
import os
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)
headers a extra_headers
Token odpovídá na otázku „kdo jsi“. Mnoho serverů potřebuje další odpovědi: pro kterou organizaci, v jakém prostředí, s jakou verzí API. Tyto informace se předávají prostřednictvím parametru headers, nebo extra_headers v závislosti na použitém 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"
}
)
Nejběžnějším případem jsou multi-tenant platformy, kde stejný koncový bod obsluhuje více klientů a spoléhá na hlavičku pro směrování požadavku ke správným datům. Dalším případem je verzování API, kde hlavička jako "X-API-Version": "2024-01" připne konkrétní verzi a chrání tě před změnami na serveru. Některé systémy také očekávají metadata pro sledování – ID relace, ID agenta – pro vystopování původu volání, nebo hlavičky pro omezování rychlosti (rate limiting), které určují uplatňovaný tarifní plán.
Název parametru se liší v závislosti na rozhraní, které používáš. Natívní xAI SDK používá ve většině případů headers; Responses API ve formátu OpenAI může vyžadovat extra_headers, aby se předešlo jakékoli kolizi s hlavičkami, které toto SDK spravuje automaticky pro sebe. Chování je však přesně stejné: hlavičky jsou přidány ke každému požadavku na server MCP. Pokud jsou tvé požadavky odesílány bez tvých hlaviček, zkontroluj nejprve název tohoto parametru, než budeš hledat jinde.
Kompletní produkční konfigurace
Zde je ukázka, jak se tyto parametry skládají s těmi z předchozích lekcí v realistickém případě interního serveru.
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"]
)
]
Tato konfigurace se připojuje k internímu serveru MCP přes HTTPS, ověřuje se pomocí Bearer tokenu uloženého v proměnné prostředí, odesílá ID organizace v hlavičce a omezuje přístup na tři operace čtení. Všimni si, že každý řádek uzamyká jiný aspekt: šifrování chrání přenos, token prokazuje identitu, hlavička definuje rozsah dat a seznam povolených nástrojů omezuje potenciální škody. Žádná z těchto vrstev nenahrazuje tu druhou.
Klíčové poznatky
authorizationodesílá přístupový token na server MCP prostřednictvím HTTP hlavičky Authorization- Své tokeny vždy ukládej do proměnných prostředí, nikdy je neukládej přímo do kódu
headers/extra_headerspřidávají ke každému požadavku další HTTP hlavičky- Hlavičky slouží k identifikaci v multi-tenant prostředí, verzování API a sledování
- Pro maximální bezpečnost kombinuj ověření totožnosti a omezení nástrojů