Potpuna konfiguracija MCP poslužitelja
Na ovoj stranici
Sastavljanje cjeline
Upoznao si svaki parametar zasebno. Ova lekcija spaja ih u potpune konfiguracije, točno onako kako ćeš ih pisati u praksi, pri čemu svaki put prikazujemo ekvivalent u oba glavna SDK-a. Cilj nije uvesti nove koncepte, već ti dati obrasce koje možeš izravno prilagoditi.
Evo pregleda šest parametara, s naznakom jesu li obavezni ili neobavezni.
| Parametar | Obavezno | Uloga |
|---|---|---|
server_url | Da | HTTPS URL MCP poslužitelja |
server_label | Da | Prefiks za pozive alata |
server_description | Ne | Vodi Grok pri odabiru poslužitelja |
allowed_tool_names | Ne | Ograničava dostupne alate |
authorization | Ne | Token za autentifikaciju |
headers | Ne | Dodatni HTTP zaglavlja |
Najjednostavniji slučaj
Dva parametra su dovoljna kada je poslužitelj javan i ne zahtijeva autentifikaciju.
# 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 ćeš ovako pisati za DeepWiki. Grok tada ima pristup svim alatima poslužitelja, što je ovdje prihvatljivo jer se radi o javnoj usluzi samo za čitanje. Čim poslužitelj pripada tvojoj organizaciji, ova konfiguracija postaje nedovoljna.
Interni poslužitelj samo za čitanje
Prijeđimo na višu razinu: korporativni CRM kojemu agent mora moći postavljati upite, ali ga nikada ne smije mijenjati. Dodaju se tri parametra, svaki iz posebnog razloga – opis vodi model, token dokazuje identitet, a popis dopuštenih zabranjuje pisanje.
# xAI SDK
tools = [
mcp(
server_url="https://api.monentreprise.com/mcp",
server_label="crm",
server_description="Interni CRM. Samo pretraživanje kontakata i tvrtki.",
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": "Interni CRM. Samo pretraživanje kontakata i tvrtki.",
"authorization": f"Bearer {os.getenv('CRM_TOKEN')}",
"allowed_tool_names": ["search_contacts", "get_contact", "list_companies"]
}]
Usporedi ova dva bloka: sadržaj je identičan; mijenja se samo omotač. Pomoćna funkcija mcp() prima imenovane argumente; OpenAI format očekuje rječnik s dodatnim ključem "type". To je jedina razlika koje se trebaš sjetiti pri prevođenju konfiguracije s jednog SDK-a na drugi.
Sveobuhvatna konfiguracija
Završni korak, sa svih šest parametara kombiniranih u pozivu stvarnog svijeta xAI SDK-u.
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="Platforma internih alata: upravljanje dokumentima, tiketi za podršku, baza znanja. Pristup samo za čitanje.",
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"],
)
Primijeti unutarnju dosljednost ovog primjera. Opis najavljuje pristup samo za čitanje, a pet dopuštenih alata su sve operacije upita – nema kontradikcije između onoga što model vjeruje da može učiniti i onoga što konfiguracija dopušta. Zaglavlje X-Environment postavljeno na production sprječava testnog agenta da piše u žive podatke, a X-Request-Source učinit će tvoje tragove na poslužitelju djelotvornima ako budeš trebao otkriti odakle potječe neočekivani zahtjev.
Provjera prije implementacije
Šest točaka zahtijeva pregled prije bilo kakve implementacije u proizvodnju, a svaka odgovara zamci na koju si naišao ranije u ovom tečaju. URL mora biti HTTPS s valjanim certifikatom, inače ništa neće proći. Oznaka mora ostati kratka, opisna i jedinstvena unutar konfiguracije. Opis mora odgovarati stvarno izloženim alatima, inače će model pokušati pozive osuđene na neuspjeh. Dopušteni alati moraju biti svedeni na strogi minimum. Token mora dolaziti iz varijable okruženja, a ne iz izvornog koda. A dodatna zaglavlja moraju biti točno onakva kakva tvoj poslužitelj očekuje, s ispravnim velikim i malim slovima – pogreška u veličini slova na X-Organization-Id proizvodi tihi neuspjeh koji je posebno bolno dijagnosticirati.
Ključne točke
- Minimalna konfiguracija zahtijeva samo
server_urliserver_label - Dodaj
server_descriptionza vođenje Groka, posebno u postavkama s više poslužitelja - Ograniči pomoću
allowed_tool_namesradi sigurnosti i performansi - Koristi
authorizationiheadersza autentifikaciju - Oba SDK-a (izvorni xAI i OpenAI Responses) prihvaćaju iste parametre s različitim sintaksama