Tipos de Servidores MCP: STDIO, SSE e OAuth
Nesta página
Atualizado em 2 de novembro de 2026 — O Le Chat é agora o Vibe. Desde 28 de maio de 2026, o Le Chat foi renomeado para Vibe (ainda em chat.mistral.ai): um único agente para trabalho e código, que mantém as suas conversas, definições e subscrições. A experiência legada do Le Chat permanece acessível no modo Chat; no modo Work, os agentes tornaram-se competências (invocadas com
@), as memórias transformaram-se na base de conhecimento e a pesquisa profunda converteu-se na competência Deep Research. Os planos designam-se agora por Mistral Free, Pro, Team e Enterprise. Esta lição utiliza o nome Vibe; alguns menus aqui descritos podem ter alterado de nome ou de localização.
Dois modos de transporte, duas arquiteturas
Um servidor MCP comunica com o seu cliente de duas formas fundamentalmente diferentes, consoante seja executado na mesma máquina ou num servidor remoto. Esta distinção não é um pormenor de implementação: determina quem pode consumir o seu servidor, como o implementa e a que dados este pode aceder. Tomar esta decisão cedo poupa-o de reescrever o seu projeto a meio do caminho.
STDIO: o servidor que vive na sua máquina
O STDIO (Standard Input/Output) é o transporte local. O servidor MCP é executado na mesma máquina que o cliente e a comunicação flui através dos fluxos padrão do sistema operativo: stdin e stdout. O mecanismo é direto: o cliente inicia o processo do servidor, envia pedidos via stdin, lê as respostas do stdout e termina o processo quando a conversa termina. Sem portas, sem URLs, sem certificados.
Este transporte é a escolha natural sempre que uma ferramenta precisa de tocar no ambiente local. Um servidor que lê os seus ficheiros, chama o git, gere o Docker ou inspeciona uma base de dados SQLite no seu disco só faz sentido no modo STDIO. É também o modo preferido para integrações em editores como o VS Code ou o Cursor, e o companheiro óbvio para a fase de desenvolvimento, onde deseja reiniciar o seu servidor a cada trinta segundos.
from mcp import StdioServerParameters
server_params = StdioServerParameters(
command="python",
args=["my_mcp_server.py"],
env=None, # Optional environment variables
)
A contrapartida é estrita: o servidor e o cliente devem coexistir. Não pode ligar um servidor STDIO ao Mistral Vibe, uma vez que o Vibe é executado na infraestrutura da Mistral e não tem forma de iniciar um processo na sua máquina.
SSE e Streamable HTTP: servidores remotos
Para ir além da máquina local, o MCP utiliza HTTP. Duas variantes sucederam-se e é útil saber qual está a observar ao ler código existente.
O SSE (Server-Sent Events) foi o primeiro transporte remoto do protocolo. Permitia ao servidor transmitir eventos para o cliente, que por sua vez tinha de fazer pedidos POST separados para responder ao servidor. A sua falha estrutural: exigia uma ligação persistente entre os dois, complicando a hospedagem sem servidor (serverless) e a escalabilidade. Está agora obsoleto — o SDK da Mistral ainda fornece MCPClientSSE para endpoints /sse existentes, mas os novos servidores não devem ser construídos com base nisso.
O Streamable HTTP substituiu-o como transporte remoto padrão. Remove a exigência de uma ligação persistente: o cliente envia pedidos HTTP padrão e o servidor responde via streaming ou num único bloco, conforme necessário. Na prática, o seu servidor remoto expõe um endpoint /mcp ao qual o cliente se liga.
from mistralai.extra.mcp.streamable_http import (
MCPClientStreamableHTTP,
StreamableHTTPServerParams,
)
# Connect to a remote MCP server
server_url = "https://my-server.example.com/mcp"
mcp_client = MCPClientStreamableHTTP(
params=StreamableHTTPServerParams(url=server_url, timeout=100)
)
Três níveis de autenticação
O transporte indica onde o servidor reside; a autenticação indica quem tem permissão para o chamar. São questões independentes e o protocolo suporta três respostas.
A mais simples é sem autenticação: qualquer pessoa que conheça a URL pode utilizar as suas ferramentas. Esta escolha só é defensável para ferramentas públicas sem dados sensíveis — um conversor de unidades, um raspador web, uma calculadora.
Segue-se o token, ou chave de API. Gera um token com permissões específicas e passa-o ao cliente, que o inclui nos seus pedidos. O GitHub ilustra bem este modelo: cria um Personal Access Token selecionando apenas os scopes de que o seu agente realmente precisa, e nada mais.
O terceiro nível é o OAuth 2.0, o fluxo completo com um ecrã de consentimento. O utilizador autoriza explicitamente a aplicação a agir em sua conta e o servidor recebe um token ligado a essa pessoa. É o que o Gmail, o Linear ou o Google Calendar fazem quando os liga no Vibe — e é o único modelo aceitável assim que um servidor lida com dados pessoais de múltiplos utilizadores.
| Critério | STDIO (Local) | SSE / Streamable HTTP (Remoto) | OAuth (Remoto + Auth) |
|---|---|---|---|
| Transporte | stdin / stdout | HTTP (streaming opcional) | Fluxo HTTP + OAuth 2.0 |
| Localização | Mesma máquina | Servidor remoto | Servidor remoto |
| Autenticação | Nenhuma (mesma máquina) | Nenhuma ou token | OAuth 2.0 completo |
| Clientes compatíveis | IDEs, SDKs locais | Todos (Vibe, SDKs, IDEs) | Todos (Vibe, SDKs, IDEs) |
| Casos de uso | Ficheiros locais, CLI, dev | APIs públicas, scraping | GitHub, Gmail, Linear |
| Ligação persistente | Sim (processo ativo) | Não (Streamable HTTP) | Não (Streamable HTTP) |
Como decidir na prática
A decisão resume-se a duas perguntas feitas por ordem. O servidor é executado na mesma máquina que o cliente? Se sim, escolha STDIO. Se não, escolha Streamable HTTP, com ou sem autenticação, dependendo da sensibilidade dos dados tratados.
Tenha em mente a restrição do lado do cliente: o Mistral Vibe e os chatbots alojados em geral consomem apenas servidores remotos. Um IDE como o VS Code ou o Cursor, no entanto, aceita ambos os modos — daí o hábito confortável de desenvolver em STDIO e depois mudar para HTTP quando chega a altura de partilhar o servidor.
Pontos-chave
- STDIO = servidor local, mesma máquina, perfeito para desenvolvimento
- Streamable HTTP = servidor remoto, padrão atual, substitui o SSE
- Três níveis de auth: nenhum, token, OAuth 2.0
- O Mistral Vibe suporta apenas servidores remotos
- A sua escolha de transporte depende da sua arquitetura de implementação