mirrors / microsoft--mcp-for-beginners

项目文件夹

文件

T

wehub-resource-sync c275ba2868 chore: import upstream snapshot with attribution

2026-07-13 13:31:35 +08:00

37 KiB

原始文件 永久链接 Blame 文件历史

Siga estes passos para começar a usar esses recursos:

Fork o Repositório: Clique em
Clone o Repositório: git clone https://github.com/microsoft/mcp-for-beginners.git
Entre no

🌐 Suporte Multilíngue

Suportado via Ação do GitHub (Automatizado e Sempre Atualizado)

Prefere clonar localmente?

Este repositório inclui mais de 50 traduções de idiomas que aumentam significativamente o tamanho do download. Para clonar sem as traduções, use checkout esparso:

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"
Isso lhe fornece tudo o que precisa para completar o curso com um download muito mais rápido.

🚀 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

Bem-vindo à sua jornada pelo Model Context Protocol! Se você já se perguntou como as aplicações de IA se comunicam com diferentes ferramentas e serviços, está prestes a descobrir a solução elegante que está transformando a forma como desenvolvedores constroem sistemas inteligentes.

Pense no MCP como um tradutor universal para aplicações de IA - assim como as portas USB permitem conectar qualquer dispositivo ao seu computador, o MCP permite que modelos de IA se conectem a qualquer ferramenta ou serviço de maneira padronizada. Seja construindo seu primeiro chatbot ou trabalhando em fluxos de trabalho complexos de IA, entender o MCP lhe dará o poder de criar aplicações mais capazes e flexíveis.

Este currículo foi criado com paciência e cuidado para sua jornada de aprendizado. Começaremos com conceitos simples que você já conhece e gradualmente construiremos sua expertise através da prática em sua linguagem de programação favorita. Cada etapa inclui explicações claras, exemplos práticos e muito incentivo ao longo do caminho.

Quando completar esta jornada, você terá a confiança para construir seus próprios servidores MCP, integrá-los com plataformas populares de IA e compreender como essa tecnologia está remodelando o futuro do desenvolvimento em IA. Vamos começar esta empolgante aventura juntos!

Documentação Oficial e Especificações

Este currículo está alinhado com a Especificação MCP 2025-11-25 (a versão estável mais recente). A especificação MCP usa versionamento baseado em datas (formato AAAA-MM-DD) para garantir rastreabilidade clara das versões do protocolo.

Esses recursos tornam-se mais valiosos à medida que seu entendimento cresce, mas não se sinta pressionado a ler tudo imediatamente. Comece pelas áreas que mais lhe interessam!

📘 Documentação MCP – Este é seu recurso principal para tutoriais passo a passo e guias do usuário. A documentação é escrita pensando em iniciantes, oferecendo exemplos claros que você pode acompanhar no seu próprio ritmo.
📜 Especificação MCP – Pense nisso como seu manual de referência abrangente. Conforme avança no currículo, você certamente voltará aqui para consultar detalhes específicos e explorar recursos avançados.
📜 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 datas (formato AAAA-MM-DD).
🧑‍💻 Repositório MCP no GitHub – Aqui você 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 para uso.
🌐 Comunidade MCP – Junte-se a outros aprendizes e desenvolvedores experientes em discussões sobre MCP. É uma comunidade acolhedora onde perguntas são bem-vindas e o conhecimento é compartilhado livremente.

Objetivos de Aprendizado

Ao final deste currículo, você se sentirá confiante e entusiasmado com suas novas habilidades. Veja o que você alcançará:

• Compreender os fundamentos do MCP: Você entenderá o que é o Model Context Protocol e por que ele está revolucionando a forma como aplicações de IA trabalham em conjunto, usando analogias e exemplos que fazem sentido.

• Construir seu primeiro servidor MCP: Você criará um servidor MCP funcional na sua linguagem de programação preferida, começando com exemplos simples e desenvolvendo suas habilidades gradativamente.

