Curso 3: Desenvolvimento Agêntico | Encontro 5 de 6

MCP e Integrações

Conectando agentes ao mundo real

3 horasFoco Bloom: Criar

Instrutor: Rodrigo Pinto

Slide título. Esperar todos entrarem (10 min acomodação). Hoje é o penúltimo encontro -- tudo converge aqui. Energia alta.

Recap da Jornada

Onde estamos?

E1

Claude Code

CLI + CLAUDE.md

E2

Context Engineering

Skills + Memory

E3

Sub-Agentes

Agent Teams

E4

Frameworks

BMAD + Spec Kit

E5 — HOJE: MCP e Integrações

Conectando tudo ao mundo real

Recap rápido dos 4 encontros anteriores. "Até agora, nossos agentes viviam isolados no terminal. Hoje: conectamos eles ao mundo real." Tempo: min 10-15.

O problema: agentes isolados

Sem MCP

  • Agente só lê e escreve arquivos locais
  • Sem acesso a banco de dados
  • Sem acesso a ferramentas de produtividade
  • Sem acesso ao browser
  • Cada integração = código customizado

Com MCP

  • Agente conecta a Notion, Supabase, Slack...
  • Lê e escreve em banco de dados
  • Gerencia tarefas e documentos
  • Automatiza browser (Playwright)
  • Protocolo padrão = plug and play
Contraste visual forte. "Imaginem um funcionário brilhante, mas trancado numa sala sem telefone, sem email, sem acesso a nada. Isso é um agente sem MCP."

Objetivo do Encontro 5

Ao final de hoje, você vai saber:

1. O que é MCP e como ele se encaixa no Context Engineering

2. Configurar e usar MCP servers reais (Notion, Supabase, Playwright)

3. Combinar MCP com sub-agentes e frameworks para integrações end-to-end

3 objetivos = 3 Ciclos. Cada um com teoria + prática. Tempo: min 20-25.
Ciclo 1

O que é MCP?

Model Context Protocol

Ciclo 1: conceitual. O que é, por que existe, como funciona. Tempo: min 25-55.

MCP: Model Context Protocol

MCP é como uma porta USB para IA. Assim como USB padronizou a conexão entre computador e dispositivos, MCP padroniza a conexão entre agentes de IA e ferramentas externas.

Antes do MCP

Cada ferramenta = API diferente, autenticação diferente, formato diferente. N ferramentas = N integrações customizadas.

Com MCP

1 protocolo padrão. Qualquer MCP Server funciona com qualquer MCP Client. Plug and play.

Analogia USB é poderosa. "Antes do USB, cada impressora tinha um cabo diferente. MCP fez a mesma coisa para agentes de IA." Criado pela Anthropic, open source, adotado por toda a indústria.

Arquitetura

Cliente ↔ Servidor

MCP Client

Claude Code, Cursor, Windsurf, VS Code...

Quem CONSOME as ferramentas

↔

Protocolo padrão JSON-RPC

Comunicação bidirecional

MCP Server

Notion, Supabase, Playwright, filesystem...

Quem OFERECE as ferramentas

O agente (client) descobre automaticamente quais ferramentas o server oferece e como usá-las.

Diagrama mental: Claude Code no meio, MCP servers ao redor como satélites. "O agente nem precisa saber de antemão quais ferramentas existem -- ele descobre sozinho via MCP."

Conexão com E2

MCP no Context Engineering

Lembram dos 6 componentes do E2?

1. System Prompts

CLAUDE.md

2. Tools / MCP

HOJE!

3. RAG

Recuperação

4. Memory

Persistência

5. State

Estado atual

6. Structured Data

Dados

MCP preenche o componente Tools + pode servir como RAG (dados externos).

Voltar ao framework do E2. "MCP não é algo separado -- é uma peça fundamental do Context Engineering que vocês já aprenderam." Karpathy: preencher a context window com a informação certa.

Ecossistema de MCP Servers

