Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Kompletní konfigurace MCP serveru

Lekce 7 z 12 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Všechno dohromady
  2. Nejjednodušší případ
  3. Interní server pouze pro čtení
  4. Komplexní konfigurace
  5. Kontrola před nasazením
  6. Klíčové poznatky

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é.

ParametrPovinnýÚloha
server_urlAnoHTTPS URL adresa MCP serveru
server_labelAnoPrefix pro volání nástrojů
server_descriptionNePomáhá modelu Grok při výběru serveru
allowed_tool_namesNeOmezuje přístupné nástroje
authorizationNeAutentizační token
headersNeDalší 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_url a server_label
  • Přidej server_description pro 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 authorization a headers
  • Obě SDK (nativní xAI i OpenAI Responses) přijímají stejné parametry, liší se pouze syntaxí