Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

DeepWiki és egyedi eszközök

9. lecke 12 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. DeepWiki: Nyilvános szerver gyakorláshoz
  2. Áttérés a saját szervereidre
  3. Nyilvános és belső szerverek ugyanabban a munkamenetben
  4. Főbb megállapítások

DeepWiki: Nyilvános szerver gyakorláshoz

Mindaz, amit eddig láttál, elvont marad, amíg nem csatlakoztatsz egy valódi szervert. A DeepWiki ideális jelölt erre az első tesztre: egy nyilvános MCP szervert tesz közzé a https://mcp.deepwiki.com/mcp címen, hitelesítés nélkül, amely hozzáférést biztosít bármely GitHub-projekt dokumentációjához.

A konfiguráció mindössze néhány sorból áll, mivel az egyetlen igazán fontos opcionális paraméter itt a leírás.

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."
    )
]

Ha ez a kapcsolat létrejött, tegyél fel Groknak olyan kérdéseket, amelyek ténylegesen megkövetelik a tároló (repository) olvasását: „magyarázd el, hogyan működik az útválasztás a facebook/react projektben“, „mik a vercel/next.js konfigurációs lehetőségei?“, vagy „mutasd meg a langchain-ai/langchain projektfelépítését“. A modell meghívja a DeepWiki eszközöket, lekéri a dokumentációt és a forráskódot, majd szintetizál egy strukturált választ. Hasonlítsd össze ezt a választ azzal, amit MCP szerver nélkül kapnál: a különbség a modell tudása és az imént olvasott információ között azonnal nyilvánvalóvá válik.

Áttérés a saját szervereidre

A DeepWiki kiváló gyakorlóterep, de az MCP igazi értéke akkor mutatkozik meg, amikor a szerver olyat tesz elérhetővé, ami másnak nem: a te adataidat, folyamataidat, üzleti eszközeidet.

Technikai értelemben az MCP szerver egy webes alkalmazás, amely kétféle kérésre válaszol. Először a felfedezés (discovery): amikor a Grok csatlakozik, lekéri az elérhető eszközök listáját a sémáikkal együtt. Ezután a végrehajtás: amikor a modell úgy dönt, hogy meghív egy eszközt, elküldi az eszköz nevét és argumentumait, majd várja az eredményt. A szervernek egy, az MCP protokollnak megfelelő HTTPS végpontot kell közzétennie, Streaming HTTP vagy SSE használatával – ez a két transzportprotokoll volt a tanfolyam elején tárgyalva.

Egy egyedi szervert nem a technika, hanem a közzétett eszközök választéka tesz érdekessé. Íme három példa a koherens szétválasztásra, ahol minden szerver egyetlen, és csak is egyetlen domaint fed le:

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

Ez a domainek szerinti szétválasztás nem csak a látvány kedvéért van: lehetővé teszi, hogy szerverenként eltérő hitelesítési szinteket és korlátozásokat alkalmazz, ahelyett, hogy egyetlen szabályt kényszerítenél rá vegyes, heterogén eszközök halmazára. Miután a szervered üzembe helyezted, a csatlakozás pontosan követi a DeepWiki mintáját, kiegészítve a tokennel és az engedélyezési listával (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"]
    )
]

Nyilvános és belső szerverek ugyanabban a munkamenetben

A konfigurációk akkor válnak igazán érdekessé, amikor mindkét típust vegyíted, mert így a modell korrelálni tudja a nyilvános forrásokat a kizárólag számodra elérhető forrásokkal.

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"]
    ),
]

Ezután kérd meg Grokot, hogy hasonlítsa össze a hivatalos React dokumentációt a saját, útválasztással foglalkozó belső architektúra-útmutatóddal: az elsőhöz a DeepWikiből kérdez, a másodikhoz a saját dokumentációs szerveredből, majd szembeállítja a kettőt. Egyetlen modell sem képes ilyen választ előállítani kizárólag a saját tudása alapján, és a webes keresés sem, mivel az anyag fele csak a te cégednél létezik.

Végül vedd észre, hogyan konfiguráltad eltérően a három szervert. A nyilvános szervernek nincs tokenje sem engedélyezési listája, a belső dokumentációnak van tokenje, de nagyrészt nyitott marad, mivel csak olvasható, az üzleti adatok szervere pedig kombinálja a tokent a szigorú korlátozással, csupán három műveletre. Minden szerver annyira szigorú ellenőrzést hordoz, amennyit a tartalma indokol – pontosan ez a lényege a szétválasztásuknak.

Főbb megállapítások

  • A DeepWiki (https://mcp.deepwiki.com/mcp) egy használatra kész, nyilvános MCP szerver GitHub-dokumentációhoz
  • Létrehozhatsz saját MCP szervereket, hogy a vállalkozásodra jellemző eszközöket tegyél elérhetővé
  • Az egyedi MCP szerver egy HTTPS webes alkalmazás, amely válaszol a felfedezési és végrehajtási kérésekre
  • A nyilvános és belső szerverek kombinációja adja a leghatékonyabb konfigurációkat
  • Minden szerver fenntartja a saját hitelesítési szintjét és eszközkorlátozásait