Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

DeepWiki in orodja po meri

Lekcija 9 od 12 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. DeepWiki: Javni strežnik za vadbo
  2. Prehod na lastne strežnike
  3. Javni in interni strežniki v isti seji
  4. Ključne ugotovitve

DeepWiki: Javni strežnik za vadbo

Vse, kar si videl doslej, ostaja abstraktno, dokler ne povežeš pravega strežnika. DeepWiki je idealen kandidat za ta prvi test: razkriva javni MCP strežnik na naslovu https://mcp.deepwiki.com/mcp brez avtentikacije, ki omogoča dostop do dokumentacije katerega koli projekta na GitHubu.

Konfiguracija zahteva le nekaj vrstic, saj je edini opcijski parameter, ki tu res šteje, 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."
    )
]

Ko je ta povezava vzpostavljena, zastavi Groku vprašanja, ki dejansko zahtevajo branje repozitorija: „razloži, kako deluje usmerjanje v projektu facebook/react”, „katere so možnosti konfiguracije za vercel/next.js?” ali „prikaži mi strukturo projekta langchain-ai/langchain”. Model pokliče orodja DeepWiki, pridobi dokumentacijo in izvorno kodo ter nato sintetizira strukturiran odgovor. Primerjaj ta odgovor s tistim, ki bi ga dobil brez strežnika MCP: razlika med tem, kar model ve, in tem, kar je pravkar prebral, je takoj očitna.

Prehod na lastne strežnike

DeepWiki je odlično polje za vadbo, vendar se prava vrednost MCP pokaže, ko strežnik razkriva tisto, česar nihče drug ne more: tvoje podatke, tvoje procese, tvoja poslovna orodja.

Tehnično je strežnik MCP spletna aplikacija, ki odgovarja na dve vrsti zahtevkov. Najprej odkrivanje: ko se Grok poveže, zahteva seznam razpoložljivih orodij z njihovimi shemami. Nato izvajanje: ko se model odloči poklicati orodje, prenese ime orodja in njegove argumente, nato pa čaka na rezultat. Strežnik mora razkriti končno točko HTTPS, skladno s protokolom MCP, z uporabo pretoka HTTP ali SSE – dveh transportnih protokolov, obravnavanih na začetku tečaja.

Pri strežniku po meri ni zanimiva tehnika, temveč izbira orodij, ki jih objavlja. Tukaj so trije primeri koherentne razdelitve, kjer vsak strežnik pokriva eno področje in samo eno:

Server "analytics":
  - get_dashboard_metrics: dashboard metrics
  - query_events: query analytic events
  - get_funnel_report: conversion funnel report

Server "content":
  - search_articles: search within the CMS
  - get_article: retrieve a full article
  - list_categories: list content categories

Server "devops":
  - get_deploy_status: status of the last deployment
  - list_alerts: active monitoring alerts
  - get_service_health: health of a specific service

Ta razdelitev po področjih ni zgolj za videz: omogoča ti razvrščanje avtentikacije in omejitev strežnika za vsak strežnik posebej, namesto da bi uporabil eno samo pravilo za mešanico heterogenih orodij. Ko je tvoj strežnik nameščen, povezava sledi natanko vzorcu DeepWiki, dopolnjenemu z žetonom in seznamom dovoljenih orodij.

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 in interni strežniki v isti seji

Konfiguracije postanejo res zanimive, ko združiš obe družini, saj lahko model tako poveže javni vir z virom, ki ga 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"]
    ),
]

Nato prosi Grok, naj primerja uradno dokumentacijo Reacta s tvojim internim arhitekturnim vodnikom o usmerjanju: za prvo poizveduje pri DeepWiki, za drugo pa pri tvojem strežniku za dokumentacijo, nato pa oba rezultata sooči. Noben model ne more ustvariti tega odgovora zgolj iz lastnega znanja, tega ne zmore niti spletno iskanje, saj polovica gradiva obstaja le v tvojem podjetju.

Na koncu opazi, kako so trije strežniki konfigurirani različno. Javni strežnik nima niti žetona niti seznama dovoljenih orodij, interna dokumentacija ima žeton, vendar ostaja večinoma odprta, ker je samo za branje, poslovni podatki pa združujejo žeton in strogo omejitev na tri operacije. Vsak strežnik nosi raven nadzora, ki jo upravičuje njegova vsebina – prav v tem je smisel njihove ločitve.

Ključne ugotovitve

  • DeepWiki (https://mcp.deepwiki.com/mcp) je javni strežnik MCP, pripravljen za uporabo, za dokumentacijo GitHub
  • Ustvariš lahko lastne strežnike MCP za razkritje orodij, specifičnih za tvoje poslovanje
  • Strežnik MCP po meri je spletna aplikacija HTTPS, ki odgovarja na zahtevke za odkrivanje in izvajanje
  • Združevanje javnih in internih strežnikov prinaša najzmogljivejše konfiguracije
  • Vsak strežnik ohranja svojo raven avtentikacije in omejitve orodij