• Conectar modelos de IA a ferramentas reais: Você aprenderá a fazer a ponte entre modelos de IA e serviços reais, oferecendo às suas aplicações capacidades poderosas e novas.

• Implementar melhores práticas de segurança: Você entenderá como manter suas implementações MCP seguras, protegendo tanto suas aplicações quanto seus usuários.

• Fazer deploy com confiança: Você saberá como levar seus projetos MCP do desenvolvimento à produção, com estratégias práticas de implantação que funcionam no mundo real.

• Entrar na comunidade MCP: Você fará parte de uma comunidade crescente de desenvolvedores que estão moldando o futuro do desenvolvimento de aplicações de IA.

Conhecimentos Básicos Essenciais

Antes de mergulharmos nos detalhes do MCP, vamos garantir que você esteja confortável com alguns conceitos fundamentais. Não se preocupe se não for especialista nessas áreas — explicaremos tudo o que você precisa saber durante o percurso!

Entendendo Protocolos (A Base)

Pense em um protocolo como as regras de uma conversa. Quando você liga para um amigo, ambos sabem dizer "olá" ao atender, falar alternadamente e dizer "tchau" ao finalizar. Programas de computador precisam de regras similares para se comunicarem efetivamente.

O MCP é um protocolo — um conjunto de regras combinadas que ajudam modelos e aplicações de IA a manter “conversas” produtivas com ferramentas e serviços. Assim como regras de conversa tornam a comunicação humana mais fluida, ter MCP torna a comunicação de aplicações de IA muito mais confiável e poderosa.

Relações Cliente-Servidor (Como Programas Trabalham Juntos)

Você já usa relações cliente-servidor todos os dias! Quando usa um navegador (cliente) para visitar um site, conecta-se a um servidor web que envia o conteúdo da página. O navegador sabe como pedir informações; o servidor sabe como responder.

No MCP, temos uma relação similar: modelos de IA atuam como clientes que solicitam informações ou ações, enquanto servidores MCP fornecem essas capacidades. É como ter um assistente prestativo (o servidor) que o IA pode pedir para executar tarefas específicas.

Por Que a Padronização Importa (Fazendo as Coisas Funcionarem Juntas)

Imagine se cada fabricante de carros usasse diferentes formatos de bombas de combustível — você precisaria de um adaptador diferente para cada carro! Padronização significa concordar em abordagens comuns para que as coisas funcionem juntas sem problemas.

O MCP oferece essa padronização para aplicações de IA. Em vez de cada modelo de IA precisar de código personalizado para cada ferramenta, o MCP cria um jeito universal deles se comunicarem. Isso significa que desenvolvedores podem construir ferramentas uma vez e fazê-las funcionar com muitos sistemas de IA diferentes.

🧭 Visão Geral do Seu Caminho de Aprendizado

Sua jornada MCP é cuidadosamente estruturada para desenvolver sua confiança e habilidades progressivamente. Cada fase introduz novos conceitos enquanto reforça o que você já aprendeu.

🌱 Fase Fundacional: Entendendo o Básico (Módulos 0-2)

É aqui que sua aventura começa! Apresentaremos conceitos do MCP usando analogias familiares e exemplos simples. Você entenderá o que é MCP, por que ele existe e como se encaixa no mundo maior do desenvolvimento de IA.

• Módulo 0 - Introdução ao MCP: Começaremos explorando o que é MCP e por que ele é tão importante para aplicações modernas de IA. Você verá exemplos reais de MCP em ação e entenderá como ele resolve problemas comuns enfrentados por desenvolvedores.

• Módulo 1 - Conceitos Principais Explicados: Aqui você aprenderá os blocos essenciais de construção do MCP. Usaremos muitas analogias e exemplos visuais para garantir que esses conceitos sejam naturais e compreensíveis.

• Módulo 2 - Segurança no MCP: Segurança pode parecer intimidadora, mas mostraremos como o MCP inclui recursos de segurança embutidos e ensinaremos as melhores práticas para proteger suas aplicações desde o início.

🔨 Fase de Construção: Criando Suas Primeiras Implementações (Módulo 3)

