microsoft--mcp-for-beginners
wehub-resource-sync
227 行
11 KiB
Markdown
227 行
11 KiB
Markdown
# Simplificando Fluxos de Trabalho de IA: Construindo um Servidor MCP com Microsoft Foundry Toolkit
|
|
|
|
[](https://spec.modelcontextprotocol.io/specification/2025-11-25/)
|
|
[](https://python.org)
|
|
[](https://code.visualstudio.com/)
|
|
|
|
|
|
|
|
## 🎯 Visão Geral
|
|
|
|
[](https://youtu.be/r34Csn3rkeQ)
|
|
|
|
_(Clique na imagem acima para assistir ao vídeo desta aula)_
|
|
|
|
Bem-vindo ao **Workshop do Model Context Protocol (MCP)**! Este workshop prático abrangente combina duas tecnologias inovadoras para revolucionar o desenvolvimento de aplicações de IA:
|
|
|
|
- **🔗 Model Context Protocol (MCP)**: Um padrão aberto para integração fluida de ferramentas de IA
|
|
- **🛠️ Microsoft Foundry Toolkit Extension para VS Code**: A poderosa extensão de desenvolvimento de IA da Microsoft
|
|
|
|
### 🎓 O Que Você Vai Aprender
|
|
|
|
Ao final deste workshop, você dominará a arte de construir aplicações inteligentes que conectam modelos de IA a ferramentas e serviços do mundo real. Desde testes automatizados até integrações personalizadas de APIs, você adquirirá habilidades práticas para resolver desafios complexos de negócios.
|
|
|
|
## 🏗️ Pilha Tecnológica
|
|
|
|
### 🔌 Model Context Protocol (MCP)
|
|
|
|
MCP é o **"USB-C para IA"** – um padrão universal que conecta modelos de IA a ferramentas e fontes de dados externas.
|
|
|
|
**✨ Principais Características:**
|
|
|
|
- 🔄 **Integração Padronizada**: Interface universal para conexões entre IA e ferramentas
|
|
- 🏛️ **Arquitetura Flexível**: Servidores locais e remotos via transporte stdio/SSE
|
|
- 🧰 **Ecossistema Rico**: Ferramentas, prompts e recursos reunidos em um só protocolo
|
|
- 🔒 **Pronto para Empresas**: Segurança e confiabilidade incorporadas
|
|
|
|
**🎯 Por Que o MCP é Importante:**
|
|
Assim como o USB-C eliminou o caos dos cabos, o MCP elimina a complexidade das integrações de IA. Um protocolo, infinitas possibilidades.
|
|
|
|
### 🤖 Microsoft Foundry Toolkit Extension para VS Code
|
|
|
|
A principal extensão de desenvolvimento de IA da Microsoft que transforma o VS Code em uma central poderosa de IA.
|
|
|
|
**🚀 Capacidades Principais:**
|
|
|
|
- 📦 **Catálogo de Modelos**: Acesso a modelos do Azure AI, GitHub, Hugging Face, Ollama
|
|
- ⚡ **Inferência Local**: Execução otimizada ONNX para CPU/GPU/NPU
|
|
- 🏗️ **Construtor de Agentes**: Desenvolvimento visual de agentes de IA com integração MCP
|
|
- 🎭 **Multimodal**: Suporte a texto, visão e saída estruturada
|
|
|
|
**💡 Benefícios para o Desenvolvimento:**
|
|
|
|
- Implantação de modelos sem configuração
|
|
- Engenharia visual de prompts
|
|
- Ambiente de testes em tempo real
|
|
- Integração perfeita com servidores MCP
|
|
|
|
## 📚 Jornada de Aprendizagem
|
|
|
|
### [🚀 Módulo 1: Fundamentos do Microsoft Foundry Toolkit](./lab1/README.md)
|
|
|
|
**Duração**: 15 minutos
|
|
|
|
- 🛠️ Instalar e configurar o Microsoft Foundry Toolkit para VS Code
|
|
- 🗂️ Explorar o Catálogo de Modelos (mais de 100 modelos do GitHub, ONNX, OpenAI, Anthropic, Google)
|
|
- 🎮 Dominar o Playground Interativo para testes em tempo real dos modelos
|
|
- 🤖 Construir seu primeiro agente de IA com o Construtor de Agentes
|
|
- 📊 Avaliar o desempenho dos modelos com métricas integradas (F1, relevância, similaridade, coerência)
|
|
- ⚡ Aprender processamento em lotes e suporte multimodal
|
|
|
|
**🎯 Resultado do Aprendizado**: Criar um agente de IA funcional com compreensão abrangente das capacidades do Microsoft Foundry Toolkit
|
|
|
|
### [🌐 Módulo 2: MCP com Fundamentos do Microsoft Foundry Toolkit](./lab2/README.md)
|
|
|
|
**Duração**: 20 minutos
|
|
|
|
- 🧠 Dominar a arquitetura e conceitos do Model Context Protocol (MCP)
|
|
- 🌐 Explorar o ecossistema de servidores MCP da Microsoft
|
|
- 🤖 Construir um agente de automação de navegador usando o servidor Playwright MCP
|
|
- 🔧 Integrar servidores MCP com o Construtor de Agentes do Microsoft Foundry Toolkit
|
|
- 📊 Configurar e testar ferramentas MCP dentro dos seus agentes
|
|
- 🚀 Exportar e implantar agentes potenciados por MCP para uso em produção
|
|
|
|
**🎯 Resultado do Aprendizado**: Implantar um agente de IA turboalimentado com ferramentas externas via MCP
|
|
|
|
### [🔧 Módulo 3: Desenvolvimento Avançado MCP com Microsoft Foundry Toolkit](./lab3/README.md)
|
|
|
|
**Duração**: 20 minutos
|
|
|
|
- 💻 Criar servidores MCP personalizados usando Microsoft Foundry Toolkit
|
|
- 🐍 Configurar e usar o SDK Python MCP mais recente (v1.9.3)
|
|
- 🔍 Configurar e usar o MCP Inspector para depuração
|
|
- 🛠️ Construir um Servidor MCP de Clima com fluxos profissionais de depuração
|
|
- 🧪 Depurar servidores MCP em ambientes Agent Builder e Inspector
|
|
|
|
**🎯 Resultado do Aprendizado**: Desenvolver e depurar servidores MCP personalizados com ferramentas modernas
|
|
|
|
### [🐙 Módulo 4: Desenvolvimento Prático MCP – Servidor Clone do GitHub Personalizado](./lab4/README.md)
|
|
|
|
**Duração**: 30 minutos
|
|
|
|
- 🏗️ Construir um Servidor Clone MCP real para fluxos de trabalho de desenvolvimento
|
|
- 🔄 Implementar clonagem inteligente de repositórios com validação e tratamento de erros
|
|
- 📁 Criar gerenciamento inteligente de diretórios e integração com VS Code
|
|
- 🤖 Usar o Modo Agente GitHub Copilot com ferramentas MCP personalizadas
|
|
- 🛡️ Aplicar confiabilidade pronta para produção e compatibilidade multiplataforma
|
|
|
|
**🎯 Resultado do Aprendizado**: Implantar um servidor MCP pronto para produção que simplifica fluxos reais de desenvolvimento
|
|
|
|
## 💡 Aplicações e Impacto no Mundo Real
|
|
|
|
### 🏢 Casos de Uso Empresariais
|
|
|
|
#### 🔄 Automação DevOps
|
|
|
|
Transforme seu fluxo de trabalho de desenvolvimento com automação inteligente:
|
|
|
|
- **Gerenciamento Inteligente de Repositórios**: Revisão e decisão de merge baseadas em IA
|
|
- **CI/CD Inteligente**: Otimização automatizada de pipelines com base em mudanças no código
|
|
- **Triage de Issues**: Classificação e atribuição automática de bugs
|
|
|
|
#### 🧪 Revolução em Garantia de Qualidade
|
|
|
|
Eleve os testes com automação movida a IA:
|
|
|
|
- **Geração Inteligente de Testes**: Crie suítes de teste completas automaticamente
|
|
- **Teste de Regressão Visual**: Detecção de mudanças de interface controlada por IA
|
|
- **Monitoramento de Desempenho**: Identificação e resolução proativas de problemas
|
|
|
|
#### 📊 Inteligência em Pipelines de Dados
|
|
|
|
Construa fluxos de processamento de dados mais inteligentes:
|
|
|
|
- **Processos ETL Adaptativos**: Transformações de dados auto-otimizáveis
|
|
- **Detecção de Anomalias**: Monitoramento em tempo real da qualidade dos dados
|
|
- **Roteamento Inteligente**: Gerenciamento inteligente do fluxo de dados
|
|
|
|
#### 🎧 Melhoria da Experiência do Cliente
|
|
|
|
Crie interações extraordinárias com clientes:
|
|
|
|
- **Suporte Contextualizado**: Agentes de IA com acesso ao histórico do cliente
|
|
- **Resolução Proativa de Problemas**: Atendimento preditivo ao cliente
|
|
- **Integração Multicanal**: Experiência unificada de IA através das plataformas
|
|
|
|
## 🛠️ Pré-requisitos e Configuração
|
|
|
|
### 💻 Requisitos do Sistema
|
|
|
|
| Componente | Requisito | Notas |
|
|
|-----------|-------------|-------|
|
|
| **Sistema Operacional** | Windows 10+, macOS 10.15+, Linux | Qualquer sistema moderno |
|
|
| **Visual Studio Code** | Última versão estável | Necessário para Microsoft Foundry Toolkit |
|
|
| **Node.js** | v18.0+ e npm | Para desenvolvimento de servidores MCP |
|
|
| **Python** | 3.10+ | Opcional para servidores MCP em Python |
|
|
| **Memória** | Mínimo 8GB RAM | 16GB recomendado para modelos locais |
|
|
|
|
### 🔧 Ambiente de Desenvolvimento
|
|
|
|
#### Extensões Recomendadas para VS Code
|
|
|
|
- **Microsoft Foundry Toolkit** (ms-windows-ai-studio.windows-ai-studio)
|
|
- **Python** (ms-python.python)
|
|
- **Python Debugger** (ms-python.debugpy)
|
|
- **GitHub Copilot** (GitHub.copilot) - Opcional, mas útil
|
|
|
|
#### Ferramentas Opcionais
|
|
|
|
- **uv**: Gerenciador moderno de pacotes Python
|
|
- **MCP Inspector**: Ferramenta visual de depuração para servidores MCP
|
|
- **Playwright**: Para exemplos de automação web
|
|
|
|
## 🎖️ Resultados do Aprendizado & Caminho para Certificação
|
|
|
|
### 🏆 Checklist de Domínio de Habilidades
|
|
|
|
Ao concluir este workshop, você alcançará domínio em:
|
|
|
|
#### 🎯 Competências Principais
|
|
|
|
- [ ] **Mestrado no Protocolo MCP**: Compreensão profunda da arquitetura e padrões de implementação
|
|
- [ ] **Proficiência no Microsoft Foundry Toolkit**: Uso avançado do Microsoft Foundry Toolkit para desenvolvimento rápido
|
|
- [ ] **Desenvolvimento de Servidores Customizados**: Construir, implantar e manter servidores MCP em produção
|
|
- [ ] **Excelência em Integração de Ferramentas**: Conectar IA perfeitamente a fluxos de trabalho existentes
|
|
- [ ] **Aplicação para Resolução de Problemas**: Aplicar habilidades para desafios reais de negócios
|
|
|
|
#### 🔧 Habilidades Técnicas
|
|
|
|
- [ ] Configurar e usar Microsoft Foundry Toolkit no VS Code
|
|
- [ ] Projetar e implementar servidores MCP customizados
|
|
- [ ] Integrar Modelos GitHub com arquitetura MCP
|
|
- [ ] Construir fluxos de teste automatizados com Playwright
|
|
- [ ] Implantar agentes de IA para uso em produção
|
|
- [ ] Depurar e otimizar o desempenho do servidor MCP
|
|
|
|
#### 🚀 Capacidades Avançadas
|
|
|
|
- [ ] Projetar integrações de IA em escala empresarial
|
|
- [ ] Implementar melhores práticas de segurança para aplicações de IA
|
|
- [ ] Projetar arquiteturas escaláveis de servidores MCP
|
|
- [ ] Criar cadeias de ferramentas customizadas para domínios específicos
|
|
- [ ] Orientar outros no desenvolvimento nativo para IA
|
|
|
|
## 📖 Recursos Adicionais
|
|
|
|
- [Especificação MCP (2025-11-25)](https://spec.modelcontextprotocol.io/specification/2025-11-25/)
|
|
- [Repositório Microsoft Foundry Toolkit no GitHub](https://github.com/microsoft/vscode-ai-toolkit)
|
|
- [Coleção de Servidores MCP Exemplares](https://github.com/modelcontextprotocol/servers)
|
|
- [Guia de Melhores Práticas](https://modelcontextprotocol.io/docs/best-practices)
|
|
- [OWASP MCP Top 10](https://microsoft.github.io/mcp-azure-security-guide/mcp/) - Melhores práticas de segurança
|
|
|
|
---
|
|
|
|
**🚀 Pronto para revolucionar seu fluxo de desenvolvimento de IA?**
|
|
|
|
Vamos construir juntos o futuro das aplicações inteligentes com MCP e Microsoft Foundry Toolkit!
|
|
|
|
## O Que Vem a Seguir
|
|
|
|
Continue para: [Módulo 11: Laboratórios Práticos de Servidor MCP](../11-MCPServerHandsOnLabs/README.md)
|
|
|
|
---
|
|
|
|
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
|
|
**Aviso Legal**:
|
|
Este documento foi traduzido usando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/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.
|
|
<!-- CO-OP TRANSLATOR DISCLAIMER END --> |