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 Azure AI Foundry Discord 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 | Polaco | Turco | Grego | Tailandês | Sueco | Dinamarquês | Norueguês | Finlandês | Holandês | Hebraico | Vietnamita | Indonésio | Malaio | Tagalog (Filipino) | Suaíli | Húngaro | Checo | Eslovaco | Romeno | Búlgaro | Sérvio (Cirílico) | Croata | Esloveno | Ucraniano | Birmanês (Myanmar)
O Model Context Protocol (MCP) é uma framework inovadora criada para padronizar as interações entre modelos de IA e aplicações cliente. Este currículo open-source oferece um percurso de aprendizagem 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 é o seu recurso completo para dominar os fundamentos do MCP e as estratégias de implementação.
- 📘 Documentação MCP – Tutoriais detalhados e guias do utilizador
- 📜 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 em discussões e contribua para a comunidade
Prepare-se para dois dias de conhecimento técnico aprofundado, ligação à comunidade e aprendizagem prática no MCP Dev Days, um evento virtual dedicado ao Model Context Protocol (MCP) — o padrão emergente que liga modelos de IA às ferramentas que utilizam.
➡️ Registe-se para o MCP Dev Days
Pode assistir ao MCP Dev Days registando-se na nossa página do evento: https://aka.ms/mcpdevdays. A partir daí, poderá juntar-se a uma 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)
- Hora: 9:00 AM PST diariamente
- Local: Online – participe de qualquer lugar!
Focado em capacitar os desenvolvedores a usar MCP no seu fluxo de trabalho e celebrar a incrível comunidade MCP. Teremos a participação de membros da comunidade e parceiros como Arcade, Block, Okta e Neon para mostrar como colaboram 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
Quer esteja a começar com MCP ou já a desenvolver com ele, o Dia 1 preparará o terreno com inspiração e dicas práticas.
Destinado a construtores MCP. Vamos aprofundar estratégias de implementação e melhores práticas para criar servidores MCP e integrar MCP nos 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 registos e ferramentas (1P + 3P)
Se é desenvolvedor, construtor de ferramentas ou estratega de produtos de IA, este dia está repleto dos insights necessários para construir soluções MCP escaláveis, seguras e preparadas para o futuro.
| Módulo | Tema | 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 | Ler mais |
| 01 | Conceitos Básicos Explicados | Exploração aprofundada dos conceitos centrais do MCP | Ler mais |
| 02 | Segurança no MCP | Ameaças de segurança e melhores práticas | Ler mais |
| 03 | Começar com MCP | Configuração do ambiente, servidores/clientes básicos, integração | Ler mais |
| Módulo 3: Construir o Seu Primeiro Servidor & Cliente | |||
| 3.1 | Primeiro Servidor | Crie o 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 de grande escala | 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 a sua implementação de servidor MCP | Guia |
| 3.9 | Deploy | Faça o deploy dos servidores MCP para produção | Guia |
| Módulos 4-5: Prático & Avançado | |||
| 04 | Implementação Prática | SDKs, debugging, testes, templates reutilizáveis de prompts | Ler mais |
| 05 | Tópicos Avançados no MCP | IA multimodal, escalabilidade, uso empresarial | Ler mais |
| 5.1 | Integração Azure | Integração MCP com Azure | Guia |
| 5.2 | Multimodalidade | Trabalhar com múltiplas modalidades | Guia |
| 5.3 | Demo OAuth2 | Implementar autenticação OAuth2 | Guia |
| 5.4 | Contextos Raiz | Compreender e implementar 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 | Escalar implementações MCP | Guia |
| 5.8 | Segurança | Considerações avançadas de segurança | Guia |
| 5.9 | Pesquisa Web | Implementar capacidades de pesquisa web | Guia |
| 5.10 | Streaming em Tempo Real | Construir funcionalidades de streaming em tempo real | Guia |
| 5.11 | Pesquisa em Tempo Real | Implementar pesquisa 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 & Boas 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 | Boas 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 | Construção de 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 Aplicação 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 tirar o máximo proveito deste currículo, deve ter:
-
Conhecimentos básicos 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 em conceitos de IA/ML
-
Participar nas discussões da nossa comunidade para apoio
Este repositório inclui vários recursos para ajudar na sua aprendizagem e navegação eficaz:
Um Guia de Estudo abrangente está disponível para o ajudar a navegar neste repositório de forma eficaz. O guia inclui:
- Um mapa visual do currículo com todos os tópicos abordados
- Descrição detalhada de cada secção do repositório
- Orientações sobre como usar os projetos de exemplo
- Caminhos de aprendizagem recomendados para diferentes níveis de conhecimento
- Recursos adicionais para complementar a sua jornada de aprendizagem
Mantemos um Registo de Alterações detalhado que acompanha todas as atualizações importantes dos materiais do currículo, incluindo:
- Novos conteúdos adicionados
- Alterações estruturais
- Melhorias de funcionalidades
- Atualizações de 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 extra para aprendizes avançados
Obrigado 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, consulte o LICENSE.
Este projeto aceita contribuições e sugestões. A maioria das contribuições requer que concorde com um
Acordo de Licença de Contribuidor (CLA) declarando que tem o direito e efetivamente concede-nos
os direitos para usar a sua contribuição. Para detalhes, visite
https://cla.opensource.microsoft.com.
Quando submeter um pull request, um bot CLA determinará automaticamente se precisa de fornecer
um CLA e marcará o PR adequadamente (ex.: verificação de estado, comentário). Basta seguir as instruções
fornecidas pelo bot. Só precisará de fazer isto uma vez para todos os repositórios que usam o nosso CLA.
Este projeto adotou o Código de Conduta de Código Aberto da Microsoft.
Para mais informações, consulte as FAQ do Código de Conduta ou
contacte opencode@microsoft.com para quaisquer 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 abrangente para navegar no repositório
- changelog.md: Registo de todas as alterações significativas nos materiais do currículo
- mcp.json: Ficheiro de configuração para a especificação MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Documentos de governação do projeto
A nossa equipa produz outros cursos! Veja:
- 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 registadas ou logótipos de projetos, produtos ou serviços. O uso autorizado das marcas ou logótipos Microsoft está sujeito e deve seguir as
Diretrizes de Marcas e Identidade da Microsoft.
O uso de marcas ou logótipos Microsoft em versões modificadas deste projeto não deve causar confusão nem implicar patrocínio da Microsoft.
Qualquer uso de marcas ou logótipos de terceiros está sujeito às políticas desses terceiros.
Aviso Legal:
Este documento foi traduzido utilizando o serviço de tradução automática Co-op Translator. Embora nos esforcemos pela precisão, por favor tenha em conta que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa 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 da utilização desta tradução.