Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Transportes HTTP em Streaming e SSE

Aula 2 de 12 Atualizada a 29 de julho de 2026 Programador
Nesta página
  1. O que um transporte abrange realmente
  2. HTTP em Streaming, o transporte moderno
  3. Server-Sent Events, a abordagem de ligação aberta
  4. Não escolhe, herda
  5. O que a xAI não suporta
  6. Consequências para a sua arquitetura
  7. Pontos-chave

O que um transporte abrange realmente

No vocabulário MCP, transporte refere-se à forma como a sua aplicação e o servidor de ferramentas trocam fisicamente mensagens. Não se trata de um detalhe de implementação trivial: determina se a ligação permanece aberta entre chamadas, como os resultados chegam até si e o que acontece quando um proxy decide cortar a ligação. A xAI suporta dois para MCP remoto: HTTP em Streaming e SSE (Server-Sent Events), ambos sobre HTTPS.

HTTP em Streaming, o transporte moderno

O HTTP em Streaming é o mais recente dos dois no padrão MCP. Baseia-se em pedidos HTTP perfeitamente comuns, com uma nuance: o servidor pode devolver a sua resposta como um fluxo contínuo, em vez de esperar para calcular tudo antes de emitir um único bloco. Uma chamada desenrola-se em quatro passos.

  1. O Grok envia um pedido POST ao servidor MCP com os parâmetros da ferramenta a invocar
  2. O servidor inicia o processamento do pedido
  3. A resposta chega progressivamente, peça por peça
  4. A ligação encerra assim que a resposta estiver completa

Este mecanismo faz sentido para ferramentas lentas ou verbosas. Tome como exemplo uma ferramenta de pesquisa que varre um corpus de documentos: em vez de fazer o modelo esperar até ao último resultado, emite as suas descobertas à medida que surgem. Do lado da infraestrutura, o HTTP em Streaming comporta-se como tráfego web clássico, o que explica porque atravessa facilmente balanceadores de carga e proxies empresariais. Como cada chamada de ferramenta é um pedido independente, não existe nenhuma ligação persistente para monitorizar.

Server-Sent Events, a abordagem de ligação aberta

O SSE é o veterano do ecossistema MCP. Baseia-se numa ligação persistente e unidirecional: o cliente abre-a para o servidor, o servidor mantém-na aberta e empurra eventos para ela quando os tem. No contexto MCP, a chamada da ferramenta vai para um endpoint separado e o resultado regressa através do canal SSE já estabelecido.

Esta operação tem uma vantagem real e uma desvantagem simétrica. A vantagem: como a ligação já existe, chamadas sucessivas não têm de pagar novamente o custo de estabelecimento e o servidor pode emitir notificações sem que o cliente as solicite. A desvantagem: uma ligação de longa duração é uma ligação frágil. Um proxy que aplique um tempo limite, um corte de rede de dois segundos, e o canal cai. Uma implementação séria de SSE deve, portanto, planear a sua lógica de reconexão.

Não escolhe, herda

Eis o ponto que frequentemente surpreende: não seleciona o transporte. O servidor MCP impõe aquele que implementa. Quando configura um servidor na API da xAI, fornece apenas o seu URL e a API deteta automaticamente o transporte atual. Não existe nenhum parâmetro para forçar um em detrimento do outro.

Na prática, a maioria dos servidores MCP públicos recentes adotou o HTTP em Streaming; os mais antigos permanecem no SSE. Ambos funcionam de forma transparente com a API do Grok e, geralmente, não terá qualquer forma de saber qual está a ser utilizado sem consultar a documentação do servidor.

O que a xAI não suporta

Três transportes vistos noutros locais do ecossistema MCP estão fora de jogo aqui, e ignorar esta lista é a causa mais frequente de uma primeira tentativa falhada. O transporte stdio, utilizado por servidores MCP locais como os ligados ao Claude Desktop, não é aceite: um servidor em execução na sua máquina e a comunicar via entrada/saída padrão não pode ser ligado ao Grok. O HTTP simples é recusado sem exceção; tudo deve passar por HTTPS. O WebSocket, que algumas implementações MCP utilizam, também não é reconhecido como um transporte MCP pela API da xAI.

Consequências para a sua arquitetura

O transporte imposto pelo servidor impacta a robustez da sua aplicação. Com o HTTP em Streaming, como cada chamada é sem estado, reiniciar o seu serviço não deixa nada quebrado para trás: o próximo pedido começa do zero e tudo funciona. Com o SSE, a ligação persistente pode quebrar a meio do caminho e tem de decidir o que acontece a uma chamada que iniciou mas cujo resultado nunca regressou — repeti-la, abandoná-la ou reportar um erro ao utilizador.

Fique tranquilo, no entanto: em ambos os casos, a API da xAI gere a ligação ao servidor MCP, não si. Não implementa nem o protocolo nem a reconexão. Basta fornecer o URL do servidor; estas considerações apenas afetam a forma como interpreta um erro ou dimensiona os tempos limite da sua aplicação.

Pontos-chave

  • A xAI suporta dois transportes MCP: HTTP em Streaming e SSE, ambos sobre HTTPS
  • O HTTP em Streaming é o transporte moderno, sem estado e compatível com a infraestrutura web padrão
  • O SSE mantém uma ligação persistente, útil para chamadas frequentes mas mais frágil
  • O transporte é determinado pelo servidor MCP, não pela sua configuração
  • stdio, HTTP simples e WebSocket não são suportados para MCP remoto