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

DeepWiki i prilagođeni alati

Lekcija 9 od 12 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. DeepWiki: Javni poslužitelj za vježbu
  2. Prelazak na vlastite poslužitelje
  3. Javni i interni poslužitelji u istoj sesiji
  4. Ključne točke

DeepWiki: Javni poslužitelj za vježbu

Sve što si dosad vidio ostaje apstraktno dok ne spojiš stvarni poslužitelj. DeepWiki je idealan kandidat za ovaj prvi test: izlaže javni MCP poslužitelj na adresi https://mcp.deepwiki.com/mcp, bez autentifikacije, koji omogućuje pristup dokumentaciji za bilo koji GitHub projekt.

Konfiguracija zahtijeva samo nekoliko redaka jer je jedini opcionalni parametar koji ovdje doista ima smisla opis.

from xai_sdk.tools import mcp

tools = [
    mcp(
        server_url="https://mcp.deepwiki.com/mcp",
        server_label="deepwiki",
        server_description="Documentation for open-source GitHub projects. Search and view code, READMEs, guides."
    )
]

Kada se ta veza uspostavi, postavi Groku pitanja koja doista zahtijevaju čitanje repozitorija: „objasni kako funkcionira usmjeravanje u projektu facebook/react“, „koje su mogućnosti konfiguracije za vercel/next.js?“ ili „prikaži mi strukturu projekta langchain-ai/langchain“. Model poziva DeepWiki alate, dohvaća dokumentaciju i izvorni kod, a zatim sintetizira strukturirani odgovor. Usporedi taj odgovor s onim što bi dobio bez MCP poslužitelja: razlika između onoga što model zna i onoga što je upravo pročitao odmah je očita.

Prelazak na vlastite poslužitelje

DeepWiki je izvrsno poligon za vježbu, no stvarna vrijednost MCP-a pojavljuje se kada poslužitelj izlaže ono što nitko drugi ne može: tvoje podatke, tvoje procese, tvoje poslovne alate.

Tehnički gledano, MCP poslužitelj je web-aplikacija koja odgovara na dvije vrste zahtjeva. Prvo otkrivanje: kada se Grok spoji, traži popis dostupnih alata s njihovim shemama. Zatim izvršenje: kada model odluči pozvati alat, prenosi naziv alata i njegove argumente, a zatim čeka rezultat. Poslužitelj mora izložiti HTTPS krajnju točku usklađenu s MCP protokolom, koristeći Streaming HTTP ili SSE – dva prijenosna protokola obrađena na početku tečaja.

Ono što prilagođeni poslužitelj čini zanimljivim nije tehnika, već izbor alata koje objavljuje. Evo tri primjera koherentne podjele, gdje svaki poslužitelj pokriva jednu domenu i samo jednu:

Server "analytics":
  - get_dashboard_metrics: metrike nadzorne ploče
  - query_events: upit za analitičke događaje
  - get_funnel_report: izvještaj o lijevku konverzije

Server "content":
  - search_articles: pretraživanje unutar CMS-a
  - get_article: dohvat cijelog članka
  - list_categories: popis kategorija sadržaja

Server "devops":
  - get_deploy_status: status posljednjeg implementiranja
  - list_alerts: aktivni alerti nadzora
  - get_service_health: zdravstveno stanje određene usluge

Ova podjela po domenama nije samo za show: omogućuje ti razvrstavanje autentifikacije i ograničenja poslužitelja po pojedinačnom poslužitelju, umjesto primjene jednog pravila na mješavinu heterogenih alata. Kada tvoj poslužitelj bude implementiran, veza slijedi točno obrazac iz DeepWikija, uz dodatak tokena i popisa dopuštenih alata (allowlist).

tools = [
    mcp(
        server_url="https://mcp.yourcompany.com/analytics",
        server_label="analytics",
        server_description="Analytics metrics and reports. Dashboards, funnels, events.",
        authorization=f"Bearer {os.getenv('ANALYTICS_TOKEN')}",
        allowed_tool_names=["get_dashboard_metrics", "query_events"]
    )
]

Javni i interni poslužitelji u istoj sesiji

Konfiguracije postaju doista zanimljive kada pomiješaš obje obitelji jer model tada može povezati javni izvor s izvorom koji imaš samo ti.

tools = [
    # Public server for open-source documentation
    mcp(
        server_url="https://mcp.deepwiki.com/mcp",
        server_label="deepwiki",
        server_description="Documentation for open-source GitHub projects"
    ),
    # Internal server for product documentation
    mcp(
        server_url="https://docs.yourcompany.com/mcp",
        server_label="internal-docs",
        server_description="Internal technical documentation, architecture guides, ADRs",
        authorization=f"Bearer {os.getenv('DOCS_TOKEN')}"
    ),
    # Internal server for business data
    mcp(
        server_url="https://api.yourcompany.com/mcp",
        server_label="data",
        server_description="Business data: customers, orders, inventory",
        authorization=f"Bearer {os.getenv('API_TOKEN')}",
        allowed_tool_names=["search_customers", "get_order", "check_inventory"]
    ),
]

Zatim zamoli Groka da usporedi službenu React dokumentaciju s tvojim internim vodičem za arhitekturu o usmjeravanju: on upituje DeepWiki za prvo, a tvoj poslužitelj s dokumentacijom za drugo, a zatim suprotstavlja ta dva rezultata. Nijedan model ne može proizvesti ovaj odgovor isključivo na temelju vlastitog znanja, a to ne može ni web pretraživanje jer polovica materijala postoji samo u tvojoj tvrtki.

Na kraju primijeti kako su tri poslužitelja konfigurirana različito. Javni poslužitelj nema ni token ni popis dopuštenih alata, interna dokumentacija ima token, ali ostaje uglavnom otvorena jer je samo za čitanje, dok poslovni podaci kombiniraju token i strogo ograničenje na tri operacije. Svaki poslužitelj nosi razinu kontrole koju njegov sadržaj opravdava – u tome i jest poanta njihovog razdvajanja.

Ključne točke

  • DeepWiki (https://mcp.deepwiki.com/mcp) je javni MCP poslužitelj spreman za uporabu za GitHub dokumentaciju
  • Možeš stvoriti vlastite MCP poslužitelje kako bi izložio alate specifične za svoje poslovanje
  • Prilagođeni MCP poslužitelj je HTTPS web-aplikacija koja odgovara na zahtjeve otkrivanja i izvršenja
  • Kombiniranje javnih i internih poslužitelja daje najmoćnije konfiguracije
  • Svaki poslužitelj održava vlastitu razinu autentifikacije i ograničenja alata