MCP-para-iniciantes

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

Observadores no GitHub Forks no GitHub Estrelas no GitHub

Microsoft Azure AI Foundry Discord

Siga estes passos para começar a utilizar estes 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 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

🧭 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
01Explicação dos Conceitos CentraisExploraçã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 de grande escalaGuia
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 servidoresUse 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 empresarialLeia 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.9Pesquisa na WebImplemente capacidades de pesquisa na webGuia
5.10Streaming em Tempo RealConstrua funcionalidades de streaming em tempo realGuia
5.11Pesquisa em Tempo RealImplemente pesquisa em tempo realGuia
5.12Autenticação 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 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 o Toolkit de IALaboratório
Módulo 11: Laboratório Prático de Servidor MCP
11Integração de Banco de Dados com Servidor MCPCaminho de aprendizagem 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 retalhoLaboratório 00
11.2Arquitetura PrincipalCompreender a arquitetura do servidor MCP, camadas de base de dados e padrões de segurançaLab 01
11.3Segurança e Multi-TenancySegurança ao nível de linha, autenticação e acesso a dados multi-inquilinoLab 02
11.4Configuração do AmbienteConfiguração do ambiente de desenvolvimento, Docker, recursos AzureLab 03
11.5Design de Base de DadosConfiguração do PostgreSQL, design de esquema de retalho e dados de exemploLab 04
11.6Implementação do Servidor MCPConstrução do servidor FastMCP com integração de base de dadosLab 05
11.7Desenvolvimento de FerramentasCriação de ferramentas de consulta de base de dados e introspeção de esquemaLab 06
11.8Pesquisa SemânticaImplementação de 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 CodeConfiguração da integração MCP no VS Code e utilização do Chat AILab 09
11.11Estratégias de ImplementaçãoImplementação com Docker, Azure Container Apps e considerações de escalabilidadeLab 10
11.12MonitorizaçãoApplication Insights, registo de logs, monitorização 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 Aplicação em ContainerVer Código
JavaScriptExemplo AvançadoVer Código
PythonImplementação ComplexaVer Código
TypeScriptExemplo de ContainerVer 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:

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

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

Azure AI Foundry Discord

Se tiveres feedback sobre produtos ou erros durante o desenvolvimento, visita:

Azure AI Foundry Developer Forum


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.