Configuração com múltiplos servidores
Nesta página
Múltiplas fontes, um único agente
O MCP remoto atinge todo o seu potencial quando liga o Grok a vários servidores em simultâneo. Cada um traz as suas próprias ferramentas, e o modelo arbitra entre elas com base no pedido recebido. É isto que separa um agente capaz de fazer apenas uma coisa de um agente capaz de conduzir uma investigação: verificar o estado de um serviço, depois o histórico de um cliente e, em seguida, um artigo de resolução de problemas, sem que tenha de escrever uma única linha de código de orquestração.
Sintaxe: nada de novo, apenas múltiplas entradas
Não existe nenhum modo multi-servidor para ativar. Basta adicionar vários objetos MCP à 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"),
]
O mesmo princípio aplica-se à API de Respostas no formato OpenAI, onde cada servidor se torna um dicionário na lista. Esta versão adiciona descrições, que verá não serem mais opcionais assim que utilizar mais do que um servidor.
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"
},
]
Os rótulos tornam-se estruturais
O server_label, até agora apenas uma ajuda à legibilidade, torna-se aqui essencial. Considere um cenário muito comum: liga a sua documentação interna e o DeepWiki, e ambos expõem uma ferramenta chamada search. Sem rótulos distintos, duas ferramentas terão o mesmo nome e o Grok não terá forma de decidir. Com rótulos, deepwiki__search consulta a documentação do GitHub enquanto internal-docs__search pesquisa na sua base de conhecimento — duas ferramentas claramente separadas que o modelo escolhe com base nas descrições e no fluxo da conversa.
Três regras são suficientes para nunca encontrar problemas. Cada rótulo deve ser único na configuração. Deve refletir a fonte de dados em vez da função técnica, porque a proveniência distingue os servidores uns dos outros, não o que fazem. E deve permanecer curto sem se tornar intermutável. O contraste abaixo ilustra a diferença entre as duas abordagens:
# Bom: rótulos descritivos e distintos
server_label="deepwiki"
server_label="crm"
server_label="jira"
# Mau: rótulos ambíguos
server_label="server1"
server_label="server2"
server_label="tools"
Os rótulos da segunda série são uma armadilha latente. Funcionam no dia em que os escreve, porque sabe o que server1 contém. Seis meses depois, ao reler um registo de incidentes, ninguém sabe mais — e o modelo, por sua vez, nunca soube.
Como o Grok seleciona um servidor
Perante múltiplos servidores, o modelo cruza quatro fontes de informação para decidir. Começa pelo pedido do utilizador, ou seja, pelo que é realmente solicitado. Consulta depois o server_description de cada servidor, que lhe indica para que serve cada um no geral. Desce um nível até aos nomes e descrições das próprias ferramentas, carregando cada uma as suas. E tem em conta o contexto da conversa, uma vez que as mensagens anteriores influenciam a seleção: se o cliente já lhe forneceu o número de conta três intervenções antes, o Grok sabe que pode chamar crm__get_customer sem voltar a perguntar.
Destas quatro fontes, a segunda é aquela sobre a qual tem maior controlo, e é precisamente por isso que as descrições se tornam críticas no modo multi-servidor. Sem descrições, o Grok recorre apenas aos nomes das ferramentas — um search perante outro search, sem indicação do que indexam. Os erros de seleção resultantes são tanto mais confusos quanto parecem aleatórios: o modelo escolhe corretamente metade das vezes, por sorte.
Um agente de suporte de ponta a ponta
Esta configuração reúne tudo o que foi referido acima num caso de uso completo.
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"]
),
]
Um cliente escreve “o meu serviço já não funciona”. O Grok verifica primeiro se existe algum incidente em curso através de status__get_current_status, consulta a conta do cliente com crm__get_customer para saber de que serviço se trata e, em seguida, procura um artigo de resolução de problemas através de knowledge__search_articles. Esta sequência não está escrita em lado nenhum no seu código: resulta das descrições e da pergunta colocada. Note também que cada servidor permanece restrito às suas operações de leitura — o poder do multi-servidor nunca elimina a necessidade de uma lista de permissões.
Pontos-chave
- Passe vários objetos MCP na lista
toolspara configuração multi-servidor - Cada servidor deve ter um
server_labelúnico e descritivo - Os valores de
server_descriptionsão essenciais para orientar o Grok para o servidor correto - O Grok seleciona automaticamente o servidor adequado com base no pedido e no contexto
- Restrinja as ferramentas de cada servidor com
allowed_tool_namespara limitar o ruído