Siga estas etapas 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
- Junte-se ao Discord do Azure AI Foundry e conecte-se com especialistas e outros desenvolvedores
🌐 Suporte Multilíngue
Suportado via GitHub Action (Automatizado e Sempre Atualizado)
Á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 | Finlandês | Francês | Alemão | Grego | Hebraico | Hindi | Húngaro | Indonésio | Italiano | Japonês | Coreano | Malaio | Marathi | Nepalês | 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) | Tailandês | Turco | Ucraniano | Urdu | Vietnamita
🚀 Currículo do Model Context Protocol (MCP) para Iniciantes
Aprenda MCP com Exemplos Práticos de Código em C#, Java, JavaScript, Rust, Python e TypeScript
🧠 Visão Geral do Currículo do Model Context Protocol
O Model Context Protocol (MCP) é um framework inovador projetado para padronizar interações entre modelos de IA e aplicativos cliente. Este currículo de código aberto oferece um caminho de aprendizado estruturado, completo com exemplos práticos de codificação e casos de uso reais, 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 é seu recurso abrangente para dominar os fundamentos do MCP e estratégias de implementação.
🔗 Recursos Oficiais 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
🧭 Visão Geral do Currículo MCP
📚 Estrutura Completa do Currículo
Módulo | Tópico | Descrição | Link |
---|---|---|---|
Módulo 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 Centrais Explicados | Exploração detalhada 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 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 grandes | 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 | Toolkit de IA | Use o Toolkit de IA 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 de servidor | Use servidores avançados para recursos avançados e arquitetura aprimorada | Guia |
3.11 | Autenticação simples | Um capítulo mostrando autenticação desde o início e RBAC | 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 corporativo | 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 | 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 com 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 |
5.15 | Transporte Personalizado do MCP | Implementações de transporte personalizado | Guia |
Módulo 6-10: Comunidade e 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 | 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 Toolkit de IA | Laboratório |
Módulo 11: Laboratório Prático de Servidor MCP | |||
11 | Integração de Banco de Dados com Servidor MCP | Caminho de aprendizado prático com 13 laboratórios para integração com PostgreSQL | Laboratórios |
11.1 | Introdução | Visão geral do MCP com integração de banco de dados e caso de uso de análise de varejo | Laboratório 00 |
11.2 | Arquitetura Principal | Compreendendo a arquitetura do servidor MCP, camadas de banco de dados e padrões de segurança | Lab 01 |
11.3 | Segurança e Multi-Tenancy | Segurança em nível de linha, autenticação e acesso a dados multi-tenant | Lab 02 |
11.4 | Configuração do Ambiente | Configuração do ambiente de desenvolvimento, Docker, recursos do Azure | Lab 03 |
11.5 | Design de Banco de Dados | Configuração do PostgreSQL, design de esquema de varejo e dados de exemplo | Lab 04 |
11.6 | Implementação do Servidor MCP | Construindo o servidor FastMCP com integração ao 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 | Implementando embeddings vetoriais com Azure OpenAI e pgvector | Lab 07 |
11.9 | Testes e Depuração | Estratégias de teste, ferramentas de depuração e abordagens de validação | Lab 08 |
11.10 | Integração com VS Code | Configurando integração do MCP no VS Code e uso do AI Chat | Lab 09 |
11.11 | Estratégias de Implantação | Implantação com Docker, Azure Container Apps e considerações de escalabilidade | Lab 10 |
11.12 | Monitoramento | Application Insights, registro de logs e monitoramento de desempenho | Lab 11 |
11.13 | Melhores Práticas | Otimização de desempenho, reforço de segurança e dicas para produção | Lab 12 |
💻 Projetos de Código de Exemplo
Exemplos Básicos de Calculadora MCP
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 |
Implementações Avançadas de MCP
Linguagem | Descrição | Link |
---|---|---|
C# | Exemplo Avançado | Ver Código |
Java com Spring | Exemplo de Aplicativo em Contêiner | Ver Código |
JavaScript | Exemplo Avançado | Ver Código |
Python | Implementação Complexa | Ver Código |
TypeScript | Exemplo de Contêiner | Ver Código |
🎯 Pré-requisitos para Aprender MCP
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 discussões da comunidade para suporte
📚 Guia de Estudos e Recursos
Este repositório inclui vários recursos para ajudá-lo a navegar e aprender de forma eficaz:
Guia de Estudos
Um Guia de Estudos abrangente está disponível para ajudá-lo a navegar neste repositório de forma eficaz. 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ção 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
Changelog
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 recursos
- Atualizações de documentação
🛠️ Como Usar Este Currículo de Forma Eficaz
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
Eventos
MCP Dev Days Julho 2025
➡️Assista Sob Demanda - MCP Dev Days
Prepare-se para dois dias de insights técnicos profundos, 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 e as ferramentas que eles utilizam.
Você pode assistir ao MCP Dev Days registrando-se na nossa página de eventos: https://aka.ms/mcpdevdays.
Dia 1: Produtividade MCP, Ferramentas de Desenvolvimento e Comunidade:
É sobre capacitar desenvolvedores a usar MCP em seu fluxo de trabalho e celebrar a incrível comunidade MCP. Estaremos acompanhados por membros da comunidade e parceiros como Arcade, Block, Okta e Neon para ver 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á construindo com ele, o Dia 1 será inspirador e cheio de dicas práticas.
Dia 2: Construa Servidores MCP com Confiança
É para os criadores de MCP. Vamos nos 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.
Tópicos incluem:
- 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.
Boot Camp MCP Agosto 2025
Aprenda em sessões intensivas de vídeo como criar servidores MCP, integrar com 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.
➡️Assista Sob Demanda Bootcamp MCP | Inglês
➡️Assista Sob Demanda Bootcamp MCP | Brasil
➡️Assista Sob Demanda Bootcamp MCP | Espanhol
Vamos Aprender MCP com C# - Série de Tutoriais
Vamos aprender sobre o Model Context Protocol (MCP), um framework inovador projetado para padronizar interações entre modelos de IA e aplicativos cliente. Nesta sessão amigável para iniciantes, apresentaremos o MCP e guiaremos você na criação do seu primeiro servidor MCP.
C#: https://aka.ms/letslearnmcp-csharp
Java: https://aka.ms/letslearnmcp-java
JavaScript: https://aka.ms/letslearnmcp-javascript
Python: https://aka.ms/letslearnmcp-python
🌟 Agradecimentos à Comunidade
Agradecimentos ao Microsoft Valued Professional Shivam Goyal por contribuir com importantes exemplos de código.
📜 Informações de Licença
Este conteúdo está licenciado sob a Licença MIT. Para termos e condições, veja o LICENSE.
🤝 Diretrizes de Contribuição
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 a nós, os direitos de 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 decorará o PR apropriadamente (por exemplo, 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 o FAQ do Código de Conduta ou entre em contato com opencode@microsoft.com para quaisquer perguntas ou comentários adicionais.
📂 Estrutura do Repositório
O repositório está organizado da seguinte forma:
- Currículo Principal (00-11): O conteúdo principal organizado em onze módulos sequenciais, incluindo laboratórios abrangentes de integração de banco de dados
- 11-MCPServerHandsOnLabs/: Caminho completo de aprendizado com 13 laboratórios para construir servidores MCP prontos para produção com integração ao PostgreSQL
- images/: Diagramas e ilustrações usados ao longo do currículo
- translations/: Suporte multilíngue com traduções automatizadas
- 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 especificação MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Documentos de governança do projeto
🎒 Outros Cursos
Nossa equipe produz outros cursos! Confira:
- NOVO Edge AI Para Iniciantes
- 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 Copilot
™️ Aviso de Marca Registrada
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.
Obtendo Ajuda
Se você estiver com dificuldades ou tiver dúvidas sobre como criar aplicativos de IA, participe:
Se você tiver feedback sobre o produto ou encontrar erros durante o desenvolvimento, visite:
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, é importante estar ciente de que traduções automatizadas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte oficial. Para informações críticas, recomenda-se a tradução profissional realizada por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações equivocadas decorrentes do uso desta tradução.