Ir para o conteúdo principal
Português— Escolher um idioma
Menu

DeepWiki e Ferramentas Personalizadas

Aula 9 de 12 Atualizada a 29 de julho de 2026 Programador
Nesta página
  1. DeepWiki: Um Servidor Público para Prática
  2. Passagem para os Seus Próprios Servidores
  3. Servidores Públicos e Internos na Mesma Sessão
  4. Pontos-chave

DeepWiki: Um Servidor Público para Prática

Tudo o que viu até agora permanece abstrato até ligar um servidor real. O DeepWiki é o candidato ideal para este primeiro teste: expõe um servidor MCP público em https://mcp.deepwiki.com/mcp, sem autenticação, que fornece acesso à documentação de qualquer projeto no GitHub.

A configuração requer apenas algumas linhas, uma vez que o único parâmetro opcional que realmente importa aqui é a descrição.

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

Uma vez estabelecida esta ligação, faça perguntas ao Grok que exijam realmente a leitura do repositório: “explique como funciona o roteamento no projeto facebook/react”, “quais são as opções de configuração para vercel/next.js?” ou “mostre-me a estrutura do projeto para langchain-ai/langchain”. O modelo invoca as ferramentas do DeepWiki, recupera a documentação e o código-fonte e, em seguida, sintetiza uma resposta estruturada. Compare esta resposta com o que obteria sem o servidor MCP: a diferença entre o que o modelo sabe e o que acabou de ler torna-se imediatamente óbvia.

Passagem para os Seus Próprios Servidores

O DeepWiki é um excelente terreno de treino, mas o verdadeiro valor do MCP surge quando o servidor expõe aquilo que mais ninguém possui: os seus dados, os seus processos, as suas ferramentas de negócio.

Tecnicamente, um servidor MCP é uma aplicação web que responde a dois tipos de pedidos. Primeiro, a descoberta: quando o Grok se liga, solicita a lista de ferramentas disponíveis com os seus esquemas. Em seguida, a execução: quando o modelo decide invocar uma ferramenta, transmite o nome da ferramenta e os seus argumentos, aguardando depois o resultado. O servidor deve expor um endpoint HTTPS compatível com o protocolo MCP, utilizando Streaming HTTP ou SSE — os dois transportes abordados no início do curso.

O que torna um servidor personalizado interessante não é a técnica, mas sim a escolha das ferramentas que publica. Eis três exemplos de divisão coerente, onde cada servidor cobre um domínio e apenas um:

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

Esta divisão por domínios não é apenas estética: permite-lhe escalonar a autenticação e as restrições do servidor por servidor, em vez de aplicar uma única regra a um conjunto heterogéneo de ferramentas misturadas. Assim que o seu servidor estiver implementado, a ligação segue exatamente o padrão do DeepWiki, acrescido do token e da lista de permissões (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"]
    )
]

Servidores Públicos e Internos na Mesma Sessão

As configurações tornam-se verdadeiramente interessantes quando mistura ambas as famílias, pois o modelo pode então correlacionar uma fonte pública com uma fonte à qual só você tem acesso.

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

Peça depois ao Grok que compare a documentação oficial do React com o seu guia interno de arquitetura sobre roteamento: ele consulta o DeepWiki para o primeiro e o seu servidor de documentação para o segundo, contrastando depois os dois. Nenhum modelo consegue produzir esta resposta apenas com o seu próprio conhecimento, e a pesquisa na web também não, dado que metade do material existe apenas na sua empresa.

Repare finalmente como os três servidores estão configurados de forma diferente. O servidor público não tem token nem lista de permissões; a documentação interna possui um token, mas permanece largamente aberta por ser apenas de leitura; e os dados de negócio combinam token com uma restrição estrita a três operações. Cada servidor carrega o nível de controlo que o seu conteúdo justifica — é exatamente esse o objetivo de os separar.

Pontos-chave

  • O DeepWiki (https://mcp.deepwiki.com/mcp) é um servidor MCP público pronto a usar para documentação do GitHub
  • Pode criar os seus próprios servidores MCP para expor ferramentas específicas do seu negócio
  • Um servidor MCP personalizado é uma aplicação web HTTPS que responde a pedidos de descoberta e execução
  • A combinação de servidores públicos e internos produz as configurações mais poderosas
  • Cada servidor mantém o seu próprio nível de autenticação e restrição de ferramentas