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

Configuración de varios servidores

Lección 8 de 12 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. Múltiples fuentes, un único agente
  2. Sintaxis: nada nuevo, solo varias entradas
  3. Las etiquetas se vuelven estructurales
  4. Cómo selecciona Grok un servidor
  5. Un agente de soporte de extremo a extremo
  6. Puntos clave

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 tools para configurar varios servidores
  • Cada servidor debe tener una server_label única y descriptiva
  • Los valores de server_description son 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_names para limitar el ruido