Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Sažetak i praktična vježba

Lekcija 12 od 12 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Što smo pokrili
  2. Šest parametara ukratko
  3. Provjere prije odlaska u produkciju
  4. Tvoj prvi agent, u tri koraka
  5. Što ostaje istinito nakon ovog tečaja
  6. Ključne točke
  7. Provjeri svoje znanje

Š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

ParametarObaveznoFunkcija
server_urlDaHTTPS adresa MCP poslužitelja
server_labelDaJedinstveni identifikator, stavlja prefiks alatima
server_descriptionNeOpis prirodnim jezikom za vođenje Groka
allowed_tool_namesNePopis dopuštenih alata (allowlist)
authorizationNeToken za autentifikaciju (Bearer, API ključ)
headersNeDodatni 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.