Siga estes passos para começar a usar estes recursos:
- Faça um Fork do Repositório: Clique em
- Clone o Repositório:
git clone https://github.com/microsoft/mcp-for-beginners.git - Junte-se ao
Árabe | Bengali | Búlgaro | Birmanês (Myanmar) | Chinês (Simplificado) | Chinês (Tradicional, Hong Kong) | Chinês (Tradicional, Macau) | Chinês (Tradicional, Taiwan) | Croata | Tcheco | Dinamarquês | Holandês | Estoniano | Finlandês | Francês | Alemão | Grego | Hebraico | Hindi | Húngaro | Indonésio | Italiano | Japonês | Kannada | Khmer | Coreano | Lituano | Malaio | Malaiala | Marata | Nepali | Pidgin Nigeriano | Norueguês | Persa (Farsi) | Polonês | Português (Brasil) | Português (Portugal) | Punjabi (Gurmukhi) | Romeno | Russo | Sérvio (Cirílico) | Eslovaco | Esloveno | Espanhol | Suaíli | Sueco | Tagalog (Filipino) | Tâmil | Telugu | Tailandês | Turco | Ucraniano | Urdu | Vietnamita
Prefere Clonar Localmente?
Este repositório inclui traduções em mais de 50 idiomas, o que aumenta significativamente o tamanho do download. Para clonar sem as traduções, use o sparse checkout:
Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git cd mcp-for-beginners git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git cd mcp-for-beginners git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"Isso fornece tudo o que você precisa para completar o curso com um download muito mais rápido.
Bem-vindo à sua jornada no Model Context Protocol! Se você já se perguntou como aplicações de IA se comunicam com diferentes ferramentas e serviços, está prestes a descobrir a solução elegante que está transformando a forma como desenvolvedores criam sistemas inteligentes.
Pense no MCP como um tradutor universal para aplicações de IA - assim como as portas USB permitem conectar qualquer dispositivo ao seu computador, o MCP permite que modelos de IA se conectem a qualquer ferramenta ou serviço de forma padronizada. Seja criando seu primeiro chatbot ou trabalhando em fluxos complexos de IA, compreender o MCP lhe dará o poder de criar aplicações mais capazes e flexíveis.
Este currículo foi elaborado com paciência e cuidado para sua jornada de aprendizado. Começaremos com conceitos simples que você já entende e, gradativamente, construiremos sua expertise por meio de prática direta em sua linguagem de programação favorita. Cada etapa inclui explicações claras, exemplos práticos e bastante incentivo ao longo do caminho.
Quando concluir esta jornada, você terá a confiança para construir seus próprios servidores MCP, integrá-los com plataformas populares de IA e entender como essa tecnologia está remodelando o futuro do desenvolvimento de IA. Vamos iniciar esta aventura empolgante juntos!
Este currículo está alinhado com a Especificação MCP 2025-11-25 (a versão estável mais recente). A especificação MCP usa controle de versão por data (formato AAAA-MM-DD) para garantir rastreamento claro das versões do protocolo.
Estes recursos se tornam mais valiosos à medida que sua compreensão cresce, mas não sinta a pressão de ler tudo imediatamente. Comece pelas áreas que mais lhe interessam!
- 📘 Documentação MCP – Este é seu recurso principal para tutoriais passo a passo e guias do usuário. A documentação é escrita pensando em iniciantes, fornecendo exemplos claros que você pode acompanhar no seu ritmo.
- 📜 Especificação MCP – Pense nisso como seu manual de referência abrangente. Conforme avança no currículo, você irá voltar aqui para consultar detalhes específicos e explorar recursos avançados.
- 📜 Controle de Versão da Especificação MCP – Contém informações sobre o histórico de versões do protocolo e como o MCP usa controle de versão por data (formato AAAA-MM-DD).
- 🧑💻 Repositório MCP no GitHub – Aqui você encontrará SDKs, ferramentas e exemplos de código em múltiplas linguagens de programação. É como um tesouro de exemplos práticos e componentes prontos para uso.
- 🌐 Comunidade MCP – Junte-se a outros aprendizes e desenvolvedores experientes em discussões sobre MCP. É uma comunidade acolhedora onde perguntas são bem-vindas e o conhecimento é compartilhado livremente.
Ao final deste currículo, você se sentirá confiante e entusiasmado com suas novas habilidades. Veja o que você alcançará:
• Entender os fundamentos do MCP: Você compreenderá o que é o Model Context Protocol e por que ele está revolucionando como aplicações de IA funcionam juntas, usando analogias e exemplos que fazem sentido.
• Construir seu primeiro servidor MCP: Criará um servidor MCP funcional na sua linguagem de programação preferida, começando com exemplos simples e desenvolvendo suas habilidades passo a passo.
• Conectar modelos de IA a ferramentas reais: Aprenderá como preencher a lacuna entre modelos de IA e serviços reais, dando às suas aplicações capacidades poderosas.
• Implementar melhores práticas de segurança: Entenderá como manter suas implementações MCP seguras, protegendo tanto suas aplicações quanto seus usuários.
• Fazer deploy com confiança: Saberá como levar seus projetos MCP do desenvolvimento para produção, com estratégias práticas de implantação que funcionam no mundo real.
• Participar da comunidade MCP: Tornar-se-á parte de uma comunidade crescente de desenvolvedores que estão moldando o futuro do desenvolvimento de aplicações de IA.
Antes de mergulharmos nas especificidades do MCP, vamos garantir que você se sinta confortável com alguns conceitos fundamentais. Não se preocupe se não for especialista nessas áreas - explicaremos tudo que você precisa saber ao longo do percurso!
Pense em um protocolo como as regras de uma conversa. Quando você liga para um amigo, ambos sabem dizer "olá" ao atender, tomar a vez para falar e dizer "tchau" quando terminam. Programas de computador precisam de regras semelhantes para se comunicar efetivamente.
MCP é um protocolo - um conjunto de regras acordadas que ajudam modelos e aplicações de IA a terem "conversas" produtivas com ferramentas e serviços. Assim como regras de conversa tornam a comunicação humana mais fluida, ter MCP torna a comunicação entre aplicações de IA muito mais confiável e poderosa.
Você já usa relações cliente-servidor todo dia! Quando usa um navegador (cliente) para visitar um site, está se conectando a um servidor web que envia o conteúdo da página. O navegador sabe como pedir informação, e o servidor sabe como responder.
No MCP, temos uma relação parecida: modelos de IA atuam como clientes que solicitam informações ou ações, enquanto servidores MCP fornecem essas capacidades. É como ter um assistente útil (o servidor) que a IA pode pedir para executar tarefas específicas.
Imagine se cada fabricante de carro usasse bombas de gasolina de formato diferente - você precisaria de um adaptador diferente para cada carro! Padronização significa concordar em métodos comuns para que as coisas funcionem juntas sem problemas.
O MCP fornece essa padronização para aplicações de IA. Em vez de cada modelo precisar de código personalizado para trabalhar com cada ferramenta, o MCP cria uma forma universal para que se comuniquem. Isso significa que desenvolvedores podem construir ferramentas uma vez só e fazê-las funcionar com vários sistemas diferentes de IA.
Sua jornada com MCP é cuidadosamente estruturada para construir sua confiança e habilidades progressivamente. Cada fase apresenta novos conceitos enquanto reforça o que você já aprendeu.
Aqui começa sua aventura! Vamos apresentar conceitos do MCP usando analogias familiares e exemplos simples. Você entenderá o que é MCP, por que ele existe e como ele se encaixa no grande mundo do desenvolvimento de IA.
• Módulo 0 - Introdução ao MCP: Começaremos explorando o que é o MCP e por que ele é tão importante para aplicações modernas de IA. Você verá exemplos reais do MCP em ação e entenderá como ele resolve problemas comuns enfrentados por desenvolvedores.
• Módulo 1 - Conceitos Centrais Explicados: Aqui você aprenderá os blocos de construção essenciais do MCP. Usaremos muitas analogias e exemplos visuais para garantir que estes conceitos pareçam naturais e compreensíveis.
• Módulo 2 - Segurança no MCP: Segurança pode parecer intimidadora, mas mostraremos como o MCP inclui recursos de segurança embutidos e ensinaremos melhores práticas para proteger suas aplicações desde o início.
Agora começa a diversão de verdade! Você terá experiência prática construindo servidores e clientes MCP reais. Não se preocupe - começaremos simples e guiaremos você em cada etapa.
Este módulo inclui vários guias práticos que permitem praticar na sua linguagem de programação preferida. Você criará seu primeiro servidor, construirá um cliente para se conectar a ele e até integrará com ferramentas de desenvolvimento populares como o VS Code.
Cada guia inclui exemplos de código completos, dicas para solução de problemas e explicações sobre por que fazemos escolhas de design específicas. Ao final desta fase, você terá implementações MCP funcionando das quais poderá se orgulhar!
Com o básico dominado, você está pronto para explorar recursos mais sofisticados do MCP. Cobriremos estratégias práticas de implementação, técnicas de depuração e tópicos avançados como integração de IA multimodal.
Você também aprenderá a escalar suas implementações MCP para uso em produção e a integrar com plataformas de nuvem como Azure. Esses módulos preparam você para construir soluções MCP que suportam demandas do mundo real.
A fase final foca em ingressar na comunidade MCP e se especializar em áreas que mais lhe interessam. Você aprenderá a contribuir para projetos MCP open source, implementar padrões avançados de autenticação e construir soluções completas integradas a bancos de dados.
O Módulo 11 merece destaque - é um caminho de aprendizado prático com 13 laboratórios que ensina a construir servidores MCP prontos para produção com integração PostgreSQL. É como um projeto final que une tudo o que você aprendeu!
| Módulo | Tópico | Descrição | Link |
|---|---|---|---|
| Módulos 0-3: Fundamentos | |||
| 00 | Introdução ao MCP | Visão geral do Protocolo de Contexto de Modelo e sua importância em pipelines de IA | Leia mais |
| 01 | Conceitos Básicos Explicados | Exploração aprofundada dos conceitos centrais do MCP | Leia mais |
| 02 | Segurança no MCP | Ameaças de segurança e melhores práticas | Leia mais |
| 03 | Começando com MCP | Configuração do ambiente, servidores/clientes básicos, integração | Leia mais |
| Módulo 3: Construindo Seu Primeiro Servidor & Cliente | |||
| 3.1 | Primeiro Servidor | Crie seu primeiro servidor MCP | Guia |
| 3.2 | Primeiro Cliente | Desenvolva um cliente MCP básico | Guia |
| 3.3 | Cliente com LLM | Integre modelos de linguagem grandes | Guia |
| 3.4 | Integração VS Code | Consuma servidores MCP no VS Code | Guia |
| 3.5 | Servidor stdio | Crie servidores usando transporte stdio | Guia |
| 3.6 | Streaming HTTP | Implemente streaming HTTP no MCP | Guia |
| 3.7 | AI Toolkit | Use AI Toolkit com MCP | Guia |
| 3.8 | Testes | Teste sua implementação de servidor MCP | Guia |
| 3.9 | Implantação | Faça deploy dos servidores MCP para produção | Guia |
| 3.10 | Uso avançado de servidores | Use servidores avançados para funcionalidades avançadas e melhor arquitetura | Guia |
| 3.11 | Autenticação simples | Um capítulo mostrando autenticação desde o início e RBAC | Guia |
| 3.12 | Hosts MCP | Configure Claude Desktop, Cursor, Cline e outros hosts MCP | Guia |
| 3.13 | MCP Inspector | Debugue e teste servidores MCP com a ferramenta Inspector | Guia |
| 3.14 | Amostragem | Use amostragem para colaborar com o cliente | Guia |
| 3.15 | Apps MCP | Construa Apps MCP | Guia |
| Módulos 4-5: Prático & Avançado | |||
| 04 | Implementação Prática | SDKs, depuração, testes, templates de prompt reutilizáveis | Leia mais |
| 4.1 | Paginação | Manipule grandes conjuntos de resultados com paginação baseada em cursor | Guia |
| 05 | Tópicos Avançados no MCP | IA multimodal, escalabilidade, uso empresarial | Leia mais |
| 5.1 | Integração Azure | Integração MCP com Azure | Guia |
| 5.2 | Multimodalidade | Trabalhando com múltiplas modalidades | Guia |
| 5.3 | Demo OAuth2 | Implemente autenticação OAuth2 | Guia |
| 5.4 | Contextos Raiz | Compreenda e implemente contextos raiz | Guia |
| 5.5 | Roteamento | Estratégias de roteamento MCP | Guia |
| 5.6 | Amostragem | Técnicas de amostragem no MCP | Guia |
| 5.7 | Escalabilidade | Escale implementações MCP | Guia |
| 5.8 | Segurança | Considerações avançadas de segurança | Guia |
| 5.9 | Busca Web | Implemente funcionalidades de busca web | Guia |
| 5.10 | Streaming em tempo real | Construa funcionalidade de streaming em tempo real | Guia |
| 5.11 | Busca em tempo real | Implemente buscas em tempo real | Guia |
| 5.12 | Autenticação Entra ID | Autenticação com Microsoft Entra ID | Guia |
| 5.13 | Integração Foundry | Integre com Azure AI Foundry | Guia |
| 5.14 | Engenharia de Contexto | Técnicas para engenharia de contexto eficaz | Guia |
| 5.15 | Transporte Customizado MCP | Implementações customizadas de transporte | Guia |
| 5.16 | Recursos do Protocolo | Notificações de progresso, cancelamento, templates de recursos | Guia |
| Módulos 6-10: Comunidade & Melhores Práticas | |||
| 06 | Contribuições da Comunidade | Como contribuir para o ecossistema MCP | Guia |
| 07 | Aprendizados da Adoção Inicial | Histórias de implementação no mundo real | Guia |
| 08 | Melhores Práticas para MCP | Performance, tolerância a falhas, resiliência | Guia |
| 09 | Estudos de Caso MCP | Exemplos práticos de implementação | Guia |
| 10 | Oficina Prática | Construindo um Servidor MCP com AI Toolkit | Lab |
| Módulo 11: Laboratório Prático de Servidor MCP | |||
| 11 | Integração de Servidor MCP com Banco de Dados | Caminho prático completo com 13 laboratórios para integração PostgreSQL | Labs |
| 11.1 | Introdução | Visão geral do MCP com integração de banco de dados e caso de uso em varejo | Lab 00 |
| 11.2 | Arquitetura Central | Compreensão da arquitetura do servidor MCP, camadas de banco e padrões de segurança | Lab 01 |
| 11.3 | Segurança & Multi-Tenancy | Segurança por nível de linha, autenticação e acesso a dados multi-inquilino | Lab 02 |
| 11.4 | Configuração do Ambiente | Configuração do ambiente de desenvolvimento, Docker, recursos Azure | Lab 03 |
| 11.5 | Design de Banco de Dados | Configuração PostgreSQL, design do esquema varejo e dados de exemplo | Lab 04 |
| 11.6 | Implementação do Servidor MCP | Construção do servidor FastMCP com integração de banco de dados | Lab 05 |
| 11.7 | Desenvolvimento de Ferramentas | Criação de ferramentas de consulta de banco e introspecção de esquema | Lab 06 |
| 11.8 | Busca Semântica | Implementação de embeddings vetoriais com Azure OpenAI e pgvector | Lab 07 |
| 11.9 | Testes & Depuração | Estratégias de teste, ferramentas de depuração e abordagens de validação | Lab 08 |
| 11.10 | Integração VS Code | Configuração da integração MCP no VS Code e uso do AI Chat | Lab 09 |
| 11.11 | Estratégias de Implantação | Deploy com Docker, Azure Container Apps e considerações de escalabilidade | Lab 10 |
| 11.12 | Monitoramento | Application Insights, logging, monitoramento de performance | Lab 11 |
| 11.13 | Melhores Práticas | Otimização de performance, reforço de segurança e dicas para produção | Lab 12 |
Uma das partes mais empolgantes de aprender MCP é ver suas habilidades em código se desenvolverem progressivamente. Projetamos nossos exemplos de código para começar simples e se tornarem mais sofisticados conforme seu entendimento cresce. Veja como introduzimos os conceitos - com código fácil de entender, mas que demonstra princípios reais do MCP, você entenderá não só o que esse código faz, mas por que ele é estruturado assim e como se encaixa em aplicações MCP maiores.
| Linguagem | Descrição | Link |
|---|---|---|
| C# | Exemplo de Servidor MCP | Ver Código |
| Java | Calculadora MCP | Ver Código |
| JavaScript | Demo MCP | Ver Código |
| Python | Servidor MCP | Ver Código |
| TypeScript | Exemplo MCP | Ver Código |
| Rust | Exemplo MCP | Ver Código |
| Linguagem | Descrição | Link |
|---|---|---|
| C# | Exemplo Avançado | Ver Código |
| Java com Spring | Exemplo Container App | Ver Código |
| JavaScript | Exemplo Avançado | Ver Código |
| Python | Implementação Complexa | Ver Código |
| TypeScript | Exemplo de Container | Ver Código |
Para aproveitar ao máximo este currículo, você deve ter:
-
Conhecimento básico de programação em pelo menos uma das seguintes linguagens: C#, Java, JavaScript, Python ou TypeScript
-
Compreensão do modelo cliente-servidor e APIs
-
Familiaridade com conceitos de REST e HTTP
-
(Opcional) Conhecimento prévio em conceitos de IA/ML
-
Participação em nossas discussões comunitárias para suporte
Este repositório inclui vários recursos para ajudá-lo a navegar e aprender de forma eficaz:
Um Guia de Estudo abrangente está disponível para ajudá-lo a navegar neste repositório de maneira eficaz. Este mapa visual do currículo mostra como todos os tópicos se conectam e fornece orientações sobre como usar os projetos de exemplo de maneira eficaz. É especialmente útil se você for um aprendiz visual que gosta de ver o panorama geral.
O guia inclui:
- Um mapa visual do currículo mostrando todos os tópicos abordados
- Detalhamento de cada seção do repositório
- Orientações sobre como usar os projetos de exemplo
- Caminhos de aprendizado recomendados para diferentes níveis de habilidade
- Recursos adicionais para complementar sua jornada de aprendizado
Mantemos um detalhado Registro de Alterações que acompanha todas as atualizações significativas nos materiais do currículo, para que você possa se manter atualizado com as últimas melhorias e adições.
- Novos conteúdos adicionados
- Mudanças estruturais
- Melhorias de recursos
- Atualizações na documentação
Cada aula neste guia inclui:
- Explicações claras dos conceitos MCP
- Exemplos de código ao vivo em várias linguagens
- Exercícios para construir aplicações reais em MCP
- Recursos extras para aprendizes avançados
Vamos aprender sobre o Model Context Protocol (MCP), uma estrutura inovadora projetada para padronizar as interações entre modelos de IA e aplicações clientes. Através desta sessão amigável para iniciantes, vamos apresentá-lo ao MCP e guiá-lo na criação do seu primeiro servidor MCP.
JavaScript: https://aka.ms/letslearnmcp-javascript
Parabéns! Você acaba de dar o primeiro passo em uma jornada empolgante que ampliará suas capacidades de programação e conectará você à vanguarda do desenvolvimento em IA.
Ao ler esta introdução, você já começou a construir sua base de conhecimento em MCP. Você entende o que é o MCP, por que ele é importante, e como este currículo apoiará sua jornada de aprendizado. Isso é uma conquista significativa e o início da sua expertise nessa tecnologia importante.
À medida que você avança pelos módulos, lembre-se de que todo especialista já foi iniciante. Os conceitos que parecem complexos agora se tornarão naturais conforme você pratica e aplica. Cada pequeno passo constrói capacidades poderosas que lhe servirão ao longo da sua carreira de desenvolvimento.
Você está entrando para uma comunidade de aprendizes e especialistas que são apaixonados por MCP e desejam ajudar outros a terem sucesso. Seja você travado em um desafio de codificação ou empolgado para compartilhar uma descoberta, a comunidade está aqui para apoiar sua jornada.
Se você ficar preso ou tiver dúvidas sobre como construir aplicativos de IA, junte-se a outros aprendizes e desenvolvedores experientes nas discussões sobre MCP. É uma comunidade acolhedora onde perguntas são bem-vindas e o conhecimento é compartilhado livremente.
Se você tiver feedback de produto ou erros ao construir, visite:
Sua aventura MCP começa agora! Comece pelo Módulo 0 para mergulhar em suas primeiras experiências práticas com MCP, ou explore os projetos de exemplo para ver o que você irá construir. Lembre-se - todo especialista começou exatamente onde você está agora e, com paciência e prática, você ficará impressionado com o que pode alcançar.
Bem-vindo ao mundo do desenvolvimento com Model Context Protocol. Vamos construir algo incrível juntos!
Este currículo cresce e se fortalece com as contribuições de aprendizes como você! Seja corrigindo um erro de digitação, sugerindo uma explicação mais clara ou adicionando um novo exemplo, suas contribuições ajudam outros iniciantes a terem sucesso.
Agradecimentos ao Microsoft Valued Professional Shivam Goyal pela contribuição com exemplos de código.
O processo de contribuição é projetado para ser acolhedor e de suporte. A maioria das contribuições exige um Acordo de Licença de Contribuidor (CLA), mas as ferramentas automatizadas irão guiá-lo pelo processo de forma simples.
Todo este currículo está disponível sob a licença MIT LICENSE, o que significa que você pode usar, modificar e compartilhar livremente. Isso apoia nossa missão de tornar o conhecimento sobre MCP acessível a desenvolvedores em todo o mundo.
Este projeto acolhe contribuições e sugestões. A maioria das contribuições requer que você concorde com um Acordo de Licença de Contribuidor (CLA) declarando que você tem o direito e de fato concede os direitos para usarmos sua contribuição. Para detalhes, visite https://cla.opensource.microsoft.com.
Quando você enviar um pull request, um bot da CLA determinará automaticamente se você precisa fornecer uma CLA e marcará o PR apropriadamente (ex.: verificação de status, comentário). Basta seguir as instruções fornecidas pelo bot. Você precisará fazer isso apenas uma vez para todos os repositórios que usam a nossa CLA.
Este projeto adotou o Código de Conduta Open Source da Microsoft. Para mais informações veja o FAQ do Código de Conduta ou contate opencode@microsoft.com para quaisquer dúvidas ou comentários adicionais.
Pronto para iniciar sua jornada MCP? Comece pelo Módulo 00 - Introdução ao MCP e dê seus primeiros passos no mundo do desenvolvimento Model Context Protocol!
Nossa equipe produz outros cursos! Confira:
-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA){kind=icon}
-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC){kind=icon}
-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9){kind=icon}
Aviso Legal:
Este documento foi traduzido usando o serviço de tradução por IA Co-op Translator. Embora nos empenhemos pela precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se tradução profissional realizada por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.