Salt la conținutul principal
Română— Alege o limbă
Meniu

DeepWiki și instrumente personalizate

Lecția 9 din 12 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. DeepWiki: Un server public pentru exerciții
  2. Trecerea la propriile servere
  3. Servere publice și interne în aceeași sesiune
  4. Puncte cheie

DeepWiki: Un server public pentru exerciții

Tot ce ați văzut până acum rămâne abstract până când conectați un server real. DeepWiki este candidatul ideal pentru acest prim test: expune un server MCP public la adresa https://mcp.deepwiki.com/mcp, fără autentificare, care oferă acces la documentația oricărui proiect GitHub.

Configurarea necesită doar câteva linii, deoarece singurul parametru opțional care contează cu adevărat aici este descrierea.

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

Odată stabilită această conexiune, puneți-i lui Grok întrebări care necesită în mod real citirea repository-ului: „explică cum funcționează rutarea în proiectul facebook/react“, „care sunt opțiunile de configurare pentru vercel/next.js?“ sau „arată-mi structura proiectului pentru langchain-ai/langchain“. Modelul apelează instrumentele DeepWiki, preia documentația și codul sursă, apoi sintetizează un răspuns structurat. Comparați acest răspuns cu ceea ce ați obține fără serverul MCP: diferența dintre ceea ce știe modelul și ceea ce tocmai a citit devine imediat evidentă.

Trecerea la propriile servere

DeepWiki este un teren de antrenament excelent, dar valoarea reală a MCP apare atunci când serverul expune ceea ce nimeni altcineva nu poate: datele dumneavoastră, procesele dumneavoastră, instrumentele dumneavoastră de afaceri.

Din punct de vedere tehnic, un server MCP este o aplicație web care răspunde la două tipuri de cereri. Mai întâi, descoperirea: când Grok se conectează, solicită lista instrumentelor disponibile împreună cu schemele lor. Apoi, execuția: când modelul decide să apeleze un instrument, transmite numele instrumentului și argumentele sale, apoi așteaptă rezultatul. Serverul trebuie să expună un endpoint HTTPS conform protocolului MCP, folosind Streaming HTTP sau SSE – cele două transporturi acoperite la începutul cursului.

Ceea ce face un server personalizat interesant nu este tehnica, ci alegerea instrumentelor pe care le publică. Iată trei exemple de separare coerentă, în care fiecare server acoperă un singur domeniu și doar unul:

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

Această separare pe domenii nu este doar de fațadă: vă permite să ierarhizați autentificarea și restricțiile serverului per server, în loc să aplicați o singură regulă unui amestec eterogen de instrumente. Odată ce serverul dumneavoastră este implementat, conexiunea urmează exact modelul DeepWiki, completat cu token-ul și lista de允许 (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"]
    )
]

Servere publice și interne în aceeași sesiune

Configurațiile devin cu adevărat interesante atunci când amestecați ambele familii, deoarece modelul poate corela apoi o sursă publică cu o sursă pe care doar dumneavoastră o dețineți.

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

Apoi, cereți-i lui Grok să compare documentația oficială React cu ghidul dumneavoastră intern de arhitectură privind rutarea: acesta interoghează DeepWiki pentru prima și serverul dumneavoastră de documentație pentru a doua, apoi contrastează cele două. Niciun model nu poate produce acest răspuns doar din cunoștințele sale proprii, iar nici căutarea pe web nu poate face acest lucru, deoarece jumătate din material există doar în compania dumneavoastră.

Observați în final cum sunt configurate diferit cele trei servere. Serverul public nu are nici token, nici listă de允许 (allowlist); documentația internă are un token, dar rămâne în mare parte deschisă deoarece este read-only; iar datele de afaceri combină token-ul cu o restricție strictă la trei operațiuni. Fiecare server poartă nivelul de control pe care conținutul său îl justifică – acesta este exact scopul separării lor.

Puncte cheie

  • DeepWiki (https://mcp.deepwiki.com/mcp) este un server MCP public, gata de utilizare, pentru documentația GitHub
  • Puteți crea propriile servere MCP pentru a expune instrumente specifice afacerii dumneavoastră
  • Un server MCP personalizat este o aplicație web HTTPS care răspunde la cererile de descoperire și execuție
  • Combinarea serverelor publice și interne oferă cele mai puternice configurații
  • Fiecare server își menține propriul nivel de autentificare și restricționare a instrumentelor