Siga estes passos para começar a usar esses recursos:
- Faça um Fork do Repositório: Clique
- Clone o Repositório:
git clone https://github.com/microsoft/mcp-for-beginners.git - Participe do
Á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 | Canarês | Khmer | Coreano | Lituano | Malásio | 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 | Tagalo (Filipino) | Tâmil | Telugu | Tailandês | Turco | Ucraniano | Urdu | Vietnamita
Prefere Clonar Localmente?
Este repositório inclui mais de 50 traduções de idiomas que aumentam significativamente o tamanho do download. Para clonar sem as traduções, use checkout esparso:
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 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 constroem sistemas inteligentes.
Pense no MCP como um tradutor universal para aplicações de IA – assim como portas USB permitem conectar qualquer dispositivo ao computador, o MCP permite que modelos de IA se conectem a qualquer ferramenta ou serviço de forma padronizada. Seja construindo seu primeiro chatbot ou trabalhando em fluxos de IA complexos, entender 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á conhece e gradualmente construiremos sua expertise através de prática prática na sua linguagem favorita. Cada passo inclui explicações claras, exemplos práticos e muito incentivo no 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 em IA. Vamos começar 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 versionamento baseado em datas (formato AAAA-MM-DD) para garantir o acompanhamento claro da versão do protocolo.
Esses recursos serão mais valiosos conforme seu entendimento crescer, mas não se sinta pressionado a ler tudo imediatamente. Comece pelas áreas que mais despertam seu interesse!
- 📘 Documentação MCP – Este é seu recurso principal com tutoriais passo a passo e guias do usuário. A documentação foi escrita pensando em iniciantes, oferecendo exemplos claros que você pode acompanhar no seu próprio ritmo.
- 📜 Especificação MCP – Considere este seu manual de referência completo. Conforme avança no currículo, você retornará aqui para consultar detalhes específicos e explorar recursos avançados.
- 📜 Versionamento da Especificação MCP – Contém informações sobre o histórico de versões do protocolo e como o MCP usa versionamento baseado em datas (formato AAAA-MM-DD).
- 🧑💻 Repositório MCP no GitHub – Aqui você encontra SDKs, ferramentas e exemplos de código em diversas 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 animado 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 linguagem de programação que preferir, começando com exemplos simples e desenvolvendo suas habilidades passo a passo.
• Conectar modelos de IA a ferramentas reais: Aprenderá a fazer a ponte entre modelos de IA e serviços reais, dando às suas aplicações novos poderes.
• Implementar práticas recomendadas de segurança: Entenderá como manter suas implementações MCP seguras, protegendo suas aplicações e usuários.
• Implantar com confiança: Saberá como levar seus projetos MCP do desenvolvimento à produção, com estratégias práticas 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 nos detalhes do MCP, vamos garantir que você se sinta confortável com alguns conceitos básicos. Não se preocupe se não for um expert nessas áreas — explicaremos tudo o que você precisa saber à medida que avançamos!
Pense em um protocolo como as regras para uma conversa. Quando liga para um amigo, vocês sabem que devem dizer “olá” ao atender, falar um de cada vez e dizer “tchau” quando terminam. Programas de computador precisam de regras semelhantes para se comunicar eficazmente.
O MCP é um protocolo – um conjunto de regras acordadas que ajudam modelos de IA e aplicações a terem “conversas” produtivas com ferramentas e serviços. Assim como estabelecer regras torna a comunicação humana mais suave, o MCP torna a comunicação entre aplicações de IA muito mais confiável e poderosa.
Você já usa relações cliente-servidor todos os dias! Quando usa um navegador (cliente) para visitar um site, você conecta 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 oferecem 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 com formatos diferentes — você precisaria de um adaptador diferente para cada carro! Padronização significa concordar em abordagens 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 de IA precisar de código customizado para trabalhar com cada ferramenta, o MCP cria uma maneira universal para eles se comunicarem. Isso permite que desenvolvedores construam ferramentas uma vez e as façam funcionar com muitos sistemas de IA diferentes.
Sua jornada no MCP está cuidadosamente estruturada para construir sua confiança e habilidades de forma progressiva. Cada fase apresenta novos conceitos enquanto reforça o que você já aprendeu.
É aqui que sua aventura começa! Vamos apresentar conceitos MCP usando analogias familiares e exemplos simples. Você vai entender o que é o MCP, por que ele existe e como ele se encaixa no mundo maior do desenvolvimento em 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 que desenvolvedores enfrentam.
• Módulo 1 - Conceitos Centrais Explicados: Aqui, você aprenderá os blocos essenciais do MCP. Usaremos muitas analogias e exemplos visuais para garantir que esses conceitos sejam naturais e compreensíveis.
• Módulo 2 - Segurança no MCP: Segurança pode parecer intimidante, mas mostraremos como o MCP inclui recursos integrados de segurança e ensinaremos práticas recomendadas que protegem 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 você 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 completos de código, dicas para solução de problemas e explicações sobre por que fazemos escolhas específicas de design. Ao final desta fase, você terá implementações MCP funcionais das quais poderá se orgulhar!
Com o básico dominado, você está pronto para explorar recursos MCP mais sofisticados. Cobriremos estratégias práticas de implementação, técnicas de depuração e tópicos avançados como integração multimodal de IA.
Você também aprenderá como escalar suas implementações MCP para uso em produção e integrar com plataformas em nuvem como o Azure. Esses módulos preparam você para construir soluções MCP que suportam as demandas do mundo real.
A fase final foca em ingressar na comunidade MCP e se especializar nas áreas que mais lhe interessam. Você aprenderá a contribuir para projetos open-source MCP, implementar padrões avançados de autenticação e criar soluções completas integradas com banco de dados.
O módulo 11 merece menção especial - é um caminho completo de aprendizado prático de 13 laboratórios que ensina a construir servidores MCP prontos para produção com integração PostgreSQL. É como um projeto de conclusão que reúne tudo que você aprendeu!
| Módulo | Tópico | Descrição | Link |
|---|---|---|---|
| Módulos 0-3: Fundamentos | |||
| 00 | Introdução ao MCP | Visão geral do Model Context Protocol e sua importância em pipelines de IA | Leia mais |
| 01 | Conceitos Principais Explicados | Exploração aprofundada dos conceitos principais 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/clients 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 grandes modelos de linguagem | 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 o AI Toolkit com MCP | Guia |
| 3.8 | Testes | Teste sua implementação de servidor MCP | Guia |
| 3.9 | Implantação | Implemente servidores MCP em produção | Guia |
| 3.10 | Uso avançado do servidor | Use servidores avançados para funcionalidades avançadas e arquitetura aprimorada | Guia |
| 3.11 | Autenticação simples | 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 | Inspetor MCP | Depure e teste servidores MCP com a ferramenta Inspector | Guia |
| 3.14 | Amostragem | Use amostragem para colaborar com o cliente | Guia |
| 3.15 | Aplicativos MCP | Construa Aplicativos MCP | Guia |
| Módulos 4-5: Prático & Avançado | |||
| 04 | Implementação Prática | SDKs, depuração, testes, templates reutilizáveis de prompt | Leia mais |
| 4.1 | Paginação | Gerencie 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 | Demonstração OAuth2 | Implementando 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 recursos de busca na web | Guia |
| 5.10 | Streaming em Tempo Real | Construa funcionalidades de streaming em tempo real | Guia |
| 5.11 | Busca em Tempo Real | Implemente busca 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 eficaz de contexto | Guia |
| 5.15 | Transporte Customizado MCP | Implementações customizadas de transporte | Guia |
| 5.16 | Funcionalidades do Protocolo | Notificações de progresso, cancelamento, templates de recursos | Guia |
| 5.17 | Raciocínio Multi-Agente Adversarial | Dois agentes argumentam lados opostos usando ferramentas MCP compartilhadas, avaliados por um agente juiz | Guia |
| Módulos 6-10: Comunidade & Melhores Práticas | |||
| 06 | Contribuições da Comunidade | Como contribuir para o ecossistema MCP | Guia |
| 07 | Lições 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 | Workshop Prático | Construindo um Servidor MCP com AI Toolkit | Laboratório |
| Módulo 11: Laboratório Prático de Servidor MCP | |||
| 11 | Integração de Servidor MCP com Banco de Dados | Caminho de aprendizado prático completo com 13 laboratórios para integração PostgreSQL | Laboratórios |
| 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 Principal | Compreensão da arquitetura do servidor MCP, camadas de banco e padrões de segurança | Lab 01 |
| 11.3 | Segurança & Multi-inquilino | Segurança em nível de linha, autenticação, 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 de esquema varejo, 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 | Criando ferramentas de consulta de banco de dados 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 | Implantação Docker, Azure Container Apps e considerações de escalabilidade | Lab 10 |
| 11.12 | Monitoramento | Application Insights, logs, monitoramento de performance | Lab 11 |
| 11.13 | Melhores Práticas | Otimização de performance, endurecimento de segurança e dicas para produção | Lab 12 |
Uma das partes mais empolgantes de aprender MCP é ver suas habilidades de código se desenvolvendo progressivamente. Projetamos nossos exemplos de código para começar simples e ficar mais sofisticados conforme seu entendimento se aprofunda. Veja como introduzimos conceitos - com código fácil de entender, mas que demonstra princípios reais do MCP, você entenderá não apenas o que este código faz, mas por que ele está estruturado dessa forma 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 de Container App | Ver Código |
| JavaScript | Exemplo Avançado | Ver Código |
| Python | Implementação Complexa | Ver Código |
| TypeScript | Exemplo de Conteiner | 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 REST e HTTP
-
(Opcional) Conhecimentos prévios em conceitos de IA/ML
-
Participação nas discussões da nossa comunidade para suporte
Este repositório inclui vários recursos para ajudar você a navegar e aprender de forma eficaz:
Um abrangente Guia de Estudo está disponível para ajudar você a navegar por este repositório de forma 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 efetivamente. É 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
- Descrição detalhada de cada seção do repositório
- Orientações sobre como usar os projetos de exemplo
- Caminhos de aprendizagem 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 funcionalidades
- Atualizações de documentação
Cada aula neste guia inclui:
- Explicações claras dos conceitos do MCP
- Exemplos de código ao vivo em múltiplas linguagens
- Exercícios para construir aplicações reais em MCP
- Recursos extras para aprendizes avançados
Vamos aprender sobre o Model Context Protocol (MCP), um framework de ponta projetado para padronizar as interações entre modelos de IA e aplicações clientes. Através desta sessão amigável para iniciantes, apresentaremos o MCP e guiaremos você 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 emocionante que expandirá suas capacidades de programação e conectará você ao que há de mais moderno no desenvolvimento de IA.
Ao ler esta introdução, você já começou a construir sua base de conhecimento em MCP. Você entende o que é MCP, por que ele importa, e como este currículo apoiará sua jornada de aprendizado. Isso é uma conquista significativa e o início de sua expertise nesta tecnologia importante.
À medida que avançar pelos módulos, lembre-se de que todo especialista já foi um iniciante. Os conceitos que parecem complexos agora se tornarão naturais conforme você os pratica e aplica. Cada pequeno passo constrói capacidades poderosas que serão úteis durante toda sua carreira de desenvolvimento.
Você está entrando em uma comunidade de aprendizes e especialistas apaixonados por MCP e ansiosos para ajudar os outros a terem sucesso. Seja se você estiver preso em um desafio de código ou animado para compartilhar uma descoberta, a comunidade está aqui para apoiar sua jornada.
Se você ficar com dúvidas ou tiver perguntas sobre como construir apps 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 sobre o produto ou encontrar erros durante o desenvolvimento, 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 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 por contribuir com exemplos de código.
O processo de contribuição é projetado para ser acolhedor e amigável. A maioria das contribuições requer um Acordo de Licença de Contribuidor (CLA), mas as ferramentas automatizadas irão guiá-lo suavemente pelo processo.
Todo este currículo está disponível sob a licença MIT LICENSE, o que significa que você pode usá-lo, modificá-lo e compartilhá-lo livremente. Isso apoia nossa missão de tornar o conhecimento MCP acessível para desenvolvedores em todo o mundo.
Este projeto acolhe contribuições e sugestões. A maioria das contribuições exige que você concorde com um Acordo de Licença de Contribuidor (CLA) declarando que você tem o direito, e efetivamente concede, os direitos para usarmos sua contribuição. Para detalhes, visite https://cla.opensource.microsoft.com.
Quando você enviar um pull request, um bot CLA automaticamente determinará se você precisa fornecer um CLA e decorará o PR adequadamente (por exemplo, verificação de status, comentário). Basta seguir as instruções fornecidas pelo bot. Você precisará fazer isso apenas uma vez em todos os repositórios que usam nosso CLA.
Este projeto adotou o Código de Conduta de Código Aberto da Microsoft. Para mais informações, veja as Perguntas Frequentes sobre o Código de Conduta ou contate opencode@microsoft.com para quaisquer perguntas ou comentários adicionais.
Pronto para começar sua jornada MCP? Comece com o 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 esforcemos pela precisão, esteja ciente de que traduções automatizadas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.