Sistemas de agentes e padrões · Capítulo 1 de 8
MCP: ferramentas de um servidor
Como um agente encontra e chama ferramentas em um servidor MCP, e como o protocolo 2026-07-28 pergunta a uma pessoa antes de uma chamada arriscada.
Objetivos
- Execute o cenário até o reembolso ser emitido.A fazer
- Responda você mesmo à confirmação do helpdesk.A fazer
- Adultere uma mensagem e veja o SDK real rejeitá-la.A fazer
- Passe na verificação.A fazer
Passo 1 de 4: A leitura
Hosts, clientes e servidores
O Model Context Protocol (MCP) é um padrão aberto para conectar aplicações de IA a ferramentas e dados. A aplicação, chamada de host, roda um cliente MCP para cada servidor que usa. Um servidor oferece ferramentas (ações que o modelo pode chamar), recursos (dados que a aplicação pode ler) e prompts (modelos que uma pessoa pode escolher). As mensagens são JSON-RPC 2.0, via HTTP ou via a entrada e saída padrão de um processo local (stdio).
No agente da trilha anterior, as ferramentas eram funções no seu código. Com MCP, elas vivem em um servidor que outra pessoa pode escrever e rodar, e qualquer host MCP pode usá-las.
O que a 2026-07-28 mudou
Este capítulo usa a versão 2026-07-28 do protocolo com o SDK oficial de TypeScript v2. Você vai ver três mudanças no fio.
Descoberta: o cliente chama server/discover para conhecer as versões e capacidades do servidor. Servidores nas versões de 2025 respondem a initialize, e o SDK recorre a ele.
Uma versão em cada requisição: cada requisição leva a versão do protocolo em _meta, então o servidor não guarda sessão, e qualquer instância dele pode responder a qualquer requisição.
Resposta necessária: quando uma ferramenta precisa da resposta de uma pessoa, o servidor encerra a requisição com input_required, a pergunta e um requestState assinado. O cliente pergunta à pessoa e chama a ferramenta de novo com a resposta e o mesmo requestState. O servidor confere a assinatura, então a nova tentativa precisa corresponder ao que a pessoa viu.
Ferramentas são um contrato
O modelo vê apenas o nome, a descrição e o JSON Schema de uma ferramenta. Anotações como readOnlyHint e destructiveHint são dicas do servidor: um cliente confia nelas só na medida em que confia nesse servidor. O reembolso neste lab é seguro porque o próprio servidor pede uma confirmação e a confere, não porque o modelo se comporta bem.
O que você faz aqui
O agente de suporte da Halden, um agente LangChain com o cliente do SDK, e o helpdesk da Halden, o servidor do SDK, rodam nesta página. Execute o cenário e responda você mesmo à pergunta do reembolso. Depois ative Interceptar, retenha uma mensagem e adultere-a: o código real do SDK a rejeita.
Passo 2 de 4: Experimente: O fio: um agente e um helpdesk MCP
O fio: um agente e um helpdesk MCP
Quatro passos, uma ação cada, e um quinto opcional. O diagrama abaixo dos passos tem uma coluna por participante e uma linha por mensagem, na ordem em que é enviada, de cima para baixo.
Carregando o visual…
Modo:RealSimuladoReal: o SDK oficial de TypeScript do MCP (v2, protocolo 2026-07-28), cliente e servidor, roda nesta página. Simulado: as decisões do agente são roteirizadas, a menos que você conecte um modelo, e os dados da Halden são fictícios.
Passo 3 de 4: Verificação
Verificação
Próximo: Pergunta 2 de 4
Passo 4 de 4: O que você já sabe fazer
O que você já sabe fazer
- Descrever um host, um cliente e um servidor MCP, e as três coisas que um servidor oferece.
- Seguir o fluxo 2026-07-28: server/discover, tools/list, tools/call, input_required e a nova tentativa.
- Explicar por que um requestState assinado mantém uma confirmação vinculada ao que a pessoa viu.
- Tratar anotações de ferramentas como dicas, não como garantias.