Siga estes passos para começar a usar esses recursos:
- Faça um Fork do Repositório: Clique em
- Clone o Repositório:
git clone https://github.com/microsoft/mcp-for-beginners.git - Participe do Discord Azure AI Foundry e conheça especialistas e outros desenvolvedores
Francês | Espanhol | Alemão | Russo | Árabe | Persa (Farsi) | Urdu | Chinês (Simplificado) | Chinês (Tradicional, Macau) | Chinês (Tradicional, Hong Kong) | Chinês (Tradicional, Taiwan) | Japonês | Coreano | Hindi | Bengali | Marathi | Nepali | Punjabi (Gurmukhi) | Português (Portugal) | Português (Brasil) | Italiano | Polonês | Turco | Grego | Tailandês | Sueco | Dinamarquês | Norueguês | Finlandês | Holandês | Hebraico | Vietnamita | Indonésio | Malaio | Tagalog (Filipino) | Suaíli | Húngaro | Tcheco | Eslovaco | Romeno | Búlgaro | Sérvio (Cirílico) | Croata | Esloveno | Ucraniano | Birmanês (Myanmar)
O Model Context Protocol (MCP) é uma estrutura inovadora criada para padronizar as interações entre modelos de IA e aplicações clientes. Este currículo open-source oferece um caminho de aprendizado estruturado, com exemplos práticos de código e casos de uso reais, em linguagens populares como C#, Java, JavaScript, TypeScript e Python.
Seja você um desenvolvedor de IA, arquiteto de sistemas ou engenheiro de software, este guia é seu recurso completo para dominar os fundamentos do MCP e estratégias de implementação.
- 📘 Documentação MCP – Tutoriais detalhados e guias do usuário
- 📜 Especificação MCP – Arquitetura do protocolo e referências técnicas
- 📜 Especificação Original do MCP – Referências técnicas legadas (pode conter detalhes adicionais)
- 🧑💻 Repositório MCP no GitHub – SDKs open-source, ferramentas e exemplos de código
- 🌐 Comunidade MCP – Participe das discussões e contribua com a comunidade
Prepare-se para dois dias de imersão técnica, conexão com a comunidade e aprendizado prático no MCP Dev Days, um evento virtual dedicado ao Model Context Protocol (MCP) — o padrão emergente que conecta modelos de IA às ferramentas que eles utilizam.
➡️ Inscreva-se no MCP Dev Days
Você pode assistir ao MCP Dev Days se inscrevendo na nossa página do evento: https://aka.ms/mcpdevdays. A partir daí, poderá acompanhar a transmissão ao vivo no YouTube ou Twitch. Todo o conteúdo será gravado e ficará disponível posteriormente no canal Microsoft Developer no YouTube. O código-fonte das demonstrações também estará disponível no GitHub.
- Datas: 29 de julho (Dia 1) e 30 de julho (Dia 2)
- Horário: 9:00 AM PST diariamente
- Local: Online – participe de qualquer lugar!
Focado em capacitar desenvolvedores a usar MCP em seus fluxos de trabalho e celebrar a incrível comunidade MCP. Contaremos com a participação de membros da comunidade e parceiros como Arcade, Block, Okta e Neon para mostrar como estão colaborando com a Microsoft para moldar um ecossistema MCP aberto e extensível.
Demonstrações reais em VS Code, Visual Studio, GitHub Copilot e ferramentas populares da comunidade
Fluxos de trabalho práticos e orientados por contexto
Sessões e insights liderados pela comunidade
Se você está começando com MCP ou já está desenvolvendo com ele, o Dia 1 vai inspirar e trazer aprendizados práticos.
Destinado a construtores MCP. Vamos aprofundar em estratégias de implementação e melhores práticas para criar servidores MCP e integrar MCP em seus fluxos de trabalho de IA.
- Construção de Servidores MCP e integração em experiências de agentes
- Desenvolvimento orientado por prompts
- Melhores práticas de segurança
- Uso de blocos de construção como Functions, ACA e API Management
- Alinhamento de registro e ferramentas (1P + 3P)
Se você é desenvolvedor, criador de ferramentas ou estrategista de produtos de IA, este dia está repleto de insights para construir soluções MCP escaláveis, seguras e preparadas para o futuro.
| Módulo | Tópico | Descrição | Link |
|---|---|---|---|
| Módulos 1-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 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 grandes modelos de linguagem | Guia |
| 3.4 | Integração com VS Code | Consuma servidores MCP no VS Code | Guia |
| 3.5 | Servidor SSE | Crie servidores usando Server-Sent Events | 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 | Deploy | Faça o deploy dos servidores MCP em produção | 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 |
| 05 | Tópicos Avançados no MCP | IA multimodal, escalabilidade, uso empresarial | Leia mais |
| 5.1 | Integração com Azure | Integração MCP com Azure | Guia |
| 5.2 | Multimodalidade | Trabalhando com múltiplas modalidades | Guia |
| 5.3 | Demonstração OAuth2 | Implementação de autenticação OAuth2 | Guia |
| 5.4 | Contextos Raiz | Entenda 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 na Web | Implemente capacidades 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 | Integração com Azure AI Foundry | Guia |
| 5.14 | Engenharia de Contexto | Técnicas para engenharia de contexto eficaz | Guia |
| Módulo 6-10: Comunidade & Melhores Práticas | |||
| 06 | Contribuições da Comunidade | Como contribuir para o ecossistema MCP | Guia |
| 07 | Insights 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 |
| Linguagem | Descrição | Link |
|---|---|---|
| C# | Exemplo de Servidor MCP | Ver Código |
| Java | Calculadora MCP | Ver Código |
| JavaScript | Demonstração MCP | Ver Código |
| Python | Servidor MCP | Ver Código |
| TypeScript | Exemplo MCP | Ver Código |
| Linguagem | Descrição | Link |
|---|---|---|
| C# | Exemplo Avançado | Ver Código |
| Java | Exemplo de Aplicativo Container | Ver Código |
| JavaScript | Exemplo Avançado | Ver Código |
| Python | Implementação Complexa | Ver Código |
| TypeScript | Exemplo 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
-
Entendimento do modelo cliente-servidor e APIs
-
Familiaridade com conceitos de REST e HTTP
-
(Opcional) Conhecimentos 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 Guia de Estudo completo está disponível para ajudar você a navegar neste repositório de forma eficiente. 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 Registro de Alterações detalhado que acompanha todas as atualizações importantes dos materiais do currículo, incluindo:
- Inclusão de novos conteúdos
- Mudanças estruturais
- Melhorias de funcionalidades
- Atualizações na documentação
Cada lição 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 MCP reais
- Recursos extras para aprendizes avançados
Agradecimentos ao Microsoft Valued Professional Shivam Goyal pela contribuição com importantes exemplos de código.
Este conteúdo está licenciado sob a Licença MIT. Para termos e condições, veja o LICENSE.
Este projeto aceita 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 realmente concede a nós
os direitos para usar sua contribuição. Para detalhes, visite
https://cla.opensource.microsoft.com.
Quando você enviar um pull request, um bot CLA determinará automaticamente se você precisa fornecer
um CLA e marcará o PR adequadamente (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 nosso CLA.
Este projeto adotou o Código de Conduta de Código Aberto da Microsoft.
Para mais informações, veja o FAQ do Código de Conduta ou
entre em contato pelo e-mail opencode@microsoft.com para dúvidas ou comentários adicionais.
O repositório está organizado da seguinte forma:
- Currículo Principal (00-10): Conteúdo principal organizado em dez módulos sequenciais
- images/: Diagramas e ilustrações usados ao longo do currículo
- translations/: Suporte multilíngue com traduções automáticas
- translated_images/: Versões localizadas de diagramas e ilustrações
- study_guide.md: Guia completo para navegar no repositório
- changelog.md: Registro de todas as mudanças significativas nos materiais do currículo
- mcp.json: Arquivo de configuração da especificação MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Documentos de governança do projeto
Nossa equipe produz outros cursos! Confira:
- AI Agents For Beginners
- Generative AI for Beginners using .NET
- Generative AI for Beginners using JavaScript
- Generative AI for Beginners
- ML for Beginners
- Data Science for Beginners
- AI for Beginners
- Cybersecurity for Beginners
- Web Dev for Beginners
- IoT for Beginners
- XR Development for Beginners
- Mastering GitHub Copilot for AI Paired Programming
- Mastering GitHub Copilot for C#/.NET Developers
- Choose Your Own Copilot Adventure
Este projeto pode conter marcas registradas ou logotipos de projetos, produtos ou serviços. O uso autorizado das
marcas ou logotipos da Microsoft está sujeito e deve seguir as
Diretrizes de Marca e Uso da Microsoft.
O uso de marcas ou logotipos da Microsoft em versões modificadas deste projeto não deve causar confusão nem
implicar patrocínio da Microsoft.
Qualquer uso de marcas ou logotipos de terceiros está sujeito às políticas desses terceiros.
Aviso Legal:
Este documento foi traduzido utilizando o serviço de tradução por IA Co-op Translator. Embora nos esforcemos para garantir a 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 humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.