Pular para o conteúdo

Tutoriais de MCP em português

Uma trilha curta, da primeira instalação ao seu próprio servidor. Cada tutorial traz a data e as versões com que foi testado, porque guia desatualizado atrapalha mais do que ajuda.

  1. Começo · 10 min

    Como instalar seu primeiro servidor MCP no Claude Desktop

    Do zero ao Claude lendo uma pasta do seu computador: instalar o Node.js, editar o arquivo de configuração e conferir que funcionou.

    Testado em com @modelcontextprotocol/server-filesystem 2026.8.31, Node.js 24.19, Windows 11.

  2. Intermediário · 20 min

    Como criar um servidor MCP em TypeScript

    Um servidor com uma ferramenta de verdade (validar CPF), do npm init ao teste no cliente, com o SDK oficial.

    Testado em com @modelcontextprotocol/server 2.3.0, zod 4.6.5, TypeScript 7.0.2, Node.js 24.19.

  3. Intermediário · 15 min

    Como criar um servidor MCP em Python

    O mesmo servidor de validação de CPF, agora com o SDK de Python e o uv: menos de 30 linhas.

    Testado em com mcp 2.3.0, Python 3.12.10, uv 0.12.15.

Antes da trilha

Se o termo ainda é novo, comece por O que é MCP: dez minutos de leitura sobre host, cliente, servidor e as três coisas que um servidor pode oferecer. Antes de instalar servidores de terceiros, leia Segurança no MCP.

Guias por cliente

O primeiro tutorial usa o Claude Desktop. Para os outros clientes, o caminho do arquivo e o formato mudam:

Perguntas frequentes

Por onde começo?

Pelo tutorial de instalação do primeiro servidor: em dez minutos você vê o assistente lendo uma pasta do seu computador. Depois, a página "O que é MCP" explica o que aconteceu, e os tutoriais de criação mostram como escrever o seu.

O que quer dizer "testado em" em cada tutorial?

Que o código da página foi executado naquela data, com as versões listadas. Quando alguma parte não foi testada por nós, como telas de um aplicativo, o tutorial diz isso.

TypeScript ou Python?

Os dois SDKs são oficiais e o servidor de exemplo é o mesmo. Use a linguagem em que a sua equipe já mantém código: o servidor vai conviver com o resto dos seus sistemas.

Continue por aqui