Ir al contenido principal
Español— Elegir un idioma
Menú

DeepWiki y herramientas personalizadas

Lección 9 de 12 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. DeepWiki: un servidor público para practicar
  2. Paso a tus propios servidores
  3. Servidores públicos e internos en la misma sesión
  4. Puntos clave

DeepWiki: un servidor público para practicar

Todo lo que has visto hasta ahora permanece abstracto hasta que conectas un servidor real. DeepWiki es el candidato ideal para esta primera prueba: expone un servidor MCP público en https://mcp.deepwiki.com/mcp, sin autenticación, que proporciona acceso a la documentación de cualquier proyecto de GitHub.

La configuración apenas requiere unas líneas, ya que el único parámetro opcional que realmente importa aquí es la descripción.

from xai_sdk.tools import mcp

tools = [
    mcp(
        server_url="https://mcp.deepwiki.com/mcp",
        server_label="deepwiki",
        server_description="Documentación para proyectos de código abierto en GitHub. Busca y visualiza código, README y guías."
    )
]

Una vez establecida esta conexión, formula a Grok preguntas que requieran realmente leer el repositorio: «explica cómo funciona el enrutamiento en el proyecto facebook/react», «cuáles son las opciones de configuración de vercel/next.js?» o «muéstrame la estructura del proyecto langchain-ai/langchain». El modelo invoca las herramientas de DeepWiki, recupera la documentación y el código fuente, y luego sintetiza una respuesta estructurada. Compara esta respuesta con la que obtendrías sin el servidor MCP: la diferencia entre lo que el modelo sabe y lo que acaba de leer resulta inmediatamente obvia.

Paso a tus propios servidores

DeepWiki es un excelente campo de entrenamiento, pero el verdadero valor de MCP aparece cuando el servidor expone lo que nadie más puede ofrecer: tus datos, tus procesos y tus herramientas de negocio.

Técnicamente, un servidor MCP es una aplicación web que responde a dos tipos de solicitudes. Primero, el descubrimiento: cuando Grok se conecta, solicita la lista de herramientas disponibles con sus esquemas. Después, la ejecución: cuando el modelo decide llamar a una herramienta, transmite el nombre de la herramienta y sus argumentos, y luego espera el resultado. El servidor debe exponer un punto final HTTPS compatible con el protocolo MCP, utilizando Streaming HTTP o SSE, los dos transportes cubiertos al inicio del curso.

Lo que hace interesante a un servidor personalizado no es la técnica, sino la elección de las herramientas que publica. Aquí tienes tres ejemplos de división coherente, donde cada servidor cubre un dominio y solo uno:

Servidor "analytics":
  - get_dashboard_metrics: métricas del panel de control
  - query_events: consulta de eventos analíticos
  - get_funnel_report: informe del embudo de conversión

Servidor "content":
  - search_articles: búsqueda dentro del CMS
  - get_article: recuperación de un artículo completo
  - list_categories: listado de categorías de contenido

Servidor "devops":
  - get_deploy_status: estado del último despliegue
  - list_alerts: alertas de monitorización activas
  - get_service_health: estado de un servicio específico

Esta división por dominios no es solo estética: te permite escalonar la autenticación y las restricciones del servidor por cada instancia, en lugar de aplicar una única regla a una mezcla heterogénea de herramientas. Una vez desplegado tu servidor, la conexión sigue exactamente el patrón de DeepWiki, aumentado con el token y la lista de permitidos.

tools = [
    mcp(
        server_url="https://mcp.yourcompany.com/analytics",
        server_label="analytics",
        server_description="Métricas e informes analíticos. Paneles, embudos, eventos.",
        authorization=f"Bearer {os.getenv('ANALYTICS_TOKEN')}",
        allowed_tool_names=["get_dashboard_metrics", "query_events"]
    )
]

Servidores públicos e internos en la misma sesión

Las configuraciones se vuelven realmente interesantes cuando mezclas ambas familias, porque el modelo puede entonces correlacionar una fuente pública con una fuente de la que solo tú dispones.

tools = [
    # Servidor público para documentación de código abierto
    mcp(
        server_url="https://mcp.deepwiki.com/mcp",
        server_label="deepwiki",
        server_description="Documentación para proyectos de código abierto en GitHub"
    ),
    # Servidor interno para documentación de producto
    mcp(
        server_url="https://docs.yourcompany.com/mcp",
        server_label="internal-docs",
        server_description="Documentación técnica interna, guías de arquitectura, ADR",
        authorization=f"Bearer {os.getenv('DOCS_TOKEN')}"
    ),
    # Servidor interno para datos de negocio
    mcp(
        server_url="https://api.yourcompany.com/mcp",
        server_label="data",
        server_description="Datos de negocio: clientes, pedidos, inventario",
        authorization=f"Bearer {os.getenv('API_TOKEN')}",
        allowed_tool_names=["search_customers", "get_order", "check_inventory"]
    ),
]

A continuación, pide a Grok que compare la documentación oficial de React con tu guía interna de arquitectura sobre enrutamiento: consultará DeepWiki para lo primero y tu servidor de documentación para lo segundo, y luego contrastará ambos resultados. Ningún modelo puede producir esta respuesta basándose únicamente en su propio conocimiento, ni tampoco puede hacerlo la búsqueda web, dado que la mitad del material existe solo en tu empresa.

Observa finalmente cómo los tres servidores están configurados de manera diferente. El servidor público no tiene ni token ni lista de permitidos; la documentación interna tiene un token pero permanece ampliamente abierta porque es de solo lectura; y los datos de negocio combinan token y una restricción estricta a tres operaciones. Cada servidor lleva el nivel de control que justifica su contenido: ese es exactamente el punto de separarlos.

Puntos clave

  • DeepWiki (https://mcp.deepwiki.com/mcp) es un servidor MCP público listo para usar para documentación de GitHub
  • Puedes crear tus propios servidores MCP para exponer herramientas específicas de tu negocio
  • Un servidor MCP personalizado es una aplicación web HTTPS que responde a solicitudes de descubrimiento y ejecución
  • La combinación de servidores públicos e internos genera las configuraciones más potentes
  • Cada servidor mantiene su propio nivel de autenticación y restricción de herramientas