Vai al contenuto principale
Italiano— Scegli una lingua
Menu

DeepWiki e strumenti personalizzati

Lezione 9 di 12 Aggiornata il 29 luglio 2026 Sviluppatore
In questa pagina
  1. DeepWiki: un server pubblico per esercitarti
  2. Passare ai tuoi server personali
  3. Server pubblici e interni nella stessa sessione
  4. Punti chiave

DeepWiki: un server pubblico per esercitarti

Tutto ciò che hai visto finora rimane astratto finché non colleghi un server reale. DeepWiki è il candidato ideale per questo primo test: espone un server MCP pubblico all’indirizzo https://mcp.deepwiki.com/mcp, senza autenticazione, che fornisce accesso alla documentazione di qualsiasi progetto GitHub.

La configurazione richiede solo poche righe, poiché l’unico parametro opzionale che conta davvero qui è la descrizione.

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

Una volta stabilita questa connessione, poni a Grok domande che richiedono effettivamente la lettura del repository: «spiega come funziona il routing nel progetto facebook/react», «quali sono le opzioni di configurazione per vercel/next.js?» oppure «mostrami la struttura del progetto per langchain-ai/langchain». Il modello invoca gli strumenti DeepWiki, recupera documentazione e codice sorgente, quindi sintetizza una risposta strutturata. Confronta questa risposta con quella che otterresti senza il server MCP: la differenza tra ciò che il modello sa e ciò che ha appena letto è immediatamente evidente.

Passare ai tuoi server personali

DeepWiki è un ottimo terreno di allenamento, ma il vero valore di MCP emerge quando il server espone ciò che nessun altro può offrire: i tuoi dati, i tuoi processi, i tuoi strumenti aziendali.

Tecnicamente, un server MCP è un’applicazione web che risponde a due tipi di richieste. Prima la scoperta: quando Grok si connette, richiede l’elenco degli strumenti disponibili con i relativi schemi. Poi l’esecuzione: quando il modello decide di chiamare uno strumento, trasmette il nome dello strumento e i suoi argomenti, quindi attende il risultato. Il server deve esporre un endpoint HTTPS conforme al protocollo MCP, utilizzando Streaming HTTP o SSE, i due trasporti trattati all’inizio del corso.

Ciò che rende interessante un server personalizzato non è la tecnica, ma la scelta degli strumenti che pubblica. Ecco tre esempi di suddivisione coerente, in cui ogni server copre un dominio e uno solo:

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

Questa suddivisione per dominio non è solo formale: ti permette di differenziare autenticazione e restrizioni del server per ciascun server, invece di applicare un’unica regola a un mix eterogeneo di strumenti. Una volta distribuito il tuo server, la connessione segue esattamente lo schema di DeepWiki, arricchito con token e 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"]
    )
]

Server pubblici e interni nella stessa sessione

Le configurazioni diventano davvero interessanti quando mescoli entrambe le famiglie, perché il modello può così correlare una fonte pubblica con una fonte di cui solo tu disponi.

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

Chiedi poi a Grok di confrontare la documentazione ufficiale di React con la tua guida interna all’architettura sul routing: interroga DeepWiki per la prima e il tuo server di documentazione per la seconda, quindi mette a confronto le due. Nessun modello può produrre questa risposta basandosi solo sulle proprie conoscenze, e nemmeno la ricerca sul web può farlo, dato che metà del materiale esiste solo nella tua azienda.

Nota infine come i tre server siano configurati in modo diverso. Il server pubblico non ha né token né allowlist, la documentazione interna ha un token ma rimane ampiamente aperta perché è in sola lettura, mentre i dati aziendali combinano token e una restrizione rigorosa a tre operazioni. Ogni server porta con sé il livello di controllo che il suo contenuto giustifica: è esattamente il punto di separarli.

Punti chiave

  • DeepWiki (https://mcp.deepwiki.com/mcp) è un server MCP pubblico pronto all’uso per la documentazione GitHub
  • Puoi creare i tuoi server MCP per esporre strumenti specifici del tuo business
  • Un server MCP personalizzato è un’applicazione web HTTPS che risponde alle richieste di scoperta ed esecuzione
  • La combinazione di server pubblici e interni produce le configurazioni più potenti
  • Ogni server mantiene il proprio livello di autenticazione e restrizione degli strumenti