Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Configuratie voor meerdere servers

Les 8 van 12 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Meerdere bronnen, één agent
  2. Syntaxis: niets nieuws, gewoon meerdere items
  3. Labels worden structureel
  4. Hoe Grok een server selecteert
  5. Een end-to-end supportagent
  6. Belangrijkste punten

Meerdere bronnen, één agent

Remote MCP ontplooit zijn volledige potentieel wanneer u Grok tegelijkertijd met meerdere servers verbindt. Elke server levert zijn eigen tools, en het model arbitreert daartussen op basis van het binnenkomende verzoek. Dit is het onderscheidende vermogen tussen een agent die slechts één taak kan uitvoeren en een agent die een onderzoek kan leiden: eerst de status van een service controleren, vervolgens de klantgeschiedenis raadplegen en daarna een artikel voor probleemoplossing zoeken, zonder dat u ook maar één regel orchestratiecode hoeft te schrijven.

Syntaxis: niets nieuws, gewoon meerdere items

Er is geen speciale modus voor meerdere servers die u hoeft in te schakelen. U voegt eenvoudigweg meerdere MCP-objecten toe aan de lijst 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"),
]

Hetzelfde principe geldt voor de Responses API in OpenAI-indeling, waarbij elke server een dictionary in de lijst wordt. In deze versie worden beschrijvingen toegevoegd; zoals u zult zien, zijn deze niet langer optioneel zodra u meer dan één server gebruikt.

tools = [
    {
        "type": "mcp",
        "server_url": "https://mcp.deepwiki.com/mcp",
        "server_label": "deepwiki",
        "server_description": "Documentation for GitHub open-source projects"
    },
    {
        "type": "mcp",
        "server_url": "https://your-custom-tools.com/mcp",
        "server_label": "custom",
        "server_description": "Internal company tools"
    },
    {
        "type": "mcp",
        "server_url": "https://api.example.com/tools",
        "server_label": "api-tools",
        "server_description": "Data and analytics API"
    },
]

Labels worden structureel

De server_label, tot nu toe slechts een hulpmiddel voor de leesbaarheid, wordt hier essentieel. Neem een veelvoorkomend scenario: u verbindt uw interne documentatie en DeepWiki, en beide bieden een tool genaamd search aan. Zonder onderscheidende labels dragen twee tools dezelfde naam en heeft Grok geen manier om een keuze te maken. Met labels queryt deepwiki__search de GitHub-documentatie, terwijl internal-docs__search uw kennisbank doorzoekt: twee duidelijk gescheiden tools waaruit het model kiest op basis van beschrijvingen en de gespreksstroom.

Drie regels volstaan om problemen te voorkomen. Elk label moet uniek zijn binnen de configuratie. Het moet de gegevensbron weerspiegelen in plaats van de technische functie, omdat de herkomst servers van elkaar onderscheidt, niet wat ze doen. En het moet kort blijven zonder uitwisselbaar te worden. Het onderstaande contrast illustreert het verschil tussen de twee benaderingen:

# Good: descriptive and distinct labels
server_label="deepwiki"
server_label="crm"
server_label="jira"

# Bad: ambiguous labels
server_label="server1"
server_label="server2"
server_label="tools"

De labels in de tweede reeks vormen een sluimerende val. Ze werken op de dag dat u ze schrijft, omdat u weet wat server1 bevat. Zes maanden later, bij het opnieuw lezen van een incidentenlogboek, weet niemand het meer – en het model wist het nooit.

Hoe Grok een server selecteert

Geconfronteerd met meerdere servers kruisverwijst het model vier informatiebronnen om een beslissing te nemen. Het begint met het gebruikersverzoek, oftewel wat er daadwerkelijk wordt gevraagd. Vervolgens raadpleegt het de server_description van elke server, wat aangeeft waar elke server globaal voor dient. Het gaat een niveau dieper naar de namen en beschrijvingen van de tools zelf; elke tool draagt zijn eigen metadata. Tot slot houdt het rekening met de context van het gesprek, aangezien eerdere berichten de selectie beïnvloeden: als de klant drie beurten eerder al zijn accountnummer heeft gegeven, weet Grok dat het crm__get_customer kan aanroepen zonder opnieuw te vragen.

Van deze vier bronnen heeft u over de tweede de meeste controle, en dat is precies waarom beschrijvingen kritiek worden in de modus voor meerdere servers. Zonder beschrijvingen valt Grok terug op alleen de toolnamen: een search tegenover een andere search, zonder indicatie van wat ze indexeren. De daaruit voortvloeiende selectiefouten zijn des te verwarrender omdat ze willekeurig lijken: het model kiest de helft van de tijd correct, puur door geluk.

Een end-to-end supportagent

Deze configuratie brengt alles wat hierboven is besproken samen in een complete use case.

tools = [
    mcp(
        server_url="https://kb.monentreprise.com/mcp",
        server_label="knowledge",
        server_description="Product knowledge base. Help articles, FAQ, troubleshooting guides.",
        allowed_tool_names=["search_articles", "get_article"]
    ),
    mcp(
        server_url="https://crm.monentreprise.com/mcp",
        server_label="crm",
        server_description="CRM. Customer history, previous tickets, account information.",
        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="Service status. Ongoing incidents, scheduled maintenance.",
        allowed_tool_names=["get_current_status", "list_incidents"]
    ),
]

Een klant schrijft: “mijn service werkt niet meer”. Grok controleert eerst of er een lopend incident is via status__get_current_status, raadpleegt het account van de klant met crm__get_customer om te weten welke service het betreft, en zoekt vervolgens via knowledge__search_articles naar een artikel voor probleemoplossing. Deze reeks staat nergens in uw code geschreven: deze vloeit voort uit de beschrijvingen en de gestelde vraag. Merk ook op dat elke server beperkt blijft tot zijn leesbewerkingen: de kracht van meerdere servers heft de behoefte aan een allowlist niet op.

Belangrijkste punten

  • Geef meerdere MCP-objecten door in de lijst tools voor configuraties met meerdere servers
  • Elke server moet een uniek en beschrijvend server_label hebben
  • Waarden voor server_description zijn essentieel om Grok naar de juiste server te leiden
  • Grok selecteert automatisch de juiste server op basis van het verzoek en de context
  • Beperk de tools van elke server met allowed_tool_names om ruis te beperken