Siga estes passos para começar a utilizar estes 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 Multilingue
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 | Checo | 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) | Polaco | Português (Brasil) | Português (Portugal) | Punjabi (Gurmukhi) | Romeno | Russo | Sérvio (Cirílico) | Eslovaco | Esloveno | Espanhol | Swahili | Sueco | Tagalog (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) é uma estrutura inovadora projetada para padronizar interações entre modelos de IA e aplicações cliente. Este currículo de código aberto oferece um caminho de aprendizagem estruturado, completo com exemplos práticos de programação 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 é um 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 utilizador
- 📜 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 | Explicação dos Conceitos Centrais | 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 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 | 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 servidores | 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 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 |
5.15 | Transporte Personalizado 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 o 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 aprendizagem 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 retalho | Laboratório 00 |
11.2 | Arquitetura Principal | Compreender a arquitetura do servidor MCP, camadas de base de dados e padrões de segurança | Lab 01 |
11.3 | Segurança e Multi-Tenancy | Segurança ao nível de linha, autenticação e 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 Base de Dados | Configuração do PostgreSQL, design de esquema de retalho e dados de exemplo | Lab 04 |
11.6 | Implementação do Servidor MCP | Construção do servidor FastMCP com integração de base de dados | Lab 05 |
11.7 | Desenvolvimento de Ferramentas | Criação de ferramentas de consulta de base de dados e introspeção de esquema | Lab 06 |
11.8 | Pesquisa Semântica | Implementação de 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 | Configuração da integração MCP no VS Code e utilização do Chat AI | Lab 09 |
11.11 | Estratégias de Implementação | Implementação com Docker, Azure Container Apps e considerações de escalabilidade | Lab 10 |
11.12 | Monitorização | Application Insights, registo de logs, monitorização 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 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 |
🎯 Pré-requisitos para Aprender MCP
Para aproveitar ao máximo este currículo, é recomendável 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 de REST e HTTP
(Opcional) Conhecimentos em conceitos de IA/ML
Participação nas discussões da comunidade para suporte
📚 Guia de Estudo e Recursos
Este repositório inclui vários recursos para ajudar na navegação e aprendizagem eficaz:
Guia de Estudo
Um Guia de Estudo abrangente está disponível para ajudar a navegar neste repositório de forma eficaz. 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ção sobre como usar os projetos de exemplo
- Caminhos de aprendizagem recomendados para diferentes níveis de habilidade
- Recursos adicionais para complementar a jornada de aprendizagem
Changelog
Mantemos um Changelog detalhado que regista 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
🛠️ Como Utilizar Este Currículo de Forma Eficaz
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 adicionais para aprendizes avançados
Eventos
MCP Dev Days Julho 2025
➡️Assistir Sob Demanda - MCP Dev Days
Prepare-se para dois dias de insights técnicos profundos, conexão com a comunidade e aprendizagem prática 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. Pode assistir ao MCP Dev Days registando-se na nossa página de eventos: https://aka.ms/mcpdevdays.
Dia 1: Produtividade MCP, Ferramentas de Desenvolvimento e Comunidade:
É dedicado a capacitar os programadores a utilizarem MCP no seu fluxo de trabalho e a 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 a colaborar 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 construir com ele, o Dia 1 será repleto de inspiração e ações práticas.
Dia 2: Construir Servidores MCP com Confiança
É para criadores de 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.
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
- Utilização de blocos de construção como Functions, ACA e API Management
- Alinhamento de registo e ferramentas (1P + 3P)
Se é um programador, 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 implementar profissionalmente no Azure com base no conteúdo do currículo MCP para Iniciantes. Saia com habilidades práticas numa tecnologia que grandes empresas já estão a utilizar.
➡️Assistir Sob Demanda Bootcamp MCP | Inglês
➡️Assistir Sob Demanda Bootcamp MCP | Brasil
➡️Assistir Sob Demanda Bootcamp MCP | Espanhol
Vamos Aprender MCP com C# - Série de Tutoriais
Vamos aprender sobre o Model Context Protocol (MCP), uma estrutura inovadora projetada para padronizar interações entre modelos de IA e aplicações cliente. Nesta sessão para iniciantes, vamos apresentar o MCP e guiá-lo 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
Obrigado 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 acolhe contribuições e sugestões. A maioria das contribuições requer que concorde com um Contrato de Licença de Contribuidor (CLA), declarando que tem o direito de, e realmente concede-nos, os direitos de 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 fornecer um CLA e decorará o PR adequadamente (por exemplo, verificação de estado, comentário). Basta seguir as instruções fornecidas pelo bot. Só precisará fazer isso uma vez em todos os repositórios que utilizam o nosso CLA.
Este projeto adotou o Código de Conduta de Código Aberto da Microsoft. Para mais informações, veja as FAQ do Código de Conduta ou contacte opencode@microsoft.com com 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 base de dados
- 11-MCPServerHandsOnLabs/: Caminho de aprendizagem completo com 13 laboratórios para construir servidores MCP prontos para produção com integração PostgreSQL
- images/: Diagramas e ilustrações utilizados 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 especificação MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Documentos de governança do projeto
🎒 Outros Cursos
A nossa equipa 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
- Dominar o GitHub Copilot para Programadores C#/.NET
- Escolhe a Tua Própria Aventura com o Copilot
™️ Aviso de Marca Registada
Este projeto pode conter marcas registadas ou logótipos de projetos, produtos ou serviços. O uso autorizado de marcas registadas ou logótipos da Microsoft está sujeito às
Diretrizes de Marcas e Logótipos da Microsoft e deve segui-las.
O uso de marcas registadas ou logótipos da Microsoft em versões modificadas deste projeto não deve causar confusão ou implicar patrocínio por parte da Microsoft.
Qualquer uso de marcas registadas ou logótipos de terceiros está sujeito às políticas desses terceiros.
Obter Ajuda
Se estiveres com dificuldades ou tiveres perguntas sobre como criar aplicações de IA, junta-te a:
Se tiveres feedback sobre produtos ou erros durante o desenvolvimento, visita:
Aviso:
Este documento foi traduzido utilizando o serviço de tradução por IA Co-op Translator. Embora nos esforcemos pela precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte autoritária. 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 decorrentes do uso desta tradução.