Agora a diversão de verdade começa! Você terá experiência prática construindo servidores e clientes MCP reais. Não se preocupe - começaremos simples e o guiaremos em cada etapa.

Este módulo inclui vários guias práticos que permitem que você pratique na sua linguagem de programação preferida. Você criará seu primeiro servidor, construirá um cliente para se conectar a ele e até integrará com ferramentas de desenvolvimento populares como o VS Code.

Cada guia inclui exemplos completos de código, dicas para solução de problemas e explicações sobre por que fazemos escolhas específicas de design. Ao final desta fase, você terá implementações MCP funcionando das quais poderá se orgulhar!

🚀 Fase de Crescimento: Conceitos Avançados e Aplicações do Mundo Real (Módulos 4-5)

Com o básico dominado, você está pronto para explorar recursos MCP mais sofisticados. Cobriremos estratégias práticas de implementação, técnicas de depuração e tópicos avançados como integração de IA multimodal.

Você também aprenderá como escalar suas implementações MCP para uso em produção e integrar com plataformas de nuvem como Azure. Esses módulos o preparam para construir soluções MCP capazes de lidar com demandas do mundo real.

🌟 Fase de Mestrado: Comunidade e Especialização (Módulos 6-11)

A fase final foca em ingressar na comunidade MCP e se especializar nas áreas que mais lhe interessam. Você aprenderá a contribuir para projetos MCP open-source, implementar padrões avançados de autenticação e construir soluções completas integradas a bancos de dados.

O Módulo 11 merece menção especial - é um percurso completo de aprendizado prático com 13 laboratórios que ensinam a construir servidores MCP prontos para produção com integração PostgreSQL. É como um projeto final que reúne tudo o que você aprendeu!

📚 Estrutura Completa do Currículo

Módulo	Tópico	Descrição	Link
Módulo 0-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	Conceitos Básicos Explicados	Exploração aprofundada dos conceitos essenciais 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 & 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	Microsoft Foundry Toolkit	Use o Microsoft Foundry Toolkit com MCP	Guia
3.8	Testes	Teste sua implementação de servidor MCP	Guia
3.9	Deploy	Faça deploy de servidores MCP em produção	Guia
3.10	Uso avançado de servidores	Use servidores avançados para funcionalidades avançadas e arquitetura melhorada	Guia
3.11	Autenticação simples	Capítulo mostrando 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	Inspetor MCP	Depure 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ódulo 4-5: Prático & Avançado
04	Implementação Prática	SDKs, depuração, testes, templates reutilizáveis de prompt	Leia mais
4.1	Paginação	Gerencie grandes conjuntos de resultados com paginação baseada em cursor	Guia
05	Tópicos Avançados no MCP	IA multimodal, escalabilidade, uso empresarial	Leia mais
5.1	Integração Azure	Integração MCP com Azure	Guia
5.2	Multimodalidade	Trabalhando com múltiplas modalidades	Guia
5.3	Demo OAuth2	Implemente autenticação OAuth2	Guia
5.4	Contextos Raiz	Entenda e implemente 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	Busca Web	Implemente capacidades de busca web	Guia
5.10	Streaming em Tempo Real	Construa funcionalidades 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 Foundry	Integre com Microsoft Foundry	Guia
5.14	Engenharia de Contexto	Técnicas para engenharia de contexto eficiente	Guia
5.15	Transporte Customizado MCP	Implementações de transporte customizado	Guia
5.16	Recursos do Protocolo	Notificações de progresso, cancelamento, templates de recursos	Guia
5.17	Raciocínio Multiagente Adversarial	Dois agentes discutem lados opostos usando ferramentas MCP compartilhadas, avaliados por agente juiz	Guia
Módulo 6-10: Comunidade & Melhores Práticas
06	Contribuições à Comunidade	Como contribuir para o ecossistema MCP	Guia
07	Lições da Adoção Inicial	Histórias de implementação do 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 Microsoft Foundry Toolkit	Lab
Módulo 11: Laboratório Prático de Servidor MCP
11	Integração de Banco de Dados no Servidor MCP	Percurso prático completo com 13 laboratórios para integração PostgreSQL	Labs
11.1	Introdução	Visão geral do MCP com integração de banco de dados e caso de uso em análise de varejo	Lab 00
11.2	Arquitetura Principal	Entendendo arquitetura de servidor MCP, camadas de banco de dados e padrões de segurança	Lab 01
11.3	Segurança & Multi-Tenancy	Segurança por nível de linha, autenticação e acesso multi-inquilino a dados	Lab 02
11.4	Configuração do Ambiente	Preparando ambiente de desenvolvimento, Docker, recursos Azure	Lab 03
11.5	Design de Banco de Dados	Configuração PostgreSQL, design de esquema varejo e dados de amostra	Lab 04
11.6	Implementação do Servidor MCP	Construindo o servidor FastMCP com integração de banco de dados	Lab 05
11.7	Desenvolvimento de Ferramentas	Criando ferramentas de consulta e introspecção de esquema de banco de dados	Lab 06
11.8	Busca Semântica	Implementando 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 de integração MCP no VS Code e uso de AI Chat	Lab 09
11.11	Estratégias de Deploy	Deploy via Docker, Azure Container Apps e considerações de escalabilidade	Lab 10
11.12	Monitoramento	Application Insights, logging, monitoramento de performance	Lab 11
11.13	Melhores Práticas	Otimização de performance, endurecimento de segurança e dicas para produção	Lab 12
Módulo 12: Ferramentas MCP
12.1	Ferramentas	Uso do MCP no app Copilot	Guia

