Servidor MCP do seu serviço|INEMA.CLUB-PRO

Formação WebMCP · curso 1 de 6 · 8 aulas

Servidor MCP do seu serviço, testado e na revisão vigente

Ferramentas que o agente chama, com confirmação quando há consequência, token quando é remoto e teste automático no fim. Tudo na revisão 2026-07-28 do MCP, com o SDK oficial (v2, 2.3.1), num kit que roda na sua máquina sem custo e sem chave.

Começar pela aula 1 Ver a área da formação
Servidor MCP do seu serviço: um notebook com terminal e um pequeno servidor com cabo plugado, numa mesa escura.
  • 8aulas curtas
  • 2026-07-28revisão do MCP ensinada
  • 2.3.1versão do SDK oficial no kit
  • 0chaves de API e custo

As aulas

Cada aula termina num comando que você roda e numa saída que confere. O kit está no próprio repositório do curso.

  1. Aula 1 · 15 minAnatomia: ferramentas, recursos e prompts; cliente, servidor e transporteAntes de escrever código, separe as peças. O servidor MCP oferece três coisas (ferramentas, recursos e prompts), o cliente vive dentro do aplicativo com o modelo, e o transporte é só o cano. Nesta aula você liga um cliente ao servidor do kit e vê cada peça listada.
  2. Aula 2 · 20 minPrimeiro servidor stdio com o SDK oficial, testado no InspectorO jeito mais simples de ligar um serviço a um agente é o stdio: o cliente inicia o seu programa e conversa pelo stdin e stdout. Nesta aula você instala o kit com versões fixas, lê o servidor de turmas e chama a ferramenta de dois jeitos: por um cliente de teste e pelo MCP Inspector em modo linha de comando.
  3. Aula 3 · 20 minDesenhar boa ferramenta: nome, descrição, JSON Schema, idempotência, só-leitura × com consequênciaO modelo escolhe a ferramenta lendo nome, descrição e esquema; o cliente decide se pede aprovação lendo as anotações. Ferramenta mal desenhada é chamada na hora errada ou com argumento errado. Nesta aula você confere, com um script, se as suas ferramentas dizem o que fazem e o que mudam.
  4. Aula 4 · 20 minStreamable HTTP sem estado: server/discover, cabeçalhos Mcp-Method e Mcp-NamePara o serviço atender vários clientes numa URL, o transporte é o Streamable HTTP. Na revisão 2026-07-28 ele ficou sem estado: nenhuma sessão para guardar, cada pedido carrega o que precisa. Nesta aula você sobe o mesmo servidor por HTTP e conversa com ele com curl, inclusive errando de propósito.
  5. Aula 5 · 20 minPedir dado ao usuário no meio da chamada: MRTR (InputRequiredResult)Reservar, pagar, apagar: ação com consequência pede um sim de uma pessoa. Na revisão 2026-07-28 o servidor não abre mais um pedido próprio para perguntar. Ele devolve input_required, o cliente pergunta ao usuário e repete a chamada com a resposta. Nesta aula você vê as duas voltas e o caminho do não.
  6. Aula 6 · 20 minAutorização: OAuth com iss (RFC 9207), escopo mínimo, segredo fora do repoServidor HTTP na internet sem token é ferramenta aberta para qualquer um. No MCP o seu servidor é um resource server do OAuth: ele não emite token, só confere. Nesta aula você protege o servidor do kit, vê o 401 que inicia o login do cliente e dá a cada token só o escopo que ele precisa.
  7. Aula 7 · 15 minMCP Apps: interface dentro do cliente (extensão oficial)Às vezes texto não basta: uma lista com cores, um gráfico, um formulário. MCP Apps é a extensão oficial que liga uma ferramenta a uma página HTML que o cliente desenha num iframe isolado. Nesta aula você liga um painel à ferramenta ver_turmas e confere o vínculo sem precisar abrir um cliente.
  8. Aula 8 · 20 minConectar ao Claude Code/Codex, testes automáticos e Registry (preview)Servidor pronto é servidor que o seu agente usa e que um teste confere a cada mudança. Nesta aula você roda a bateria automática do kit, liga o servidor ao Claude Code e ao Codex da sua assinatura e prepara o server.json do Registry oficial, que ainda está em preview. Fecha com o mapa e o seu plano.

Para quem é

  1. 1Dev que roda Node e terminal e quer que o seu serviço seja usado por agentes (Claude Code, Codex e outros clientes MCP).
  2. 2Quem tem um servidor MCP feito em 2025 com SSE, sessão e initialize e precisa saber o que mudou.
  3. 3Quem prefere Python: os conceitos valem igual; o curso usa Node (o SDK Python mcp 2.3.0 contém server/discover no código, sem prática aqui).

O que você sai fazendo

  1. 1Um servidor com ferramenta só de leitura, ferramenta com consequência, recurso e prompt.
  2. 2O mesmo código por stdio e por Streamable HTTP sem estado, com guarda de Host e Origin.
  3. 3Confirmação do usuário no meio da chamada (MRTR) e token com escopo mínimo por ferramenta.
  4. 4Uma interface MCP Apps, a bateria de testes e o servidor ligado ao Claude Code e ao Codex.

Onde este curso entra na Formação WebMCP

  1. 1Curso 0 mostra como os agentes usam um site; este é o lado do servidor (backend).
  2. 2Curso 2 leva ferramentas para dentro da página com WebMCP; curso 4 aprofunda as ameaças.
  3. 3Ameaças de loop autônomo e evals a fundo ficam na Formação LOOP-R Engenharia.