{"markdown": "Model Context Protocol na Prática"}
Traduzido com IA. Verificado por pessoas em inglês. Como fazemos os livros
Traduzido do livro em inglês, edição 2026.11.14. Leia o original
{"markdown": "Ferramentas e dados para agentes, para engenheiros que já conhecem APIs: o que o MCP acrescenta a uma API HTTP e quando ele é a escolha errada, e como projetar, construir, proteger, testar e executar servidores e clientes MCP na revisão 2026-07-28 da especificação, com o SDK Python, mcp 2.x, e um caminho de migração a partir das revisões de 2025."}
Para quem é Para engenheiros que criam ou consomem APIs HTTP e agora precisam dar ferramentas e dados a agentes, ou conectar um agente às de outra pessoa. Não é necessário ter conhecimento em aprendizado de máquina.
Leia no Kindle ou em qualquer leitor de e-books
O EPUB também funciona no Apple Books, no Kobo e na maioria dos leitores de e-books.
Enviar para o Kindle
Envia o EPUB desta edição em Português (Brasil).
-
Aprove o nosso endereço
A Amazon entrega no Kindle somente a partir de endereços que você aprovou, uma vez para cada serviço que envia e-mails a ele. Adicione o nosso à sua Lista de E-mails Aprovados para Documentos Pessoais.
books@rollingedition.comAbrir as Configurações de documentos pessoais da Amazon. Na Amazon, isso fica em Gerenciar seu conteúdo e dispositivos, Preferências, Configurações de documentos pessoais.
Enviado. Ele aparecerá na sua biblioteca do Kindle em alguns minutos.
Se não chegar, quase sempre o problema é a aprovação do passo 1: verifique se books@rollingedition.com está na sua Lista de E-mails Aprovados para Documentos Pessoais.
Cada nova edição dos seus livros salvos também será enviada para o seu Kindle.
Este não é um endereço do Kindle. Ele termina em @kindle.com: você o encontra em Configurações de Documentos Pessoais da Amazon.
Você enviou {count} livros hoje, o máximo que enviamos para uma conta em um dia. Tente novamente amanhã.
Enviamos todos os livros que podíamos hoje. Tente novamente amanhã.
O livro não foi enviado. Tente novamente em alguns minutos.
Esta edição é grande demais para enviar por e-mail.
Enviar para o Kindle vem com o Labs.
Este não é um endereço do Kindle. Ele termina em @kindle.com: você o encontra em Configurações de Documentos Pessoais da Amazon.
O livro não foi enviado. Tente novamente em alguns minutos.
Ou baixe o EPUB e envie-o na página Enviar para o Kindle da Amazon.
Kindle is a trademark of Amazon.com, Inc.
Sumário
12 capítulos, cerca de 7 horas 21 minutos de leitura, com 70 exemplos.
-
1MCP end to end
By the end of this chapter you can put an existing HTTP API behind a Model Context Protocol server over stdio, call its tool from a client, read every message the two exchange, and let a model choose the tool through a small host.
-
2O que o MCP acrescenta a uma API
Ao final deste capítulo, você saberá dizer o que o host, o cliente e o servidor fazem, colocar cada uma das capacidades da loja na primitiva correta do Model Context Protocol, ler a versão e as capacidades que toda requisição carrega, e decidir quando a loja deve manter uma API HTTP comum.
-
3Projete ferramentas que um modelo pode usar
Ao final deste capítulo, você saberá transformar a API da loja em ferramentas do Model Context Protocol cujos nomes, descrições, esquemas de entrada, resultados e erros um modelo consiga aproveitar, e medirá como uma mudança na descrição de uma ferramenta altera a ferramenta que um modelo escolhe.
-
4Serve data as resources and prompts
By the end of this chapter you can publish the shop's policies and records as Model Context Protocol resources, address many records with one resource template, complete an argument while a user types it, tell a client when a resource changes, and package a refund review as a prompt the user can pick.
-
5Ask the user in the middle of a call
By the end of this chapter you can make the shop's refund tool stop in the middle of a call, ask the person at the host to confirm a refund, and carry on with the answer, using Model Context Protocol elicitation inside a Multi Round-Trip Request on a server that keeps no call open while it waits.
-
6Servir via Streamable HTTP
Ao final deste capítulo, você será capaz de servir o servidor Model Context Protocol da loja via Streamable HTTP, ler o que cada requisição e cada resposta carregam, transmitir o progresso de uma chamada longa e cancelá-la, executar o servidor como réplicas atrás de um único endereço, sem sticky sessions, e recusar requisições que um navegador foi enganado para enviar.
-
7Run long work as tasks
By the end of this chapter you can negotiate a Model Context Protocol extension, run a slow restock report as a task that the client polls, let tasks expire and cancel them, and say what MCP Apps add to a tool.
-
8Autorize clientes com OAuth
Ao final deste capítulo, você será capaz de proteger o servidor Model Context Protocol da loja com OAuth.
-
9Proteja as ferramentas contra uso indevido
Ao fim deste capítulo, você será capaz de desenhar as fronteiras de confiança em torno de um servidor Model Context Protocol e de seu host, recusar o repasse de token, impedir que um servidor atue como delegado confuso (confused deputy), fixar as definições de ferramentas para que uma alterada seja detectada, tratar o texto de chamados como dados e pedir ao usuário antes de qualquer chamada de ferramenta com efeitos colaterais.
-
10Construa um host que atende tickets
Ao final deste capítulo, você será capaz de conectar um host a vários servidores do Model Context Protocol (MCP), dar às suas ferramentas nomes que não possam colidir, executar um laço curto em que um modelo chama ferramentas e lê seus resultados, responder às solicitações de entrada de um servidor em nome do usuário, colocar recursos no contexto do modelo e atender uma fila de tickets usando tudo isso.
-
11Teste um servidor e acompanhe sua execução
Ao final deste capítulo, você será capaz de testar as ferramentas de um servidor Model Context Protocol em memória e por HTTP, identificar uma mudança de esquema que quebraria os clientes antes de ela ser publicada, reproduzir uma execução gravada do host como teste de regressão, rastrear chamadas de ferramentas com OpenTelemetry, medir com que frequência um modelo escolhe a ferramenta certa e aposentar uma ferramenta sem quebrar os clientes que a usam.
-
12Migrar um servidor da era 2025
Ao final deste capítulo, você saberá migrar um servidor do Model Context Protocol escrito para as revisões de 2025 e para a linha 1.x do SDK de Python para a especificação na revisão 2026-07-28 e
mcp2.3.0.