Herramientas externas y SDK compatibles
En esta página
Tres puntos de entrada al mismo mecanismo
xAI expone MCP remoto a través de tres interfaces. Cada una está dirigida a un tipo de desarrollador distinto: una para proyectos nuevos, otra para proyectos migrados y una tercera para contextos de uso específicos. El comportamiento de MCP es exactamente el mismo en los tres casos; solo cambian la sintaxis de configuración y las herramientas periféricas. Por tanto, tu elección depende de tu pila tecnológica existente, no de las capacidades del protocolo.
El SDK nativo de xAI
Este es el método que recomienda xAI. Proporciona una función auxiliar mcp() que condensa la configuración en una única llamada a función.
from xai_sdk import Client
from xai_sdk.tools import mcp
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")
],
include=["verbose_streaming"],
)
La función auxiliar mcp() acepta todos los parámetros de configuración de MCP (URL, etiqueta, descripción, herramientas permitidas, autenticación) y se encarga de formatearlos correctamente para la API. Esta es la sintaxis más concisa y, lo que es más importante, aquella con la que es menos probable que cometas un error, ya que los nombres de las claves y la anidación se gestionan automáticamente. Elige esta vía para un proyecto nuevo sin restricciones de compatibilidad, para cualquier prototipado rápido y siempre que aproveches funciones específicas de xAI, como la transmisión detallada (verbose_streaming) que se muestra arriba.
La API de Responses, compatible con OpenAI
Esta interfaz acepta exactamente el formato de la API de OpenAI. Existe por una razón concreta: para que un equipo que ya ha escrito su aplicación en este formato no tenga que reescribirlo todo para probar Grok. El cambio se limita a la clave de API y a la URL base.
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input=[{"role": "user", "content": "Explain the React project"}],
tools=[{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki",
}],
)
Aquí, el servidor MCP se declara como un elemento del array tools, con el tipo "mcp" y los parámetros como pares clave-valor en el mismo objeto. No hay función auxiliar: escribes el diccionario a mano, lo que deja más margen para cometer un error tipográfico en el nombre de una clave.
Esta compatibilidad tiene un coste que debes conocer antes de construir sobre ella. Dos parámetros disponibles en el SDK nativo no lo están aquí: require_approval, que te permite exigir validación humana antes de ejecutar una herramienta MCP, y connector_id, que gestiona los conectores de OpenAI. Si tu agente maneja operaciones sensibles y contabas con la validación manual, esta limitación es un bloqueo y debería llevarte de vuelta al SDK nativo de xAI. La API de Responses sigue siendo la opción correcta para una migración desde OpenAI sin reescritura, para un proyecto multiproveedor donde alternas entre Grok y otros modelos, y para un equipo ya familiarizado con este formato.
La API de Voice Agent
La tercera interfaz está diseñada para agentes de voz. El escenario típico es un asistente telefónico que, en mitad de una conversación, necesita consultar una base de conocimientos, comprobar el estado de un pedido o consultar un sistema externo, sin que el interlocutor experimente silencios inexplicables.
La configuración de MCP sigue el mismo formato que en los otros SDK, con los mismos parámetros server_url, server_label y otros. La diferencia radica en lo que ocurre después de la llamada a la herramienta: el resultado se integra en el flujo de síntesis de voz en lugar de renderizarse como texto. Esto condiciona cómo redactas las descripciones de tus herramientas y cómo enmarcas sus respuestas, ya que el usuario nunca verá una tabla ni una lista; solo las escuchará.
Lo que no cambia entre interfaces
Sea cual sea el SDK, la secuencia es la misma. Grok descubre las herramientas expuestas por el servidor MCP, selecciona la que coincide con la solicitud, formula la llamada con los parámetros correctos e integra el resultado en su respuesta. Ninguna de las tres interfaces hace que el modelo sea más o menos hábil a la hora de elegir una herramienta.
Por tanto, las diferencias residen en otros aspectos: la concisión de la sintaxis, las funciones periféricas disponibles (transmisión detallada en el SDK de xAI, compatibilidad de formato en la API de Responses, síntesis de voz en Voice Agent) y los dos parámetros que faltan en el formato de OpenAI. Decide basándote en estos criterios y no te equivocarás.
Puntos clave
- El SDK nativo de xAI con
mcp()es el método más sencillo y completo - La API de Responses (formato OpenAI) facilita la migración, pero no admite
require_approvalniconnector_id - La API de Voice Agent conecta agentes de voz con herramientas MCP
- El comportamiento de MCP es idéntico en los tres casos; solo cambia la sintaxis
- Elige en función de tu pila tecnológica existente y de tus necesidades específicas