Resumen y práctica guiada
En esta página
Lo que hemos cubierto
Este curso te ha llevado desde el concepto del Protocolo de Contexto de Modelo (MCP) hasta una configuración lista para producción. Si solo debes recordar una cosa, que sea esta: MCP permite a Grok conectarse a servidores de herramientas externos mediante HTTPS, descubriendo y utilizando automáticamente las herramientas expuestas sin necesidad de configuración manual en el cliente.
Arquitectónicamente, cuatro puntos estructuran todo lo demás. MCP remoto funciona exclusivamente sobre HTTPS, lo que descarta HTTP plano, localhost y el transporte stdio para servidores locales. Se admiten dos transportes: el moderno Streaming HTTP sin estado y el SSE persistente; es el servidor quien dicta cuál usar, no tú. Por último, tres interfaces proporcionan acceso a este mecanismo: el SDK nativo de xAI (recomendado), la API de Responses para compatibilidad con OpenAI y la API de Voice Agent para agentes de voz.
Los seis parámetros de un vistazo
| Parámetro | Obligatorio | Función |
|---|---|---|
server_url | Sí | Dirección HTTPS del servidor MCP |
server_label | Sí | Identificador único, prefija las herramientas |
server_description | No | Descripción en lenguaje natural para guiar a Grok |
allowed_tool_names | No | Lista blanca de herramientas accesibles |
authorization | No | Token de autenticación (Bearer, clave de API) |
headers | No | Cabeceras HTTP adicionales |
Dos obligatorios y cuatro opcionales: esa es toda la superficie de configuración para MCP remoto. Sin embargo, los opcionales no son meras comodidades. allowed_tool_names gestiona tu seguridad, y server_description garantiza una selección precisa cuando coexisten varios servidores.
Comprobaciones antes de pasar a producción
Tres categorías de controles merecen una verificación explícita. En el ámbito de la seguridad, asegúrate de que las URLs utilicen HTTPS con certificados válidos, que cada servidor interno tenga su token de autenticación, que estos tokens residan en variables de entorno, que las herramientas estén restringidas al mínimo necesario y que se planifique una rotación regular de tokens en lugar de confiar en la suerte.
En el lado de la configuración, cada servidor debe tener un server_label único y descriptivo, y su server_description debe ser precisa y estar actualizada; una descripción que refleje una versión anterior del servidor induce a error al modelo. Mantén el número total de herramientas en un rango razonable, alrededor de diez a veinte por sesión, y elimina de la configuración los servidores cuyas herramientas ya nadie invoca.
En cuanto a la observabilidad, planifica los incidentes con antelación: registra las llamadas a herramientas en tus logs, configura alertas ante errores de conexión MCP, rastrea el uso de tokens por servidor y mide la latencia de las llamadas. Esto último suele descuidarse, aunque constituye la primera señal de un servidor que se está degradando.
Tu primer agente, en tres pasos
La mejor manera de consolidar lo aprendido en este curso es construir progresivamente. Comienza con un servidor público, sin autenticación, para validar que la mecánica funciona de extremo a extremo.
from xai_sdk import Client
from xai_sdk.tools import mcp
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(
model="grok-4.20-0309-reasoning",
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
],
)
Prueba con una solicitud que obligue al modelo a consultar el repositorio, como «explícame la arquitectura del proyecto fastapi/fastapi». Si la respuesta llega y cita la estructura real del proyecto, tu conexión MCP está operativa.
A continuación, añade una herramienta nativa para ver cómo Grok arbitra entre dos fuentes de naturaleza distinta. La descripción del servidor resulta útil aquí, precisamente porque ahora existe una elección que hacer.
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Documentación para proyectos de código abierto en GitHub"
),
{"type": "web_search"},
]
Por último, da el salto a un servidor interno, con autenticación y restricción de herramientas. Este es el paso donde todo lo visto sobre seguridad se vuelve concreto.
tools=[
mcp(server_url="https://mcp.deepwiki.com/mcp", server_label="deepwiki"),
mcp(
server_url="https://api.your-server.com/mcp",
server_label="internal",
server_description="Datos y herramientas internos de la empresa",
authorization=f"Bearer {os.getenv('INTERNAL_TOKEN')}",
allowed_tool_names=["search", "get_document"]
),
{"type": "web_search"},
]
Lo que sigue siendo cierto tras este curso
Cuatro limitaciones acompañarán a todos tus proyectos MCP con Grok. La API de Responses en formato OpenAI no admite ni require_approval ni connector_id, lo que te devuelve al SDK nativo siempre que quieras validación humana antes de la ejecución. El transporte stdio, y por tanto los servidores MCP locales, sigue estando fuera de alcance: solo HTTPS. Cada herramienta expuesta consume contexto, lo que convierte al minimalismo en una decisión arquitectónica y no en un pensamiento posterior. Y la latencia de red se acumula con cada llamada, de modo que un agente que encadene varias herramientas MCP responderá más lentamente que uno que llame solo a una.
Ninguna de estas restricciones es un impedimento. Todas se sortean mediante decisiones de diseño tomadas con pleno conocimiento, que es precisamente lo que este curso te ha proporcionado.
Puntos clave
- MCP remoto conecta Grok a herramientas externas mediante HTTPS en pocas líneas de configuración
- Seis parámetros bastan para configurar un servidor MCP (dos obligatorios, cuatro opcionales)
- La seguridad se basa en el trío HTTPS + autenticación + restricción de herramientas
- Comienza con un servidor público (DeepWiki) y avanza hacia múltiples servidores autenticados
- Combina MCP y herramientas nativas para crear agentes versátiles
Pon a prueba tus conocimientos
Servidores MCP remotos en la API de Grok: te has ganado este resumen.
1. ¿Qué permite la compatibilidad con MCP de la API de Grok?
Respuesta: Conectar servidores MCP remotos como herramientas del modelo: Grok llama a sus capacidades durante la generación; tus sistemas y el ecosistema MCP se convierten en extensiones.
2. ¿Cómo se declara un servidor MCP en una solicitud?
Respuesta: Mediante server_url y server_label, con una descripción y una lista blanca de herramientas autorizadas, además de las cabeceras de autenticación necesarias para el acceso.
3. ¿Qué permite la configuración de múltiples servidores?
Respuesta: Combinar varios servidores MCP en una única solicitud, cada uno etiquetado, y mezclarlos con herramientas integradas (web, X): la orquestación sigue correspondiendo al modelo.
4. ¿Qué transportes se admiten?
Respuesta: Streaming HTTP y SSE, los transportes remotos del protocolo: el servidor reside donde tú quieras y la API se conecta a él.
5. ¿Qué reglas de seguridad para servidores remotos?
Respuesta: Autoriza solo las herramientas necesarias, autentícate rigurosamente y trata las respuestas del servidor como datos que deben validarse; un servidor MCP de terceros es una superficie de ataque potencial.
Declara, restringe, autentica, combina: MCP remoto extiende Grok a tus sistemas bajo tus reglas.