Produtividade

  • Notion
  • Slack
  • Google Drive
  • Linear

Dados e Infra

  • Supabase
  • PostgreSQL
  • Filesystem
  • GitHub

Automação

  • Playwright (browser)
  • Puppeteer
  • Fetch (HTTP)
  • Context7 (docs)

E a lista cresce a cada semana. Qualquer pessoa pode criar um MCP server.

Panorama geral. "Hoje vamos focar em 3: Notion, Supabase e Playwright. São os mais úteis para o serviço público."

Configuração

Como configurar MCP no Claude Code

// Em .claude/settings.json ou via CLI
"mcpServers": {
  "notion": {
    "command": "npx",
    "args": ["-y", "@notionhq/notion-mcp-server"],
    "env": { "OPENAPI_MCP_HEADERS": "..." }
  },
  "supabase": {
    "command": "npx",
    "args": ["-y", "@supabase/mcp-server-supabase"]
  }
}

Pode ser no nível projeto (.claude/settings.json) ou global (~/.claude/settings.json).

Mostrar a estrutura real. "Não precisam decorar -- vamos configurar juntos na prática." O agente vê essas ferramentas automaticamente ao iniciar.

O que o agente vê

Ao iniciar o Claude Code com MCP configurado:

// O agente descobre automaticamente:

Tools from Notion MCP:
  - notion-search // buscar páginas
  - notion-create-pages // criar páginas
  - notion-update-page // atualizar páginas
  - notion-create-database // criar bancos

Tools from Supabase MCP:
  - execute_sql // rodar SQL
  - list_tables // listar tabelas
  - apply_migration // migrações

Você pede em linguagem natural. O agente escolhe a ferramenta certa.

"Você não precisa dizer 'use o tool notion-search'. Basta dizer 'busque minhas tarefas no Notion' e o agente sabe qual tool usar." Isso é o poder do protocolo.
Exercício 1 — 15 min

Configurar MCP Servers

1. Abram o terminal com Claude Code

2. Configurem pelo menos 2 MCP servers (Notion + Supabase OU Playwright)

3. Verifiquem que os tools aparecem ao iniciar o agente

4. Testem um comando simples: "Liste as ferramentas MCP disponíveis"

5. Façam uma operação básica com cada server configurado

Circular e ajudar. Problemas comuns: Node.js não instalado, tokens de API faltando. Ter tokens pré-configurados como backup. Tempo: 15 min.
Ciclo 2

MCP Servers na Prática

Notion, Supabase e Playwright

Ciclo 2: mão na massa com cada server. Tempo: min 55-85.

MCP Server 1

Notion: Produtividade Conectada

O que o agente pode fazer

  • Buscar páginas e databases
  • Criar páginas com conteúdo estruturado
  • Atualizar propriedades de páginas
  • Ler conteúdo de databases inteiras
  • Adicionar comentários

Casos de uso reais

  • Agente de gestão de tarefas
  • Gerar relatórios automáticos
  • Atualizar status de projetos
  • Criar documentação a partir de código
  • Consolidar dados de múltiplas fontes
Notion é a ferramenta de produtividade mais popular. "Imaginem: o agente lê as tarefas pendentes no Notion, prioriza com base em critérios, e atualiza os status automaticamente."

Demo ao vivo

Notion MCP em Ação

// Prompt natural para o agente:

"Busque no Notion todas as páginas do database
 'Tarefas do Setor'. Filtre as que estão com
 status 'Em andamento'. Crie um resumo em
 formato de tabela mostrando responsável,
 prazo e prioridade."

// O agente usa: notion-search, notion-fetch
// e formata o resultado automaticamente

O agente traduz linguagem natural em chamadas MCP. Você não precisa saber a API.

Demo ao vivo se possível. Senão, mostrar o prompt e o resultado esperado. "Notem: eu não disse 'use notion-search'. O agente decidiu sozinho qual tool usar."

MCP Server 2

