server_url y server_label
En esta página
Actualizado el 3 de noviembre de 2026 según la página Remote MCP Tools de xAI:
server_labelañade un prefijo a las llamadas a herramientas, pero la documentación no especifica el formato exacto de dicho prefijo; la notaciónlabel__toolutilizada en este curso es una convención de lectura: verifica el formato real en tus respuestas de la API. Fuente: Remote MCP Tools.
Los dos parámetros imprescindibles
Toda conexión entre Grok y un servidor MCP remoto depende de dos parámetros: server_url y server_label. Son innegociables: sin ellos, la API rechaza la solicitud antes de intentar cualquier operación. Todos los demás parámetros que encuentres más adelante refinan esta base; nunca la sustituyen.
server_url: La dirección exacta del punto final
El parámetro server_url contiene la URL completa del servidor MCP al que debe conectarse Grok, y esta URL sigue reglas estrictas.
La primera es HTTPS. La URL debe comenzar con https://, y xAI rechaza cualquier conexión HTTP no cifrada. La razón es sencilla: los intercambios entre Grok y el servidor MCP transportan las solicitudes de tus usuarios, los resultados de las herramientas y, a veces, el propio token de autenticación. Dejar que esto circule en texto plano sería indefendible.
# Correcto
mcp(server_url="https://mcp.deepwiki.com/mcp")
# Rechazado por la API
mcp(server_url="http://mcp.deepwiki.com/mcp")
La segunda regla afecta a la precisión de la ruta. La URL debe apuntar al punto final MCP, no a la raíz del dominio. Casi todos los servidores exponen su punto final en una ruta dedicada, y la convención varía de uno a otro. Estas son tres formas válidas que encontrarás:
https://mcp.deepwiki.com/mcp
https://api.example.com/mcp
https://tools.monentreprise.com/v1/mcp
La tercera regla se deriva de las dos anteriores: localhost y las direcciones IP privadas están excluidas. El servidor debe ser accesible desde la infraestructura de xAI, en un dominio público y con un certificado SSL válido. Esto plantea una pregunta concreta durante el desarrollo, ya que el servidor MCP que estás escribiendo se ejecuta en tu máquina. La solución habitual es utilizar un túnel, como ngrok o Cloudflare Tunnel, que expone tu instancia local detrás de una URL HTTPS pública durante la duración de tus pruebas.
server_label: La identidad del servidor en la conversación
El server_label es un identificador corto que Grok utiliza para añadir un prefijo a las llamadas a herramientas procedentes de este servidor. Su función es doble: hacer que los registros sean legibles y eliminar cualquier ambigüedad cuando coexisten varios servidores.
La documentación de xAI indica que la etiqueta añade un prefijo a las llamadas a herramientas de este servidor, sin especificar el formato exacto del prefijo. En este curso, denotamos una herramienta search_docs del servidor deepwiki como deepwiki__search_docs, para facilitar la lectura: verifica el formato real en las respuestas de la API antes de construir lógica sobre él.
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
# Las llamadas a herramientas de este servidor llevarán el prefijo "deepwiki"
Tres criterios guían la elección de una buena etiqueta. Debe ser corta, ya que se añade al nombre de cada llamada y una etiqueta prolija infla innecesariamente tus registros. Debe ser descriptiva, para que la fuente de una llamada sea legible de un vistazo sin consultar la configuración. Debe ser única en tu configuración; de lo contrario, no podrás distinguir entre dos servidores. Los ejemplos siguientes cumplen estos tres requisitos:
server_label="deepwiki" # Documentación de GitHub
server_label="crm" # Sistema de gestión de clientes
server_label="jira" # Seguimiento de incidencias
server_label="search" # Motor de búsqueda interno
Esto se vuelve mucho más tangible en cuanto conectas varios servidores a la misma sesión. Supongamos que tu documentación interna y DeepWiki exponen ambas una herramienta llamada search. Sin etiquetas distintas, los nombres de las herramientas colisionan y Grok no tiene forma de saber a cuál dirigirse. Con etiquetas, las dos herramientas reciben prefijos diferentes, notadas aquí como deepwiki__search e internal-docs__search, y la confusión desaparece. Volverás a tratar este punto en la lección dedicada a varios servidores.
Configuración mínima en ambos SDK
Juntos, estos dos parámetros son suficientes para hacer funcionar un servidor MCP público. Con el SDK nativo de xAI:
from xai_sdk.tools import mcp
tools = [
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
]
Y el equivalente exacto con la API de Responses en formato OpenAI:
tools = [{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki",
}]
Puntos clave
server_urlyserver_labelson los únicos dos parámetros obligatorios- La URL debe ser HTTPS con un certificado SSL válido; no se permite localhost
- La etiqueta añade un prefijo a todas las llamadas a herramientas de este servidor (el formato exacto no está documentado; este curso lo anota como
label__tool) - Elige etiquetas que sean cortas, descriptivas y únicas por servidor
- La etiqueta es esencial para entornos con varios servidores y evitar conflictos de nombres