💻 Projetos de Código de Exemplo

Uma das partes mais empolgantes de aprender MCP é ver suas habilidades em código evoluírem progressivamente. Projetamos nossos exemplos de código para começar simples e se tornar mais sofisticados à medida que seu entendimento se aprofunda. Aqui está como introduzimos os conceitos - com código fácil de entender, mas que demonstra princípios reais do MCP, você entenderá não apenas o que esse código faz, mas por que ele é estruturado dessa maneira e como se encaixa em aplicações MCP maiores.

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	Demo 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 MCP

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

🎯 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 REST e HTTP
(Opcional) Conhecimento prévio em conceitos de IA/ML
Participação nas discussões da nossa comunidade para suporte

📚 Guia de Estudos e Recursos

Este repositório inclui vários recursos para te ajudar a navegar e aprender de forma eficaz:

Guia de Estudos

Um Guia de Estudos abrangente está disponível para ajudar você a navegar por este 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 para quem aprende melhor visualmente e gosta de ver o panorama geral.

O guia inclui:

Mapa visual do currículo mostrando todos os tópicos abordados
Detalhamento de cada seção do repositório
Orientação sobre como usar os projetos de exemplo
Caminhos recomendados de aprendizado para diferentes níveis de habilidade
Recursos adicionais para complementar sua jornada de aprendizado

Registro de Alterações

Mantemos um Registro de Alterações detalhado que acompanha todas as atualizações significativas dos materiais do currículo, para que você possa se manter atualizado com as últimas melhorias e adições.

Inclusão de novos conteúdos
Mudanças estruturais
Melhorias de funcionalidades
Atualizações na documentação

🛠️ Como Usar Este Currículo de Forma Eficaz

Cada aula deste guia inclui:

Explicações claras dos conceitos MCP
Exemplos de código ao vivo em várias linguagens
Exercícios para construir aplicações reais MCP
Recursos extras para aprendizes avançados

Vamos Aprender MCP com C# - Série Tutorial

Vamos aprender sobre o Model Context Protocol (MCP), um framework inovador projetado para padronizar as interações entre modelos de IA e aplicações clientes. Nesta sessão introdutória 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

🎓 Sua Jornada MCP Começa

Parabéns! Você acaba de dar o primeiro passo em uma jornada empolgante que expandirá suas habilidades de programação e o conectará à vanguarda do desenvolvimento em IA.

