Como funciona o transporte stdio

Antes de conectar seu servidor a qualquer coisa, você precisa saber como ele realmente se comunica. O canal padrão é a entrada e saída padrão. 🔌

O nome entrada e saída padrão significa entrada padrão mais saída padrão: dois fluxos de texto que todo programa já possui desde o momento em que é iniciado.

Com a entrada e saída padrão, o host inicia seu servidor como um processo filho. Não há porta nem chamada de rede, apenas um programa local que ele controla.

O cliente escreve mensagens JSON-RPC na entrada padrão do servidor, e o servidor escreve suas respostas de volta pela saída padrão.

Você quase nunca inicia o script por conta própria. Você informa ao host um comando, e ele executa esse comando para iniciar seu servidor.

Como as respostas trafegam pela saída padrão, esse fluxo é reservado para o protocolo. Qualquer print indevido ali confundirá o JSON esperado pelo cliente.

Precisa deixar anotações para si? Envie-as para a saída de erro. O host trata esse fluxo como registros, para que sua depuração nunca toque no fluxo de mensagens.

Cada conexão de entrada e saída padrão é um vínculo privado: um cliente e um processo. Feche o cliente, e o processo do servidor será encerrado com ele.

A entrada e saída padrão é excelente para trabalhos locais. Não exige autenticação, firewall nem URL, o que a torna o transporte perfeito enquanto você desenvolve. 💻

O problema é que o servidor precisa estar na mesma máquina que o host. Para acessar um servidor remotamente, mais tarde você mudará para o transporte HTTP.

Cada mensagem JSON-RPC é uma única linha terminada por uma quebra de linha. Esse enquadramento permite que ambos os lados dividam o fluxo em mensagens separadas e organizadas.

Você viu como funciona a entrada e saída padrão: o host inicia seu processo, comunica-se pela entrada e saída padrão e mantém os registros na saída de erro. Agora vamos conectá-la ao Claude. ✅