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 - Participe do Discord do Azure AI Foundry 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 | 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
O Model Context Protocol (MCP) é uma estrutura inovadora projetada 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 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 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 | Primeiros Passos 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 |
| 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 funcionalidade 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 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 | 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 |
| 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 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 |
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 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 Registro de Alterações detalhado que rastreia todas as atualizações significativas nos materiais do currículo, incluindo:
- Adições de novos conteúdos
- Mudanças 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 profundos, conexão com a comunidade e aprendizado prático no MCP Dev Days, um evento virtual dedicado ao Protocolo de Contexto de Modelo (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 desenvolvedores a usar MCP em seus fluxos 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 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
Se você está começando com MCP ou já está construindo 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 integrá-los aos 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 Gerenciamento de APIs
- 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 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 a nós,
os direitos de usar 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 (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 usam nosso CLA.
Este projeto adotou o Código de Conduta de Código Aberto da Microsoft.
Para mais informações, veja as Perguntas Frequentes sobre o Código de Conduta ou
entre em contato com opencode@microsoft.com para quaisquer perguntas 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 Par 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 automatizadas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autoritativa. 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.