O Que Você Já Conquistou

Ao ler esta introdução, você já começou a construir sua base de conhecimento MCP. Você entende o que é MCP, por que ele importa e como este currículo apoiará sua jornada de aprendizado. Isso é uma conquista significativa e o início da sua expertise nesta importante tecnologia.

A Aventura Pela Frente

Conforme você avança pelos módulos, lembre-se de que todo especialista já foi um iniciante. Os conceitos que possam parecer complexos agora se tornarão naturais conforme você pratica e os aplica. Cada pequeno passo constrói capacidades poderosas que servirão a você ao longo de sua carreira de desenvolvimento.

Sua Rede de Apoio

Você está entrando numa comunidade de aprendizes e especialistas apaixonados pelo MCP e ansiosos para ajudar outros a terem sucesso. Quer você esteja travado em um desafio de código ou animado para compartilhar uma descoberta, a comunidade está aqui para apoiar sua jornada.

Se você ficar preso ou tiver alguma dúvida sobre como construir apps de IA, junte-se a outros aprendizes e desenvolvedores experientes nas discussões sobre MCP. É uma comunidade acolhedora onde perguntas são bem-vindas e o conhecimento é compartilhado livremente.

Se tiver feedback sobre o produto ou encontrar erros durante a construção, visite:

Pronto para Começar?

Sua aventura MCP começa agora! Comece pelo Módulo 0 para entrar nas suas primeiras experiências práticas com MCP, ou explore os projetos de exemplo para ver o que você irá construir. Lembre-se - todo especialista começou exatamente onde você está agora e, com paciência e prática, você se surpreenderá com o que pode alcançar.

Bem-vindo ao mundo do desenvolvimento com o Model Context Protocol. Vamos construir algo incrível juntos!

🤝 Contribuindo para a Comunidade de Aprendizagem

Este currículo fica mais forte com contribuições de aprendizes como você! Seja corrigindo um erro de digitação, sugerindo uma explicação mais clara ou adicionando um novo exemplo, suas contribuições ajudam outros iniciantes a terem sucesso.

Agradecimentos ao Microsoft Valued Professional Shivam Goyal pelas contribuições de exemplos de código.

O processo de contribuição é projetado para ser acolhedor e de suporte. A maioria das contribuições exige um Acordo de Licença de Contribuidor (CLA), mas as ferramentas automatizadas irão guiá-lo suavemente pelo processo.

📜 Aprendizagem Open Source

Todo este currículo está disponível sob a licença MIT LICENSE, o que significa que você pode usar, modificar e compartilhar livremente. Isso apoia nossa missão de tornar o conhecimento MCP acessível a desenvolvedores em todo o mundo.

🤝 Diretrizes para Contribuição

Este projeto acolhe contribuições e sugestões. A maioria das contribuições requer que você concorde com um Acordo de Licença de Contribuidor (CLA) declarando que você tem o direito, e que de fato concede, os direitos para usar sua contribuição. Para detalhes, visite https://cla.opensource.microsoft.com.

Quando você enviar um pull request, um bot de 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 usam nosso CLA.

Este projeto adotou o Código de Conduta para Código Aberto da Microsoft. Para mais informações, veja o FAQ do Código de Conduta ou entre em contato pelo email opencode@microsoft.com para dúvidas ou comentários adicionais.

Pronto para iniciar sua jornada MCP? Comece pelo Módulo 00 - Introdução ao MCP e dê seus primeiros passos no mundo do desenvolvimento com Model Context Protocol!

🎒 Outros Cursos

Nossa equipe produz outros cursos! Confira:

LangChain

Azure / Edge / MCP / Agentes

Série de IA Generativa

Aprendizado Básico

Série Copilot

Aviso Legal: Este documento foi traduzido usando o serviço de tradução por IA Co-op Translator. Embora nos esforcemos pela precisão, por favor, 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 autorizada. Para informações críticas, recomenda-se tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.

37 KiB 原始文件 永久链接 Blame 文件历史