Supabase: Banco de Dados Inteligente

Capacidades

  • Executar queries SQL diretamente
  • Listar tabelas e schemas
  • Aplicar migrações de banco
  • Gerenciar projetos e branches
  • Deploy de Edge Functions

Por que Supabase?

  • PostgreSQL completo (open source)
  • API REST automática
  • Autenticação integrada
  • Free tier generoso
  • MCP server oficial da Supabase
"Supabase é como ter um DBA virtual. O agente pode criar tabelas, inserir dados, fazer queries complexas -- tudo em linguagem natural."

Demo ao vivo

Supabase MCP em Ação

// Prompt 1: Explorar
"Liste todas as tabelas do meu projeto Supabase
 e descreva a estrutura de cada uma."

// Prompt 2: Consultar
"Quantos registros foram criados este mês na
 tabela 'atendimentos'? Agrupe por categoria."

// Prompt 3: Criar
"Crie uma tabela 'feedback' com campos: id,
 usuário, nota (1-5), comentário, created_at."

SQL gerado pelo agente, executado direto no banco. Resultado formatado em linguagem natural.

Mostrar os 3 níveis: explorar, consultar, criar. "O agente escreve SQL melhor que a maioria dos humanos -- e você só precisa descrever o que quer."

MCP Server 3

Playwright: Automação de Browser

Capacidades

  • Navegar em páginas web
  • Tirar screenshots
  • Preencher formulários
  • Clicar em elementos
  • Extrair dados de páginas
  • Testar aplicações web

Casos de uso

  • Web scraping inteligente
  • Validação visual de deploys
  • Testes automatizados end-to-end
  • Monitoramento de sites
  • Preenchimento automático de formulários
  • Captura de evidências (screenshots)
"Playwright é como dar olhos e mãos ao agente. Ele pode navegar, ver o que está na tela, interagir com elementos." Muito útil para QA e monitoramento.

Demo ao vivo

Playwright MCP em Ação

// Prompt 1: Navegar e capturar
"Navegue até meu site em produção, tire um
 screenshot e verifique se o título está correto."

// Prompt 2: Extrair dados
"Abra a página do Diário Oficial de hoje,
 encontre publicações do nosso órgão e
 liste os assuntos."

// Prompt 3: Testar
"Teste o formulário de contato: preencha
 com dados fictícios e verifique se aparece
 a mensagem de sucesso."
Demos visuais são impactantes -- mostrar o browser abrindo e sendo controlado pelo agente. "O agente VÊ a página como snapshot de acessibilidade, não como HTML cru."
Exercício 2 — 20 min

MCP Servers Hands-on

1. Escolham 2 MCP servers dos que configuraram

2. Com o Notion: criem uma página com título e conteúdo via agente

3. Com o Supabase: listem tabelas e façam uma query

4. Com o Playwright: naveguem a um site e tirem screenshot

5. Bônus: combinem 2 servers num único prompt!

Hands-on principal. Cada aluno deve ter pelo menos 2 servers funcionando. O bônus prepara para o Ciclo 3. Tempo: 20 min.

☕

Intervalo

20 minutos

Voltamos para a parte mais empolgante: integrações end-to-end — tudo junto.

Intervalo REAL de 20 minutos. Tempo: min 85-105. Garantir que todos saibam o horário de volta.
Ciclo 3

Construindo Integrações

MCP + Sub-Agentes + Frameworks

Ciclo 3: onde tudo se junta. MCP (E5) + Sub-Agentes (E3) + Frameworks (E4) + Context Engineering (E2) + Claude Code (E1). Tempo: min 105-135.

Convergência

E1 + E2 + E3 + E4 + E5 = Sistema Completo

E1

Claude Code — O motor que roda tudo

E2

Context Engineering — CLAUDE.md, skills, memory = instruções certas

E3

Sub-Agentes — Dividir trabalho, verificar qualidade

E4

Frameworks — Estrutura e padrões testados

