Sažetak i praktična vježba
Na ovoj stranici
Što smo pokrili
Ovaj tečaj proveo te je od koncepta Model Context Protocola do konfiguracije spremne za produkciju. Ako zapamtiš samo jednu stvar, neka to bude ovo: MCP omogućuje Groku povezivanje s vanjskim poslužiteljima alata putem HTTPS-a, automatski otkrivajući i koristeći izložene alate bez ručne konfiguracije na strani klijenta.
Arhitektonski, četiri točke strukturiraju sve ostalo. Remote MCP radi isključivo putem HTTPS-a, što isključuje obični HTTP, localhost i stdio transport za lokalne poslužitelje. Podržana su dva transporta: moderni bezdržavni Streaming HTTP i trajni SSE, a poslužitelj diktira koji se koristi – ti ne biraš. Konačno, tri sučelja osiguravaju pristup ovom mehanizmu: izvorni xAI SDK (preporučeno), Responses API za kompatibilnost s OpenAIjem i Voice Agent API za glasovne agente.
Šest parametara ukratko
| Parametar | Obavezno | Funkcija |
|---|---|---|
server_url | Da | HTTPS adresa MCP poslužitelja |
server_label | Da | Jedinstveni identifikator, stavlja prefiks alatima |
server_description | Ne | Opis prirodnim jezikom za vođenje Groka |
allowed_tool_names | Ne | Popis dopuštenih alata (allowlist) |
authorization | Ne | Token za autentifikaciju (Bearer, API ključ) |
headers | Ne | Dodatni HTTP zaglavlja |
Dva obavezna, četiri opcionalna: to je cijela površina konfiguracije za remote MCP. Opcionalni nisu samo značajke za udobnost. allowed_tool_names rješava tvoju sigurnost, a server_description osigurava točan odabir kada koegzistira više poslužitelja.
Provjere prije odlaska u produkciju
Tri kategorije kontrola zahtijevaju eksplicitnu provjeru. Sigurnosno, osiguraj da URL-ovi koriste HTTPS s valjanim certifikatima, svaki interni poslužitelj ima svoj token za autentifikaciju, ti tokeni žive u varijablama okruženja, alati su ograničeni na nužni minimum, a redovita rotacija tokena je planirana, a ne samo poželjna.
Konfiguracijski, svaki poslužitelj mora imati jedinstvenu, opisnu oznaku server_label, a njegov server_description mora biti precizan i ažuran – opis koji se odnosi na stariju verziju poslužitelja zavodi model. Zadrži ukupan broj alata razumnim, oko deset do dvadeset po sesiji, i ukloni poslužitelje iz konfiguracije čije alate više nitko ne poziva.
S aspekta opservabilnosti, unaprijed planiraj incidente: praćenje poziva alatima u tvojim zapisnicima (logovima), alerte na pogreške MCP povezivanja, praćenje potrošnje tokena po poslužitelju i mjerenje latencije poziva. Potonje se često zanemaruje, iako predstavlja prvi signal degradacije poslužitelja.
Tvoj prvi agent, u tri koraka
Najbolji način da učvrstiš ovo gradivo je postupna izgradnja. Započni s javnim poslužiteljem, bez autentifikacije, kako bi potvrdio da mehanika radi od kraja do kraja.
from xai_sdk import Client
from xai_sdk.tools import mcp
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(
model="grok-4.20-0309-reasoning",
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
],
)
Testiraj zahtjevom koji stvarno prisiljava model da konzultira repozitorij, poput „objasni mi arhitekturu projekta fastapi/fastapi“. Ako odgovor stigne i citira stvarnu strukturu projekta, tvoja MCP veza je operativna.
Zatim dodaj izvorni alat kako bi vidio kako Grok arbitrirá između dva izvora različite prirode. Opis poslužitelja ovdje postaje koristan, upravo zato što sada postoji izbor koji treba napraviti.
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Dokumentacija za open-source GitHub projekte"
),
{"type": "web_search"},
]
Konačno, napravi korak prema internom poslužitelju, s autentifikacijom i ograničenjem alata. Ovo je korak u kojem sve što si vidio o sigurnosti postaje konkretno.
tools=[
mcp(server_url="https://mcp.deepwiki.com/mcp", server_label="deepwiki"),
mcp(
server_url="https://api.your-server.com/mcp",
server_label="internal",
server_description="Interni podaci i alati tvrtke",
authorization=f"Bearer {os.getenv('INTERNAL_TOKEN')}",
allowed_tool_names=["search", "get_document"]
),
{"type": "web_search"},
]
Što ostaje istinito nakon ovog tečaja
Četiri ograničenja pratit će sve tvoje MCP projekte s Grokom. Responses API u OpenAI formatu ne podržava ni require_approval ni connector_id, što te vraća na izvorni SDK kad god želiš ljudsku validaciju prije izvršenja. Stdio transport, a time i lokalni MCP poslužitelji, ostaju nedostižni: samo HTTPS. Svaki izloženi alat troši kontekst, čineći minimalizam arhitektonskom odlukom, a ne naknadnom razmišljanjem. Mrežna latencija se zbraja sa svakim pozivom, pa će agent koji lančano povezuje nekoliko MCP alata odgovarati sporije od agenta koji poziva samo jedan.
Nijedno od ovih ograničenja nije blokirajuće. Sva se zaobilaze dizajnerskim izborima donesenim s punim znanjem, što je upravo ono što ti je ovaj tečaj pružio.
Ključne točke
- Remote MCP povezuje Grok s vanjskim alatima putem HTTPS-a u nekoliko redaka konfiguracije
- Šest parametara dovoljno je za konfiguraciju MCP poslužitelja (dva obavezna, četiri opcionalna)
- Sigurnost počiva na trojstvu: HTTPS + autentifikacija + ograničenje alata
- Započni s javnim poslužiteljem (DeepWiki), zatim prijeđi na autentificirani višestruki poslužitelj
- Kombiniraj MCP i izvorne alate za stvaranje svestranih agenata
Provjeri svoje znanje
Remote MCP poslužitelji u Grok API-ju: zaslužio si ovaj sažetak.
1. Što omogućuje MCP podrška Grok API-ja?
Odgovor: Povezivanje udaljenih MCP poslužitelja kao alata modela: Grok poziva njihove mogućnosti tijekom generiranja – tvoji sustavi i MCP ekosustav postaju proširenja.
2. Kako deklariraš MCP poslužitelj u zahtjevu?
Odgovor: Putem server_url i server_label, s opisom i popisom ovlaštenih alata (allowlist) – te zaglavljima za autentifikaciju potrebnim za pristup.
3. Što omogućuje konfiguracija s više poslužitelja?
Odgovor: Kombiniranje više MCP poslužitelja u jednom zahtjevu – svaki označen – i njihovo miješanje s ugrađenim alatima (web, X): orkestracija ostaje na modelu.
4. Koji transporti su podržani?
Odgovor: Streaming HTTP i SSE – udaljeni transporti protokola: poslužitelj živi gdje ti želiš, API se povezuje s njim.
5. Koja su sigurnosna pravila za udaljene poslužitelje?
Odgovor: Autoriziraj samo potrebne alate, ozbiljno se autentificiraj i tretiraj odgovore poslužitelja kao podatke koje treba validirati – MCP poslužitelj treće strane je potencijalna napadna površina.
Deklariraj, ograniči, autentificiraj, kombiniraj: remote MCP proširuje Grok na tvoje sustave – prema tvojim pravilima.