Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Popolna konfiguracija strežnika MCP

Lekcija 7 od 12 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Vse skupaj
  2. Najpreprostejši primer
  3. Notranji strežnik samo za branje
  4. Celovita konfiguracija
  5. Preveri pred uvedbo
  6. Ključne ugotovitve

Vse skupaj

Vsak parameter si že spoznal ločeno. Ta lekcija jih združi v popolne konfiguracije, točno tako, kot jih boš zapisal v praksi, pri čemer vsakič prikaže enakovredno kodo v obeh glavnih SDK-jih. Cilj ni uvesti novih konceptov, temveč ti ponuditi vzorce, ki jih lahko neposredno prilagodiš.

Tukaj je pregled šestih parametrov z njihovo obveznostjo ali izbirnostjo.

ParameterObveznoVloga
server_urlDaHTTPS URL strežnika MCP
server_labelDaPredpona za klic orodij
server_descriptionNeUsmerja Grok pri izbiri strežnika
allowed_tool_namesNeOmeji dostopna orodja
authorizationNeAvtentikacijski žeton
headersNeDodatni glave HTTP

Najpreprostejši primer

Dva parametra zadostujeta, ko je strežnik javen in ne zahteva avtentikacije.

# 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"
}]

Točno to boš zapisal za DeepWiki. Grok ima nato dostop do vseh orodij strežnika, kar je tukaj sprejemljivo, saj gre za javno storitev samo za branje. Takoj ko strežnik pripada tvoji organizaciji, ta konfiguracija postane nezadostna.

Notranji strežnik samo za branje

Pojdimo korak višje: podjetniški CRM, ki ga mora agent lahko poizvedovati, nikoli pa spreminjati. Dodani so trije parametri, vsak iz drugačnega razloga – opis usmerja model, žeton dokazuje identiteto, seznam dovoljenih pa prepisuje pisanje.

# 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"]
}]

Primerjaj oba bloka: vsebina je enaka, spremeni se le ovojnica. Pomočnik mcp() sprejme imenovane argumente; format OpenAI pričakuje slovar z dodatnim ključem "type". To je edina razlika, ki si jo moraš zapomniti pri prevajanju konfiguracije iz enega SDK-ja v drugega.

Celovita konfiguracija

Zadnji korak združuje vseh šest parametrov v klicu xAI SDK-ja v realnem scenariju.

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"],
)

Opazi notranjo doslednost tega primera. Opis napoveduje dostop samo za branje, pet dovoljenih orodij pa so vse operacije poizvedb – ni protislovja med tem, kar model verjame, da lahko stori, in tem, kar konfiguracija dovoljuje. Glava X-Environment, nastavljena na production, prepreči testnemu agentu pisanje v žive podatke, X-Request-Source pa bo tvoje sledi na strežniku naredil uporabne, če boš moral izslediti izvor nepričakovanega zahtevka.

Preveri pred uvedbo

Šest točk zahteva pregled pred vsako uvedbo v proizvodno okolje in vsaka ustreza pasti, na katero si naletel prej v tem tečaju. URL mora biti HTTPS z veljavnim certifikatom, sicer nič ne bo delovalo. Oznaka mora ostati kratka, opisna in edinstvena znotraj konfiguracije. Opis se mora ujemati z dejansko izpostavljenimi orodji, sicer bo model poskušal klice, ki so obsojeni na neuspeh. Dovoljena orodja morajo biti zreducirana na strogi minimum. Žeton mora prihajati iz spremenljivke okolja, ne iz izvorne kode. Dodatne glave morajo biti točno tiste, ki jih tvoj strežnik pričakuje, s pravilno uporabo velikih in malih črk – napaka pri velikosti črk v X-Organization-Id povzroči tiho napako, ki jo je še posebej boleče diagnosticirati.

Ključne ugotovitve

  • Minimalna konfiguracija zahteva le server_url in server_label
  • Dodaj server_description za usmerjanje Groka, zlasti v nastavitvah z več strežniki
  • Omeji z allowed_tool_names zaradi varnosti in zmogljivosti
  • Uporabi authorization in headers za avtentikacijo
  • Ob SDK-ja (native xAI in OpenAI Responses) sprejemata iste parametre z drugačno sintakso