E5

MCP — Conexão com o mundo real

"Cada encontro foi uma camada. Agora empilhamos todas." Fazer a analogia: E1=motor, E2=GPS, E3=equipe, E4=manual, E5=estradas.

Caso Real: Pipeline de Relatórios

1

Notion MCP — Lê tarefas concluídas no sprint do Notion

2

Sub-agente analista — Processa e categoriza os dados

3

Supabase MCP — Salva métricas consolidadas no banco

4

Playwright MCP — Abre dashboard e tira screenshot de validação

5

Sub-agente reviewer — Valida consistência dos dados

"Um pipeline completo: dado entra pelo Notion, e processado, salvo no banco, validado visualmente, e revisado. Tudo automático, tudo orquestrado por agentes."

Orquestração

Uma Skill que Orquestra Tudo

// SKILL.md para pipeline de relatório

## Instruções
1. Use Notion MCP para buscar tarefas concluídas
   no database "Sprint Atual" desta semana
2. Lance sub-agente para categorizar por área
3. Use Supabase MCP para inserir métricas na
   tabela 'relatorios_semanais'
4. Use Playwright para abrir o dashboard e
   tirar screenshot de confirmação
5. Lance sub-agente reviewer para validar
   consistência entre Notion e Supabase

Uma skill (E2) orquestra sub-agentes (E3) usando MCP (E5) num pipeline (E4).

"Vejam como tudo se conecta. A skill é a receita. Os sub-agentes são os cozinheiros. O MCP é o acesso aos ingredientes." Referenciar E2 (skills), E3 (sub-agentes), E4 (pipeline pattern).

Atenção

Segurança com MCP

Cuidados

  • MCP servers têm acesso REAL aos seus dados
  • Notion MCP pode ler TUDO no workspace
  • Supabase MCP pode executar QUALQUER SQL
  • Playwright pode navegar em qualquer site

Boas práticas

  • Use tokens com permissões MÍNIMAS
  • Crie integration keys separadas para MCP
  • Prefira read-only quando possível
  • Revise ANTES de aprovar operações destrutivas
  • Nunca commite tokens no repositório

Princípio de menor privilégio: dê ao agente SÓ o que ele precisa.

Tom sério. "MCP é poder real. Com poder real vem responsabilidade real. O agente pode deletar seu banco inteiro se você permitir." Sempre revisar antes de aprovar.

Patterns de Integração

Leitura + Análise

Notion → Agente analisa → Relatório

1 MCP + 1 agente

ETL Inteligente

Fonte A → Transforma → Destino B

2 MCPs + sub-agente

Pipeline Completo

Leitura → Processamento → Escrita → Validação

3+ MCPs + agent team

Comece simples (1 MCP) e vá adicionando complexidade conforme necessidade.

"Não precisa começar com pipeline completo. Comece lendo do Notion. Depois adicione escrita no Supabase. Depois validação com Playwright." Progressão gradual.
Exercício 3 — 20 min

Integração End-to-End

1. Escolham um dos cenários abaixo (ou criem o seu):

A. Leia tarefas do Notion → salve métricas no Supabase

B. Consulte dados no Supabase → crie página resumo no Notion

C. Navegue com Playwright → extraia dados → salve no Supabase

2. Usem sub-agentes (E3) para dividir o trabalho se possível

3. Documentem o fluxo como uma skill (E2) reutilizável

Exercício mais ambicioso do encontro. Circular e ajudar. Aceitar diferentes níveis de complexidade. O importante é combinar pelo menos 2 MCPs. Tempo: 20 min.

Debrief — Exercício 3

O que descobriram?

1

Qual foi o fluxo que criaram?

2

Qual parte foi mais difícil?

3

Onde usariam isso no trabalho real?

A complexidade está na orquestração, não nos tools individuais.

Pedir 2-3 alunos/grupos para compartilhar. Celebrar soluções criativas. Reforçar: "A parte difícil não é o MCP em si, é pensar o fluxo certo."

