Siga estes passos para começar a usar estes recursos:
- Fork do Repositório: Clique em
- Clone do Repositório:
git clone https://github.com/microsoft/mcp-for-beginners.git - Junte-se ao
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese
Prefere Clonar Localmente?
Este repositório inclui traduções em mais de 50 idiomas, o que aumenta significativamente o tamanho do download. Para clonar sem as traduções, use sparse checkout:
Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git cd mcp-for-beginners git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git cd mcp-for-beginners git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"Isto fornece tudo o que precisa para completar o curso com um download muito mais rápido.
Bem-vindo à sua jornada no Model Context Protocol! Se alguma vez se perguntou como as aplicações de IA comunicam com diferentes ferramentas e serviços, está prestes a descobrir a solução elegante que está a transformar a forma como os desenvolvedores constroem sistemas inteligentes.
Pense no MCP como um tradutor universal para aplicações de IA — tal como as portas USB permitem ligar qualquer dispositivo ao seu computador, o MCP permite que os modelos de IA se liguem a qualquer ferramenta ou serviço de forma padronizada. Quer esteja a construir o seu primeiro chatbot ou a trabalhar em fluxos complexos de IA, compreender o MCP vai dar-lhe o poder de criar aplicações mais capazes e flexíveis.
Este currículo foi concebido com paciência e cuidado para a sua jornada de aprendizagem. Começaremos com conceitos simples que já conhece e construiremos gradualmente a sua expertise através de prática hands-on na sua linguagem de programação favorita. Cada passo inclui explicações claras, exemplos práticos e muito incentivo pelo caminho.
Quando terminar esta jornada, terá a confiança para construir os seus próprios servidores MCP, integrá-los com plataformas de IA populares e entender como esta tecnologia está a remodelar o futuro do desenvolvimento de IA. Vamos começar esta aventura entusiasmante juntos!
Este currículo está alinhado com a Especificação MCP 2025-11-25 (a última versão estável). A especificação MCP usa versionamento baseado em data (formato AAAA-MM-DD) para garantir rastreabilidade clara da versão do protocolo.
Estes recursos tornam-se mais valiosos conforme o seu entendimento cresce, mas não se sinta pressionado a ler tudo imediatamente. Comece pelas áreas que mais lhe interessam!
- 📘 Documentação MCP – Este é o seu recurso principal para tutoriais passo a passo e guias de utilizador. A documentação é escrita para iniciantes, fornecendo exemplos claros que pode acompanhar ao seu próprio ritmo.
- 📜 Especificação MCP – Pense nisto como o seu manual de referência completo. À medida que trabalha no currículo, voltará aqui para consultar detalhes específicos e explorar funcionalidades avançadas.
- 📜 Versionamento da Especificação MCP – Contém informações sobre o histórico de versões do protocolo e como o MCP utiliza versionamento baseado em data (formato AAAA-MM-DD).
- 🧑💻 Repositório MCP no GitHub – Aqui encontrará SDKs, ferramentas e exemplos de código em várias linguagens de programação. É como um tesouro de exemplos práticos e componentes prontos a usar.
- 🌐 Comunidade MCP – Junte-se a outros aprendizes e desenvolvedores experientes em discussões sobre o MCP. É uma comunidade solidária onde perguntas são bem-vindas e o conhecimento é partilhado livremente.
No final deste currículo, sentirá confiança e entusiasmo pelas suas novas capacidades. Eis o que irá alcançar:
• Compreender os fundamentos do MCP: Vai entender o que é o Model Context Protocol e porque é que está a revolucionar a forma como as aplicações de IA colaboram, usando analogias e exemplos fáceis de compreender.
• Construir o seu primeiro servidor MCP: Vai criar um servidor MCP funcional na sua linguagem de programação preferida, começando com exemplos simples e desenvolvendo as suas competências passo a passo.
• Ligar modelos de IA a ferramentas reais: Vai aprender como fazer a ponte entre modelos de IA e serviços reais, conferindo às suas aplicações capacidades novas e potentes.
• Implementar as melhores práticas de segurança: Vai entender como manter as suas implementações MCP seguras, protegendo tanto as suas aplicações como os seus utilizadores.
• Desenvolver com confiança: Vai saber como levar os seus projetos MCP do desenvolvimento à produção, com estratégias práticas de implantação que funcionam no mundo real.
• Juntar-se à comunidade MCP: Vai tornar-se parte de uma comunidade crescente de desenvolvedores que estão a moldar o futuro do desenvolvimento de aplicações de IA.
Antes de mergulharmos nas especificidades do MCP, vamos garantir que se sente confortável com alguns conceitos fundamentais. Não se preocupe se não for um especialista nestas áreas — explicaremos tudo o que precisa saber ao longo do percurso!
Pense num protocolo como as regras de uma conversa. Quando liga a um amigo, ambos sabem dizer "olá" ao atender, falar alternadamente e dizer "adeus" quando termina. Os programas informáticos precisam de regras semelhantes para comunicar eficazmente.
O MCP é um protocolo — um conjunto de regras acordadas que ajudam modelos de IA e aplicações a terem "conversas" produtivas com ferramentas e serviços. Tal como as regras tornam a comunicação humana mais fluida, o MCP torna a comunicação entre aplicações de IA muito mais fiável e poderosa.
Já utiliza relações cliente-servidor todos os dias! Quando usa um navegador (o cliente) para visitar um site, está a ligar-se a um servidor web que lhe envia o conteúdo da página. O navegador sabe como pedir informação, e o servidor sabe como responder.
No MCP, temos uma relação semelhante: os modelos de IA atuam como clientes que solicitam informações ou ações, enquanto os servidores MCP fornecem essas capacidades. É como ter um assistente útil (o servidor) a quem a IA pode pedir para realizar tarefas específicas.
Imagine se cada fabricante de automóveis usasse formatos diferentes para os bicos de abastecimento — teria de ter um adaptador diferente para cada carro! A padronização significa concordar em abordagens comuns para que as coisas funcionem em conjunto sem problemas.
O MCP fornece esta padronização para aplicações de IA. Em vez de cada modelo de IA precisar de código personalizado para funcionar com cada ferramenta, o MCP cria uma forma universal de comunicação. Isto significa que os desenvolvedores podem construir ferramentas uma vez e fazê-las funcionar com muitos sistemas de IA diferentes.
A sua jornada MCP está cuidadosamente estruturada para desenvolver a sua confiança e competências progressivamente. Cada fase apresenta novos conceitos enquanto reforça o que já aprendeu.
É aqui que a sua aventura começa! Vamos apresentar-lhe os conceitos do MCP usando analogias familiares e exemplos simples. Vai entender o que é o MCP, por que existe e como se enquadra no mundo maior do desenvolvimento de IA.
• Módulo 0 - Introdução ao MCP: Começaremos por explorar o que é o MCP e porque é tão importante para as aplicações modernas de IA. Verá exemplos reais de MCP em ação e compreenderá como resolve problemas comuns que os desenvolvedores enfrentam.
• Módulo 1 - Conceitos Centrais Explicados: Aqui vai aprender os blocos essenciais do MCP. Usaremos muitas analogias e exemplos visuais para garantir que estes conceitos fiquem naturais e compreensíveis.
• Módulo 2 - Segurança no MCP: A segurança pode parecer intimidante, mas vamos mostrar-lhe como o MCP inclui funcionalidades de segurança incorporadas e ensinar-lhe as melhores práticas para proteger as suas aplicações desde o início.
Agora começa a verdadeira diversão! Terá experiência prática a construir servidores e clientes MCP reais. Não se preocupe – vamos começar pelo básico e guiá-lo em cada passo.
Este módulo inclui vários guias práticos que lhe permitem praticar na sua linguagem de programação preferida. Vai criar o seu primeiro servidor, construir um cliente para se ligar a ele e até integrar com ferramentas de desenvolvimento populares como o VS Code.
Cada guia inclui exemplos de código completos, dicas para resolução de problemas e explicações sobre as razões pelas quais fazemos escolhas específicas de design. No final desta fase, terá implementações MCP a funcionar das quais poderá orgulhar-se!
Com o básico dominado, está pronto para explorar funcionalidades MCP mais sofisticadas. Vamos cobrir estratégias práticas de implementação, técnicas de depuração e tópicos avançados como a integração de IA multimodal.
Também vai aprender a escalar as suas implementações MCP para uso em produção e integrar com plataformas cloud como a Azure. Estes módulos preparam-no para construir soluções MCP que respondem às demandas do mundo real.
A fase final foca-se em juntar-se à comunidade MCP e especializar-se nas áreas que mais lhe interessam. Vai aprender a contribuir para projetos MCP open-source, implementar padrões avançados de autenticação e construir soluções abrangentes integradas com bases de dados.
O Módulo 11 merece uma menção especial - é um percurso completo de aprendizagem prática com 13 laboratórios que ensina a construir servidores MCP prontos para produção com integração PostgreSQL. É como um projeto final que junta tudo o que aprendeu!
| Módulo | Tema | Descrição | Link |
|---|---|---|---|
| Módulos 0-3: Fundamentos | |||
| 00 | Introdução ao MCP | Visão geral do Protocolo de Contexto de Modelo e sua importância em pipelines de IA | Ler mais |
| 01 | Conceitos Base Explicados | Exploração aprofundada dos conceitos principais do MCP | Ler mais |
| 02 | Segurança no MCP | Ameaças à segurança e melhores práticas | Ler mais |
| 03 | Primeiros Passos com MCP | Configuração do ambiente, servidores/clientes básicos, integração | Ler mais |
| Módulo 3: Construindo o seu Primeiro Servidor & Cliente | |||
| 3.1 | Primeiro Servidor | Crie o seu primeiro servidor MCP | Guia |
| 3.2 | Primeiro Cliente | Desenvolva um cliente MCP básico | Guia |
| 3.3 | Cliente com LLM | Integre grandes modelos de linguagem | Guia |
| 3.4 | Integração 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 | AI Toolkit | Use AI Toolkit com MCP | Guia |
| 3.8 | Testes | Teste a sua implementação de servidor MCP | Guia |
| 3.9 | Deploy | Faça o deployment dos servidores MCP para produção | Guia |
| 3.10 | Uso avançado de servidores | Utilize servidores avançados para uso de funcionalidades avançadas e arquitetura melhorada | Guia |
| 3.11 | Autenticação simples | Um capítulo que mostra autenticação desde o início e RBAC | Guia |
| 3.12 | Hosts MCP | Configure Claude Desktop, Cursor, Cline e outros hosts MCP | Guia |
| 3.13 | MCP Inspector | Debug e teste servidores MCP com a ferramenta Inspector | Guia |
| 3.14 | Amostragem | Use amostragem para colaborar com o cliente | Guia |
| 3.15 | Apps MCP | Construa Apps MCP | Guia |
| Módulos 4-5: Prático & Avançado | |||
| 04 | Implementação Prática | SDKs, debugging, testes, templates reutilizáveis para prompts | Ler mais |
| 4.1 | Paginação | Trate conjuntos grandes de resultados com paginação baseada em cursor | Guia |
| 05 | Tópicos Avançados no MCP | IA multimodal, escalabilidade, uso empresarial | Ler mais |
| 5.1 | Integração Azure | Integração MCP com Azure | Guia |
| 5.2 | Multimodalidade | Trabalhar com múltiplas modalidades | Guia |
| 5.3 | Demo OAuth2 | Implementar autenticação OAuth2 | Guia |
| 5.4 | Contextos Raiz | Compreender e implementar contextos raiz | Guia |
| 5.5 | Roteamento | Estratégias de roteamento MCP | Guia |
| 5.6 | Amostragem | Técnicas de amostragem no MCP | Guia |
| 5.7 | Escalabilidade | Escale implementações MCP | Guia |
| 5.8 | Segurança | Considerações avançadas de segurança | Guia |
| 5.9 | Pesquisa Web | Implemente capacidades de pesquisa 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 Foundry | Integre com Azure AI Foundry | Guia |
| 5.14 | Engenharia do Contexto | Técnicas para engenharia eficaz de contexto | Guia |
| 5.15 | Transporte Personalizado MCP | Implementações personalizadas de transporte | Guia |
| 5.16 | Funcionalidades do Protocolo | Notificações de progresso, cancelamento, templates de recursos | Guia |
| Módulos 6-10: Comunidade & Melhores Práticas | |||
| 06 | Contribuições da Comunidade | Como contribuir para o ecossistema MCP | Guia |
| 07 | Lições da Adoção Inicial | Histórias de implementação no mundo real | Guia |
| 08 | Melhores Práticas para MCP | Performance, tolerância a falhas, resiliência | Guia |
| 09 | Estudos de Caso MCP | Exemplos práticos de implementação | Guia |
| 10 | Workshop Prático | Construindo um Servidor MCP com AI Toolkit | Lab |
| Módulo 11: Laboratório Prático Servidor MCP | |||
| 11 | Integração Servidor MCP com Base de Dados | Percurso de aprendizagem prático com 13 laboratórios para integração PostgreSQL | Labs |
| 11.1 | Introdução | Visão geral do MCP com integração de base de dados e caso de uso de análise retail | Lab 00 |
| 11.2 | Arquitectura Core | Compreensão da arquitetura de servidor MCP, camadas de base de dados e padrões de segurança | Lab 01 |
| 11.3 | Segurança & Multi-Tenancy | Segurança ao nível das linhas, autenticação, e acesso multi-inquilino a dados | Lab 02 |
| 11.4 | Configuração do Ambiente | Configuração do ambiente de desenvolvimento, Docker, recursos Azure | Lab 03 |
| 11.5 | Design da Base de Dados | Configuração PostgreSQL, design de esquema retail e dados de amostra | 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 query a base de dados e introspecção de esquemas | Lab 06 |
| 11.8 | Pesquisa Semântica | Implementação de embeddings vetoriais com Azure OpenAI e pgvector | Lab 07 |
| 11.9 | Testes & Depuração | Estratégias de teste, ferramentas de depuração e abordagens de validação | Lab 08 |
| 11.10 | Integração VS Code | Configuração da integração MCP no VS Code e uso do AI Chat | Lab 09 |
| 11.11 | Estratégias de Deploy | Deploy através de Docker, Azure Container Apps e considerações sobre escalabilidade | Lab 10 |
| 11.12 | Monitorização | Application Insights, logging, monitorização de performance | Lab 11 |
| 11.13 | Melhores Práticas | Otimização de performance, reforço de segurança e dicas para produção | Lab 12 |
Uma das partes mais entusiasmantes ao aprender MCP é ver as suas competências de código desenvolverem-se progressivamente. Projetámos os nossos exemplos de código para começarem simples e tornarem-se mais sofisticados à medida que a sua compreensão aprofunda. Eis como introduzimos os conceitos – com código fácil de entender mas que demonstra princípios reais do MCP; vai entender não só o que este código faz, mas por que está estruturado assim e como se encaixa em aplicações MCP maiores.
| Linguagem | Descrição | Link |
|---|---|---|
| C# | Exemplo de Servidor MCP | Ver Código |
| Java | Calculadora MCP | Ver Código |
| JavaScript | Demo 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 Container App | Ver Código |
| JavaScript | Exemplo Avançado | Ver Código |
| Python | Implementação Complexa | Ver Código |
| TypeScript | Exemplo Container | Ver Código |
Para tirar o máximo proveito deste currículo, deve 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 os conceitos REST e HTTP
-
(Opcional) Conhecimentos em conceitos de IA/ML
-
Participar nas discussões da nossa comunidade para apoio
Este repositório inclui vários recursos para o ajudar a navegar e aprender de forma eficaz:
Um Guia de Estudo abrangente está disponível para o ajudar a navegar neste repositório de forma eficaz. Este mapa visual do currículo mostra como todos os tópicos se conectam e fornece orientações sobre como usar os projetos de exemplo de forma eficaz. É especialmente útil se for um aprendiz visual que gosta de ver o panorama geral.
O guia inclui:
- Um mapa visual do currículo mostrando todos os tópicos abordados
- Descrição detalhada de cada secção do repositório
- Orientação sobre como usar os projetos de exemplo
- Caminhos de aprendizagem recomendados para diferentes níveis de competência
- Recursos adicionais para complementar a sua jornada de aprendizagem
Mantemos um detalhado Registo de Alterações que acompanha todas as atualizações significativas dos materiais do currículo, para que possa manter-se atualizado com as últimas melhorias e adições.
- Novos conteúdos adicionados
- Mudanças estruturais
- Melhorias de funcionalidades
- Atualizações da documentação
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 extra para alunos avançados
Vamos aprender sobre o Model Context Protocol (MCP), uma estrutura inovadora destinada a padronizar as interações entre modelos de IA e aplicações cliente. Nesta sessão para iniciantes, vamos apresentar-lhe o MCP e guiá-lo na criação do seu primeiro servidor MCP.
JavaScript: https://aka.ms/letslearnmcp-javascript
Parabéns! Acaba de dar o primeiro passo numa jornada emocionante que irá expandir as suas capacidades de programação e conectá-lo ao que há de mais avançado no desenvolvimento de IA.
Ao ler esta introdução, já começou a construir a sua base de conhecimento em MCP. Compreende o que é o MCP, porque é importante e como este currículo irá apoiar a sua jornada de aprendizagem. Isso é uma conquista significativa e o início da sua especialização nesta tecnologia importante.
À medida que avança pelos módulos, lembre-se de que todo especialista foi um dia um iniciante. Os conceitos que agora lhe parecem complexos tornar-se-ão naturais à medida que pratica e os aplica. Cada pequeno passo constrói capacidades poderosas que o irão servir ao longo da sua carreira de desenvolvimento.
Está a juntar-se a uma comunidade de aprendizes e especialistas apaixonados pelo MCP e ansiosos por ajudar outros a ter sucesso. Quer esteja bloqueado num desafio de codificação ou entusiasmado para partilhar uma descoberta, a comunidade está aqui para apoiar a sua jornada.
Se ficar bloqueado ou tiver dúvidas sobre como construir aplicações de IA, junte-se a outros aprendizes e a desenvolvedores experientes nas discussões sobre MCP. É uma comunidade solidária onde as perguntas são bem-vindas e o conhecimento é partilhado livremente.
Se tiver feedback sobre o produto ou erros durante a construção, visite:
A sua aventura MCP começa agora! Comece pelo Módulo 0 para mergulhar nos seus primeiros exercícios práticos de MCP, ou explore os projetos de exemplo para ver o que irá construir. Lembre-se - todo especialista começou exatamente onde está agora, e com paciência e prática ficará surpreendido com o que pode alcançar.
Bem-vindo ao mundo do desenvolvimento do Model Context Protocol. Vamos construir algo incrível juntos!
Este currículo torna-se mais forte com as contribuições de aprendizes como você! Quer esteja a corrigir um erro tipográfico, a sugerir uma explicação mais clara ou a adicionar um novo exemplo, as suas contribuições ajudam outros iniciantes a terem sucesso.
Obrigado ao Microsoft Valued Professional Shivam Goyal por contribuir com exemplos de código.
O processo de contribuição foi concebido para ser acolhedor e de apoio. A maioria das contribuições requer um Acordo de Licença de Contribuinte (CLA), mas as ferramentas automatizadas irão guiá-lo pelo processo com facilidade.
Todo este currículo está disponível sob a licença MIT LICENSE, o que significa que pode usá-lo, modificá-lo e partilhá-lo livremente. Isto apoia a nossa missão de tornar o conhecimento sobre MCP acessível a desenvolvedores em todo o mundo.
Este projeto acolhe contribuições e sugestões. A maioria das contribuições exige que concorde com um Acordo de Licença de Contribuinte (CLA) declarando que tem o direito e efetivamente concede-nos os direitos para usar a sua contribuição. Para mais detalhes, visite https://cla.opensource.microsoft.com.
Quando submeter um pedido de pull, um bot CLA determinará automaticamente se precisa de fornecer um CLA e irá decorar o PR adequadamente (ex.: verificação de estado, comentário). Simplesmente siga as instruções fornecidas pelo bot. Só precisará de o fazer uma vez para todos os repositórios que usam o nosso CLA.
Este projeto adotou o Código de Conduta Open Source da Microsoft. Para mais informações veja o FAQ do Código de Conduta ou contacte opencode@microsoft.com para quaisquer dúvidas ou comentários adicionais.
Pronto para começar a sua jornada MCP? Comece com o Módulo 00 - Introdução ao MCP e dê os seus primeiros passos no mundo do desenvolvimento do Model Context Protocol!
A nossa equipa produz outros cursos! Confira:
-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA){kind=icon}
-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC){kind=icon}
-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9){kind=icon}
Aviso Legal:
Este documento foi traduzido utilizando o serviço de tradução automática Co-op Translator. Embora nos esforcemos para garantir a precisão, por favor 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 autoritativa. Para informações críticas, recomenda-se tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações erradas decorrentes do uso desta tradução.