DeepWiki e Ferramentas Personalizadas
Nesta página
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