Kompletní konfigurace MCP serveru
Na této stránce
Všechno dohromady
S jednotlivými parametry ses už seznámil. Tato lekce je spojí do kompletních konfigurací přesně tak, jak je budeš psát v praxi, a pokaždé ukáže ekvivalent pro obě hlavní SDK. Cílem není zavádět nové koncepty, ale poskytnout ti vzory, které můžeš přímo adaptovat.
Zde je přehled šesti parametrů včetně informace, zda jsou povinné, nebo volitelné.
| Parametr | Povinný | Úloha |
|---|---|---|
server_url | Ano | HTTPS URL adresa MCP serveru |
server_label | Ano | Prefix pro volání nástrojů |
server_description | Ne | Pomáhá modelu Grok při výběru serveru |
allowed_tool_names | Ne | Omezuje přístupné nástroje |
authorization | Ne | Autentizační token |
headers | Ne | Další HTTP hlavičky |
Nejjednodušší případ
Když je server veřejný a nevyžaduje autentizaci, stačí dva parametry.
# xAI SDK
tools = [mcp(server_url="https://mcp.deepwiki.com/mcp", server_label="deepwiki")]
# Responses API (OpenAI)
tools = [{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki"
}]
Přesně takto budeš postupovat u DeepWiki. Grok pak má přístup ke všem nástrojům serveru, což je zde přijatelné, protože jde o veřejnou službu pouze pro čtení. Jakmile však server patří tvé organizaci, tato konfigurace přestává stačit.
Interní server pouze pro čtení
Pojďme o krok dál: podnikové CRM, které musí agent umět dotazovat, ale nikdy do něj nesmí zapisovat. Přibývají tři parametry, každý z jiného důvodu – popis naviguje model, token prokazuje identitu a seznam povolených nástrojů zakazuje zápisy.
# xAI SDK
tools = [
mcp(
server_url="https://api.monentreprise.com/mcp",
server_label="crm",
server_description="Internal CRM. Contact and company lookup only.",
authorization=f"Bearer {os.getenv('CRM_TOKEN')}",
allowed_tool_names=["search_contacts", "get_contact", "list_companies"]
)
]
# Responses API (OpenAI)
tools = [{
"type": "mcp",
"server_url": "https://api.monentreprise.com/mcp",
"server_label": "crm",
"server_description": "Internal CRM. Contact and company lookup only.",
"authorization": f"Bearer {os.getenv('CRM_TOKEN')}",
"allowed_tool_names": ["search_contacts", "get_contact", "list_companies"]
}]
Porovnej oba bloky: obsah je totožný, mění se pouze obal. Pomocná funkce mcp() přijímá pojmenované argumenty, zatímco formát OpenAI očekává slovník s dodatečným klíčem "type". To je jediný rozdíl, na který si musíš při převodu konfigurace mezi SDK pamatovat.
Komplexní konfigurace
Poslední krok: kombinace všech šesti parametrů v reálném volání xAI SDK.
import os
from xai_sdk import Client
from xai_sdk.tools import mcp
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(
model="grok-4.20-0309-reasoning",
tools=[
mcp(
server_url="https://tools.monentreprise.com/v1/mcp",
server_label="outils-internes",
server_description="Internal tools platform: document management, support tickets, knowledge base. Read-only access.",
authorization=f"Bearer {os.getenv('TOOLS_MCP_TOKEN')}",
headers={
"X-Organization-Id": os.getenv("ORG_ID"),
"X-Environment": "production",
"X-Request-Source": "grok-agent"
},
allowed_tool_names=[
"search_documents",
"get_document",
"search_tickets",
"get_ticket",
"search_knowledge_base"
]
)
],
include=["verbose_streaming"],
)
Všimni si vnitřní konzistence tohoto příkladu. Popis avizuje přístup pouze pro čtení a všech pět povolených nástrojů jsou operace dotazování – žádný rozpor mezi tím, co si model myslí, že může dělat, a tím, co konfigurace umožňuje. Hlavička X-Environment nastavená na production zabraňuje testovacímu agentovi v zápisu do ostrých dat a X-Request-Source zajistí, že stopy na serveru budou vypovídací, pokud budeš muset dohledat původ neočekávaného požadavku.
Kontrola před nasazením
Před jakýmkoli nasazením do produkce si ověř šest bodů, z nichž každý odpovídá úskalí, se kterým ses v tomto kurzu již setkal. URL adresa musí být HTTPS s platným certifikátem, jinak nic neprojde. Štítek musí zůstat krátký, výstižný a v rámci konfigurace jedinečný. Popis musí odpovídat skutečně exponovaným nástrojům, jinak se model pokusí o volání, která jsou odsouzena k selhání. Povolené nástroje musí být redukovány na nezbytné minimum. Token musí pocházet z proměnné prostředí, nikoliv ze zdrojového kódu. A další hlavičky musí přesně odpovídat tomu, co tvůj server očekává, včetně správného rozlišení velkých a malých písmen – chyba v casingu u X-Organization-Id způsobí tiché selhání, které se obzvlášť těžko diagnostikuje.
Klíčové poznatky
- Minimální konfigurace vyžaduje pouze
server_urlaserver_label - Přidej
server_descriptionpro navigaci modelu Grok, zejména při práci s více servery - Pro bezpečnost a výkon omez přístup pomocí
allowed_tool_names - K autentizaci použij
authorizationaheaders - Obě SDK (nativní xAI i OpenAI Responses) přijímají stejné parametry, liší se pouze syntaxí