O que se torna possível

Padrões Avançados com MCP

Prompts que antes eram complexos se tornam triviais quando agentes têm acesso MCP.

#17 Análise de Dados Avançada — MCP + Supabase: o agente consulta, analisa e gera insights direto do banco de dados

#19 Sistemas de Templates — MCP + filesystem: o agente cria, organiza e versiona templates automaticamente

#21 Integração Master — MCP + multiplos servers = sistema completo end-to-end (Notion + Supabase + Playwright)

Sem MCP: prompts enormes com dados colados manualmente.
Com MCP: o agente busca, processa e age autonomamente.

3 min. Esses padrões são do material AI Master prompts 16-21. O ponto-chave: MCP transforma prompts complexos em workflows simples. É a diferença entre "copiar dados no prompt" e "o agente vai buscar os dados sozinho". Conectar com o Projeto Final: esses padrões são exatamente o que eles vão construir.
Atividade Final — 15 min

Recap em Duplas

1. Formem duplas

2. Expliquem ao colega: o que é MCP e por que é importante

3. Descrevam uma integração que teria impacto REAL no setor de vocês

4. Discutam: que integração teria mais impacto no seu trabalho?

15 min. Circular e ouvir. Essa pergunta prepara para o Projeto Final do E6. Nos últimos 5 min, pedir 2-3 duplas para compartilhar.

3 Perguntas para as Duplas

1

Explique MCP como se fosse para alguém que não sabe nada de tecnologia.

2

Qual MCP server te surpreendeu mais hoje? Por que?

3

Descreva um pipeline de 3 etapas usando MCP que resolveria um problema real do seu setor.

Projetar as perguntas. A pergunta 3 é a mais importante -- conecta com o Projeto Final.

Fechamento

O que levar do Encontro 5

MCP é o "USB da IA" — protocolo padrão para conectar agentes a ferramentas

Notion, Supabase, Playwright — 3 servers que cobrem produtividade, dados e automação

MCP + Sub-Agentes + Frameworks = integrações end-to-end poderosas

Segurança: princípio de menor privilégio SEMPRE

4 takeaways. Enfatizar que tudo isso é preparação para o Projeto Final.

Próximo Encontro

Encontro 6:
Projeto Final

Requisitos do Projeto Final

1. CLAUDE.md estruturado (E1 + E2)

2. Pelo menos 1 skill customizada (E2)

3. Agent team com verificação (E3)

4. Framework ou pattern definido (E4)

5. Pelo menos 1 integração MCP (E5)

Tarefa: Venham com uma IDEIA de projeto que resolva um problema real do setor de vocês. Na próxima aula, vamos construir!

Briefing do Projeto Final. "Vocês têm todas as peças. E6 é para juntar tudo num sistema real." Dar exemplos de projetos possíveis: assistente legislativo, monitor de imprensa, gerador de relatórios. Tempo: min 155.

Ideias para Inspirar

Assistente Legislativo

Analisa projetos de lei, compara com legislação existente, gera pareceres (Notion + Supabase)

Monitor de Imprensa

Scrapa notícias (Playwright), classifica, e envia resumo diário (Supabase + Notion)

Gerador de Relatórios

Coleta dados (Supabase), analisa (agente), formata e publica (Notion)

Pipeline de Documentos

Recebe doc, classifica, extrai dados, preenche formulário, notifica responsável

Inspiracao. "Não precisam escolher uma dessas. Pensem no que seria mais útil para VOCÊS." Incentivar projetos reais, não acadêmicos.

Até o Projeto Final!

Curso 3: Desenvolvimento Agêntico

Rodrigo Pinto

Encontro 6: tragam suas ideias!

Encerrar com energia. "Vocês já têm TODAS as ferramentas. O próximo encontro é para construir algo real. Venham preparados!" Lembrar da tarefa: trazer ideia de projeto.
1 / 36