Configuración de varios servidores
En esta página
Múltiples fuentes, un único agente
Remote MCP alcanza todo su potencial cuando conectas Grok a varios servidores simultáneamente. Cada uno aporta sus propias herramientas y el modelo arbitra entre ellas en función de la solicitud entrante. Esto es lo que diferencia a un agente capaz de hacer una sola cosa de uno que puede llevar a cabo una investigación: comprobar el estado de un servicio, luego el historial de un cliente y, finalmente, un artículo de resolución de problemas, sin que tengas que escribir ni una línea de código de orquestación.
Sintaxis: nada nuevo, solo varias entradas
No existe ningún modo multi-servidor que debas activar. Simplemente añades varios objetos MCP a la lista tools.
from xai_sdk.tools import mcp
tools = [
mcp(server_url="https://mcp.deepwiki.com/mcp", server_label="deepwiki"),
mcp(server_url="https://your-custom-tools.com/mcp", server_label="custom"),
mcp(server_url="https://api.example.com/tools", server_label="api-tools"),
]
El mismo principio se aplica a la API de Responses en formato OpenAI, donde cada servidor se convierte en un diccionario dentro de la lista. Esta versión añade descripciones, que verás que dejan de ser opcionales en cuanto utilizas más de un servidor.
tools = [
{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki",
"server_description": "Documentación de proyectos open source de GitHub"
},
{
"type": "mcp",
"server_url": "https://your-custom-tools.com/mcp",
"server_label": "custom",
"server_description": "Herramientas internas de la empresa"
},
{
"type": "mcp",
"server_url": "https://api.example.com/tools",
"server_label": "api-tools",
"server_description": "API de datos y análisis"
},
]
Las etiquetas se vuelven estructurales
La server_label, hasta ahora una ayuda para la legibilidad, se vuelve aquí esencial. Piensa en un escenario muy común: conectas tu documentación interna y DeepWiki, y ambos exponen una herramienta llamada search. Sin etiquetas distintas, dos herramientas tendrían el mismo nombre y Grok no tendría forma de decidir. Con etiquetas, deepwiki__search consulta la documentación de GitHub mientras que internal-docs__search busca en tu base de conocimientos: dos herramientas claramente separadas que el modelo elige basándose en las descripciones y el flujo de la conversación.
Tres reglas bastan para no encontrarte nunca con un problema. Cada etiqueta debe ser única en la configuración. Debe reflejar la fuente de datos en lugar de la función técnica, porque la procedencia es lo que distingue a los servidores entre sí, no lo que hacen. Y debe permanecer corta sin llegar a ser intercambiable. El contraste siguiente ilustra la brecha entre ambos enfoques:
# Correcto: etiquetas descriptivas y distintas
server_label="deepwiki"
server_label="crm"
server_label="jira"
# Incorrecto: etiquetas ambiguas
server_label="server1"
server_label="server2"
server_label="tools"
Las etiquetas de la segunda serie son una trampa latente. Funcionan el día que las escribes, porque tú sabes qué contiene server1. Seis meses después, al releer un registro de incidentes, nadie lo sabe ya; y el modelo, por su parte, nunca lo supo.
Cómo selecciona Grok un servidor
Ante varios servidores, el modelo cruza cuatro fuentes de información para decidir. Empieza por la solicitud del usuario, es decir, lo que se pide realmente. A continuación consulta la server_description de cada servidor, que le indica para qué sirve cada uno en términos generales. Baja un nivel hasta los nombres y descripciones de las propias herramientas, ya que cada una lleva la suya. Y tiene en cuenta el contexto de la conversación, puesto que los mensajes anteriores influyen en la selección: si el cliente ya te ha dado su número de cuenta tres turnos antes, Grok sabe que puede llamar a crm__get_customer sin volver a preguntarlo.
De estas cuatro fuentes, la segunda es sobre la que tienes mayor control, y precisamente por eso las descripciones se vuelven críticas en el modo multi-servidor. Sin descripciones, Grok se basa únicamente en los nombres de las herramientas: un search frente a otro search, sin indicación de qué indexan. Los errores de selección resultantes son tanto más confusos porque parecen aleatorios: el modelo acierta la mitad de las veces, por suerte.
Un agente de soporte de extremo a extremo
Esta configuración reúne todo lo anterior en un caso de uso completo.
tools = [
mcp(
server_url="https://kb.monentreprise.com/mcp",
server_label="knowledge",
server_description="Base de conocimientos del producto. Artículos de ayuda, FAQ, guías de resolución de problemas.",
allowed_tool_names=["search_articles", "get_article"]
),
mcp(
server_url="https://crm.monentreprise.com/mcp",
server_label="crm",
server_description="CRM. Historial de clientes, tickets anteriores, información de cuenta.",
authorization=f"Bearer {os.getenv('CRM_TOKEN')}",
allowed_tool_names=["get_customer", "search_tickets", "get_ticket"]
),
mcp(
server_url="https://status.monentreprise.com/mcp",
server_label="status",
server_description="Estado del servicio. Incidentes en curso, mantenimiento programado.",
allowed_tool_names=["get_current_status", "list_incidents"]
),
]
Un cliente escribe «mi servicio ya no funciona». Grok comprueba primero si hay algún incidente en curso mediante status__get_current_status, consulta la cuenta del cliente con crm__get_customer para saber de qué servicio se trata y, a continuación, busca un artículo de resolución de problemas mediante knowledge__search_articles. Esta secuencia no está escrita en ninguna parte de tu código: surge de las descripciones y de la pregunta formulada. Observa también que cada servidor sigue restringido a sus operaciones de lectura: el poder del multi-servidor nunca elimina la necesidad de una lista de permitidos.
Puntos clave
- Pasa varios objetos MCP en la lista
toolspara configurar varios servidores - Cada servidor debe tener una
server_labelúnica y descriptiva - Los valores de
server_descriptionson esenciales para guiar a Grok hacia el servidor correcto - Grok selecciona automáticamente el servidor adecuado en función de la solicitud y el contexto
- Restringe las herramientas de cada servidor con
allowed_tool_namespara limitar el ruido