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 conecte-se com especialistas e outros desenvolvedores
Árabe | Bengali | Búlgaro | Birmanês (Myanmar) | Chinês (Simplificado) | Chinês (Tradicional, Hong Kong) | Chinês (Tradicional, Macau) | Chinês (Tradicional, Taiwan) | Croata | Checo | Dinamarquês | Holandês | Finlandês | Francês | Alemão | Grego | Hebraico | Hindi | Húngaro | Indonésio | Italiano | Japonês | Coreano | Malaio | Marata | Nepalês | Norueguês | Persa (Farsi) | Polaco | Português (Brasil) | Português (Portugal) | Punjabi (Gurmukhi) | Romeno | Russo | Sérvio (Cirílico) | Eslovaco | Esloveno | Espanhol | Suaíli | Sueco | Tagalo (Filipino) | Tailandês | Turco | Ucraniano | Urdu | Vietnamita
O Protocolo de Contexto de Modelo (MCP) é uma estrutura inovadora projetada para padronizar as interações entre modelos de IA e aplicações cliente. Este currículo de código aberto oferece um caminho de aprendizado estruturado, com exemplos práticos de codificação e casos de uso do mundo real, em linguagens de programação populares como C#, Java, JavaScript, TypeScript e Python.
Seja você um desenvolvedor de IA, arquiteto de sistemas ou engenheiro de software, este guia é um recurso abrangente para dominar os fundamentos e estratégias de implementação do MCP.
- 📘 Documentação do MCP – Tutoriais detalhados e guias do usuário
- 📜 Especificação do MCP – Arquitetura do protocolo e referências técnicas
- 📜 Especificação Original do MCP – Referências técnicas legadas (podem conter detalhes adicionais)
- 🧑💻 Repositório GitHub do MCP – SDKs de código aberto, ferramentas e exemplos de código
- 🌐 Comunidade MCP – Participe de discussões e contribua para a comunidade
| Módulo | Tópico | Descrição | Link |
|---|---|---|---|
| Módulo 1-3: Fundamentos | |||
| 00 | Introdução ao MCP | Visão geral do Protocolo de Contexto de Modelo e sua importância nos pipelines de IA | Leia mais |
| 01 | Conceitos Básicos Explicados | Exploração detalhada 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 o MCP | Configuração do ambiente, servidores/clientes básicos, integração | Leia mais |
| Módulo 3: Construindo Seu Primeiro Servidor e 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 de grande escala | Guia |
| 3.4 | Integração com 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 | Implante servidores MCP em produção | Guia |
| Módulo 4-5: Prático e Avançado | |||
| 04 | Implementação Prática | SDKs, depuração, testes, templates reutilizáveis de prompts | Leia mais |
| 05 | Tópicos Avançados no MCP | IA multimodal, escalabilidade, uso empresarial | Leia mais |
| 5.1 | Integração com Azure | Integração do MCP com Azure | Guia |
| 5.2 | Multimodalidade | Trabalhando com múltiplas modalidades | Guia |
| 5.3 | Demonstração OAuth2 | Implemente autenticação OAuth2 | Guia |
| 5.4 | Contextos Raiz | Entenda e implemente contextos raiz | Guia |
| 5.5 | Roteamento | Estratégias de roteamento no MCP | Guia |
| 5.6 | Amostragem | Técnicas de amostragem no MCP | Guia |
| 5.7 | Escalabilidade | Escale implementações do MCP | Guia |
| 5.8 | Segurança | Considerações avançadas de segurança | Guia |
| 5.9 | Pesquisa na Web | Implemente capacidades de pesquisa na web | Guia |
| 5.10 | Streaming em Tempo Real | Construa funcionalidades de streaming em tempo real | Guia |
| 5.11 | Pesquisa em Tempo Real | Implemente pesquisa em tempo real | Guia |
| 5.12 | Autenticação Entra ID | Autenticação com Microsoft Entra ID | Guia |
| 5.13 | Integração com Foundry | Integre com Azure AI Foundry | Guia |
| 5.14 | Engenharia de Contexto | Técnicas para engenharia de contexto eficaz | Guia |
| Módulo 6-10: Comunidade e 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 | Desempenho, tolerância a falhas, resiliência | Guia |
| 09 | Estudos de Caso do 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 |
| Rust | Exemplo MCP | Ver Código |
| Linguagem | Descrição | Link |
|---|---|---|
| C# | Exemplo Avançado | Ver Código |
| Java com Spring | Exemplo de Aplicação em Container | 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 tirar o máximo proveito deste currículo, é recomendável que você tenha:
-
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 nas discussões da nossa comunidade para suporte
Este repositório inclui diversos recursos para ajudá-lo a navegar e aprender de forma eficaz:
Um Guia de Estudos abrangente está disponível para ajudá-lo a explorar este repositório de forma eficiente. O guia inclui:
- Um mapa visual do currículo mostrando todos os tópicos abordados
- Detalhamento detalhado 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 Changelog detalhado que registra todas as atualizações significativas nos materiais do currículo, incluindo:
- Adições de novos conteúdos
- Alterações estruturais
- Melhorias de funcionalidades
- Atualizações de documentação
Cada lição neste guia inclui:
- Explicações claras dos conceitos de MCP
- Exemplos de código ao vivo em várias linguagens
- Exercícios para construir aplicações reais de MCP
- Recursos extras para aprendizes avançados
Prepare-se para dois dias de insights técnicos aprofundados, 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.
Você pode assistir ao MCP Dev Days registrando-se na nossa página do evento: https://aka.ms/mcpdevdays.
É focado em capacitar os desenvolvedores a usar o MCP no seu fluxo de trabalho e celebrar a incrível comunidade MCP. Contaremos com 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 práticas no mundo real com VS Code, Visual Studio, GitHub Copilot e ferramentas populares da comunidade
Fluxos de trabalho de desenvolvimento práticos e orientados por contexto
Sessões lideradas pela comunidade e insights
Seja você iniciante no MCP ou já desenvolvendo com ele, o Dia 1 trará inspiração e ações práticas.
É voltado para criadores de MCP. Vamos nos aprofundar em estratégias de implementação e melhores práticas para criar servidores MCP e integrar o 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 registro e ferramentas (1P + 3P)
Se você é um 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.
Aprenda em sessões intensivas de vídeo como criar servidores MCP, integrar com o VS Code e implantar profissionalmente no Azure com base no conteúdo do currículo MCP para Iniciantes. Saia com habilidades práticas em uma tecnologia que grandes empresas já estão utilizando.
Agradecimentos ao Microsoft Valued Professional Shivam Goyal por contribuir 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
Contrato de Licença de Contribuidor (CLA) declarando que você tem o direito de, e realmente concede, os direitos para usarmos sua contribuição. Para mais 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 decorará o PR de forma apropriada (ex.: verificação de status, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios que utilizam nosso CLA.
Este projeto adotou o Código de Conduta de Código Aberto da Microsoft. Para mais informações, veja as Perguntas Frequentes do Código de Conduta ou entre em contato com opencode@microsoft.com para quaisquer dúvidas ou comentários adicionais.
O repositório está organizado da seguinte forma:
- Currículo Principal (00-10): O 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: Registro de todas as mudanças significativas nos materiais do currículo
- mcp.json: Arquivo de configuração para a especificação MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Documentos de governança do projeto
Nossa equipe produz outros cursos! Confira:
- Agentes de IA para Iniciantes
- IA Generativa para Iniciantes usando .NET
- IA Generativa para Iniciantes usando JavaScript
- IA Generativa para Iniciantes
- IA Generativa para Iniciantes usando Java
- ML para Iniciantes
- Ciência de Dados para Iniciantes
- IA para Iniciantes
- Cibersegurança para Iniciantes
- Desenvolvimento Web para Iniciantes
- IoT para Iniciantes
- Desenvolvimento XR para Iniciantes
- Dominando o GitHub Copilot para Programação em Parceria com IA
- Dominando o GitHub Copilot para Desenvolvedores C#/.NET
- Escolha Sua Própria Aventura com o Copilot
Este projeto pode conter marcas registradas ou logotipos de projetos, produtos ou serviços. O uso autorizado de marcas registradas ou logotipos da Microsoft está sujeito e deve seguir as Diretrizes de Marca e Logotipo da Microsoft.
O uso de marcas registradas ou logotipos da Microsoft em versões modificadas deste projeto não deve causar confusão ou implicar patrocínio da Microsoft.
Qualquer uso de marcas registradas 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 no seu idioma nativo deve ser considerado a fonte oficial. Para informações críticas, recomenda-se uma tradução profissional realizada por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas resultantes do uso desta tradução.