Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

DeepWiki ja mukautetut työkalut

Oppitunti 9 / 12 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. DeepWiki: Julkinen palvelin harjoittelua varten
  2. Siirtyminen omiin palvelimiisi
  3. Julkiset ja sisäiset palvelimet samassa istunnossa
  4. Keskeiset asiat

DeepWiki: Julkinen palvelin harjoittelua varten

Kaikki tähän asti näkemäsi pysyy abstraktina, kunnes yhdistät todellisen palvelimen. DeepWiki on ihanteellinen ehdokas tähän ensimmäiseen testiin: se tarjoaa julkisen MCP-palvelimen osoitteessa https://mcp.deepwiki.com/mcp ilman todennusta, ja sen kautta pääset käsiksi minkä tahansa GitHub-projektin dokumentaatioon.

Määritys vaatii vain muutaman rivin, sillä ainoa vapaaehtoinen parametri, jolla on tässä todellista merkitystä, on kuvaus.

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

Kun yhteys on muodostettu, voit esittää Grokille kysymyksiä, jotka edellyttävät arkiston lukemista: “selitä, miten reititys toimii facebook/react-projektissa”, “mitkä ovat vercel/next.js:n määritysvaihtoehdot?” tai “näytä minulle langchain-ai/langchain-projektin rakenne”. Malli kutsuu DeepWiki-työkaluja, noutaa dokumentaation ja lähdekoodin sekä syntetisoi jäsennellyn vastauksen. Vertaa tätä vastausta siihen, mitä saisit ilman MCP-palvelinta: ero mallin omassa tiedossa ja juuri lukemansa välillä on välittömästi ilmeinen.

Siirtyminen omiin palvelimiisi

DeepWiki on erinomainen harjoittelualusta, mutta MCP:n todellinen arvo paljastuu, kun palvelin tarjoaa jotain, mitä kukaan muu ei voi: dataasi, prosessejasi ja liiketoimintatyökalujasi.

Teknisesti MCP-palvelin on verkkosovellus, joka vastaa kahtentyyppisiin pyyntöihin. Ensimmäinen on löytäminen: kun Grok muodostaa yhteyden, se pyytää luetteloa saatavilla olevista työkaluista niiden skeemoineen. Toinen on suoritus: kun malli päättää kutsua työkalua, se lähettää työkalun nimen ja sen argumentit ja odottaa tulosta. Palvelimen on tarjottava HTTPS-päätepiste, joka noudattaa MCP-protokollaa käyttäen Streaming HTTP:tä tai SSE:tä – näitä kahta kuljetustapaa käsiteltiin kurssin alussa.

Mukautetun palvelimen kiinnostavuus ei piile tekniikassa, vaan siinä, mitkä työkalut se julkaisee. Tässä on kolme esimerkkiä johdonmukaisesta jakamisesta, jossa jokainen palvelin kattaa yhden ja vain yhden toimialueen:

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

Tämä toimialueiden jakaminen ei ole pelkkää näennäisyyttä: sen avulla voit porrastaa todennusta ja palvelinrajoituksia palvelinkohtaisesti sen sijaan, että soveltaisit yhtä sääntöä sekalaiseen joukkoon heterogeenisiä työkaluja. Kun palvelimesi on otettu käyttöön, yhteys muodostetaan täsmälleen samalla tavalla kuin DeepWikin kanssa, mutta sitä täydennetään tunnuksella ja sallituslistalla.

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

Julkiset ja sisäiset palvelimet samassa istunnossa

Määrityksistä tulee todella mielenkiintoisia, kun sekoitat molempia tyyppejä, sillä tällöin malli voi korreloida julkisen lähteen sellaisen lähteen kanssa, joka on vain sinun käytössäsi.

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

Pyydä sitten Grokia vertaamaan virallista React-dokumentaatiota sisäiseen arkkitehtuurioppaaseesi reitityksestä: se hakee ensimmäisen DeepWikistä ja toisen dokumentaatiopalvelimestasi ja asettaa ne vastakkain. Mikään malli ei pysty tuottamaan tätä vastausta pelkän oman tietämyksensä perusteella, eikä verkkohaku kykene siihen, sillä puolet materiaalista on olemassa vain yrityksessäsi.

Huomaa lopuksi, miten kolme palvelinta on määritetty eri tavoin. Julkisella palvelimella ei ole tunnusta eikä sallituslistaa, sisäisellä dokumentaatiolla on tunnus, mutta se pysyy laajalti avoimena, koska se on vain luku -tilassa, ja liiketoimintadata yhdistää tunnuksen ja tiukan rajoituksen kolmeen operaatioon. Jokainen palvelin kantaa sen valvontatason, jonka sen sisältö perustelee – juuri siinä erottamisen pointti piilee.

Keskeiset asiat

  • DeepWiki (https://mcp.deepwiki.com/mcp) on valmis käytettäväksi oleva julkinen MCP-palvelin GitHub-dokumentaatiota varten
  • Voit luoda omia MCP-palvelimia tarjotaksesi työkaluja, jotka ovat spesifejä liiketoiminnallesi
  • Mukautettu MCP-palvelin on HTTPS-verkkosovellus, joka vastaa löytämis- ja suorituspyyntöihin
  • Julkisten ja sisäisten palvelinten yhdistäminen tuottaa tehokkaimmat määritykset
  • Jokainen palvelin ylläpitää omaa todennustasoaan ja työkalurajoituksiaan