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

Tipos de Servidores MCP: STDIO, SSE e OAuth

Aula 2 de 14 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. Dois modos de transporte, duas arquiteturas
  2. STDIO: o servidor que vive na sua máquina
  3. SSE e Streamable HTTP: servidores remotos
  4. Três níveis de autenticação
  5. Como decidir na prática
  6. Pontos-chave

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érioSTDIO (Local)SSE / Streamable HTTP (Remoto)OAuth (Remoto + Auth)
Transportestdin / stdoutHTTP (streaming opcional)Fluxo HTTP + OAuth 2.0
LocalizaçãoMesma máquinaServidor remotoServidor remoto
AutenticaçãoNenhuma (mesma máquina)Nenhuma ou tokenOAuth 2.0 completo
Clientes compatíveisIDEs, SDKs locaisTodos (Vibe, SDKs, IDEs)Todos (Vibe, SDKs, IDEs)
Casos de usoFicheiros locais, CLI, devAPIs públicas, scrapingGitHub, Gmail, Linear
Ligação persistenteSim (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