MCP-para-iniciantes

Contribuidores do GitHub Problemas no GitHub Pull Requests no GitHub PRs Bem-vindos

Observadores no GitHub Forks no GitHub Estrelas no GitHub

Discord do Microsoft Azure AI Foundry

Siga estas etapas para começar a usar esses recursos:

  1. Faça um Fork do Repositório: Clique Forks no GitHub
  2. Clone o Repositório: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. 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

🧭 Visão Geral do Currículo MCP

📚 Estrutura Completa do Currículo

MóduloTópicoDescriçãoLink
Módulo 1-3: Fundamentos
00Introdução ao MCPVisão geral do Model Context Protocol e sua importância em pipelines de IALeia mais
01Conceitos Centrais ExplicadosExploração detalhada dos conceitos centrais do MCPLeia mais
02Segurança no MCPAmeaças de segurança e melhores práticasLeia mais
03Começando com MCPConfiguração do ambiente, servidores/clientes básicos, integraçãoLeia mais
Módulo 3: Construindo Seu Primeiro Servidor e Cliente
3.1Primeiro ServidorCrie seu primeiro servidor MCPGuia
3.2Primeiro ClienteDesenvolva um cliente MCP básicoGuia
3.3Cliente com LLMIntegre modelos de linguagem grandesGuia
3.4Integração com VS CodeConsuma servidores MCP no VS CodeGuia
3.5Servidor stdioCrie servidores usando transporte stdioGuia
3.6Streaming HTTPImplemente streaming HTTP no MCPGuia
3.7Toolkit de IAUse o Toolkit de IA com MCPGuia
3.8TestesTeste sua implementação de servidor MCPGuia
3.9ImplantaçãoImplemente servidores MCP em produçãoGuia
3.10Uso avançado de servidorUse servidores avançados para recursos avançados e arquitetura aprimoradaGuia
3.11Autenticação simplesUm capítulo mostrando autenticação desde o início e RBACGuia
Módulo 4-5: Prático e Avançado
04Implementação PráticaSDKs, depuração, testes, templates reutilizáveis de promptsLeia mais
05Tópicos Avançados no MCPIA multimodal, escalabilidade, uso corporativoLeia mais
5.1Integração com AzureIntegração do MCP com AzureGuia
5.2MultimodalidadeTrabalhando com múltiplas modalidadesGuia
5.3Demonstração OAuth2Implemente autenticação OAuth2Guia
5.4Contextos RaizEntenda e implemente contextos raizGuia
5.5RoteamentoEstratégias de roteamento no MCPGuia
5.6AmostragemTécnicas de amostragem no MCPGuia
5.7EscalabilidadeEscale implementações do MCPGuia
5.8SegurançaConsiderações avançadas de segurançaGuia
5.9Busca na WebImplemente capacidades de busca na webGuia
5.10Streaming em Tempo RealConstrua funcionalidades de streaming em tempo realGuia
5.11Busca em Tempo RealImplemente busca em tempo realGuia
5.12Autenticação com Entra IDAutenticação com Microsoft Entra IDGuia
5.13Integração com FoundryIntegre com Azure AI FoundryGuia
5.14Engenharia de ContextoTécnicas para engenharia de contexto eficazGuia
5.15Transporte Personalizado do MCPImplementações de transporte personalizadoGuia
Módulo 6-10: Comunidade e Melhores Práticas
06Contribuições da ComunidadeComo contribuir para o ecossistema MCPGuia
07Insights da Adoção InicialHistórias de implementação no mundo realGuia
08Melhores Práticas para MCPDesempenho, tolerância a falhas, resiliênciaGuia
09Estudos de Caso do MCPExemplos práticos de implementaçãoGuia
10Workshop PráticoConstruindo um Servidor MCP com Toolkit de IALaboratório
Módulo 11: Laboratório Prático de Servidor MCP
11Integração de Banco de Dados com Servidor MCPCaminho de aprendizado prático com 13 laboratórios para integração com PostgreSQLLaboratórios
11.1IntroduçãoVisão geral do MCP com integração de banco de dados e caso de uso de análise de varejoLaboratório 00
11.2Arquitetura PrincipalCompreendendo a arquitetura do servidor MCP, camadas de banco de dados e padrões de segurançaLab 01
11.3Segurança e Multi-TenancySegurança em nível de linha, autenticação e acesso a dados multi-tenantLab 02
11.4Configuração do AmbienteConfiguração do ambiente de desenvolvimento, Docker, recursos do AzureLab 03
11.5Design de Banco de DadosConfiguração do PostgreSQL, design de esquema de varejo e dados de exemploLab 04
11.6Implementação do Servidor MCPConstruindo o servidor FastMCP com integração ao banco de dadosLab 05
11.7Desenvolvimento de FerramentasCriando ferramentas de consulta de banco de dados e introspecção de esquemaLab 06
11.8Busca SemânticaImplementando embeddings vetoriais com Azure OpenAI e pgvectorLab 07
11.9Testes e DepuraçãoEstratégias de teste, ferramentas de depuração e abordagens de validaçãoLab 08
11.10Integração com VS CodeConfigurando integração do MCP no VS Code e uso do AI ChatLab 09
11.11Estratégias de ImplantaçãoImplantação com Docker, Azure Container Apps e considerações de escalabilidadeLab 10
11.12MonitoramentoApplication Insights, registro de logs e monitoramento de desempenhoLab 11
11.13Melhores PráticasOtimização de desempenho, reforço de segurança e dicas para produçãoLab 12

💻 Projetos de Código de Exemplo

Exemplos Básicos de Calculadora MCP

LinguagemDescriçãoLink
C#Exemplo de Servidor MCPVer Código
JavaCalculadora MCPVer Código
JavaScriptDemonstração MCPVer Código
PythonServidor MCPVer Código
TypeScriptExemplo MCPVer Código
RustExemplo MCPVer Código

Implementações Avançadas de MCP

LinguagemDescriçãoLink
C#Exemplo AvançadoVer Código
Java com SpringExemplo de Aplicativo em ContêinerVer Código
JavaScriptExemplo AvançadoVer Código
PythonImplementação ComplexaVer Código
TypeScriptExemplo de ContêinerVer 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:

  1. Explicações claras dos conceitos de MCP
  2. Exemplos de código ao vivo em várias linguagens
  3. Exercícios para construir aplicações reais de MCP
  4. 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:

™️ 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:

Azure AI Foundry Discord

Se você tiver feedback sobre o produto ou encontrar erros durante o desenvolvimento, visite:

Azure AI Foundry Developer Forum


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.