Popolna konfiguracija strežnika MCP
Na tej strani
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.
| Parameter | Obvezno | Vloga |
|---|---|---|
server_url | Da | HTTPS URL strežnika MCP |
server_label | Da | Predpona za klic orodij |
server_description | Ne | Usmerja Grok pri izbiri strežnika |
allowed_tool_names | Ne | Omeji dostopna orodja |
authorization | Ne | Avtentikacijski žeton |
headers | Ne | Dodatni 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_urlinserver_label - Dodaj
server_descriptionza usmerjanje Groka, zlasti v nastavitvah z več strežniki - Omeji z
allowed_tool_nameszaradi varnosti in zmogljivosti - Uporabi
authorizationinheadersza avtentikacijo - Ob SDK-ja (native xAI in OpenAI Responses) sprejemata iste parametre z drugačno sintakso