# 3.1 — O que é MCP / m03-a01

**Objetivo:** Conectar um serviço do catálogo e demonstrar leitura com origem e permissão verificadas.

**Preparação:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Ensaio:** Teste autenticado e captura da página Notion ainda precisam do ambiente de gravação.

### m03-a01-b01 — Quando a tarefa depende de um sistema

Slide m03-a01-s01

Até aqui, trabalhamos com informações que nós entregamos à IA: um arquivo, um texto, uma pasta de exercício. A skill do módulo anterior, por exemplo, recebia o material de entrada que estava no nosso próprio computador.

Mas muitos processos dependem de dados que estão em outro lugar: uma agenda, uma pasta compartilhada, um registro numa ferramenta de trabalho. Se a IA não consegue chegar a esse lugar, alguém precisa copiar o conteúdo e colar na conversa, toda vez.

Para a IA chegar a esses dados, entram os conectores. E por trás de muitos conectores existe o MCP, sigla de Model Context Protocol, em português, protocolo de contexto para modelos. Um protocolo é um combinado: uma forma padronizada de duas partes conversarem. O MCP é um padrão para um sistema, como o Notion, disponibilizar recursos e ferramentas que um agente pode usar. Agente, aqui, é a IA trabalhando por etapas e usando ferramentas para cumprir uma tarefa. Você não precisa decorar a sigla; precisa entender o que a conexão permite fazer.

Uma comparação ajuda: o USB-C é um encaixe padronizado, e o MCP busca algo parecido. A ideia é reduzir a necessidade de criar uma ligação diferente para cada combinação de sistema e agente. Mesmo com o padrão, continuam valendo três coisas: a autenticação, que é provar quem você é para o serviço; as permissões, que dizem o que essa conta pode fazer; e os limites do próprio serviço.

### m03-a01-b04 — MCP, conector e skill sem trocar as funções

Slide m03-a01-s04

No módulo anterior você deu ao agente um procedimento, a skill. Agora vamos dar acesso à informação de que o procedimento precisa. Algumas pessoas comparam o modelo a um cérebro e a ferramenta a mãos. A comparação é útil para lembrar a sequência, mas com um cuidado: a skill não é o modelo que raciocina. A skill é a orientação, o passo a passo escrito. A ferramenta faz uma operação, e o agente decide como usá-la dentro da tarefa.

Vamos ver como o MCP organiza isso, só no que importa para você. Ele é um padrão aberto, ou seja, publicado para qualquer sistema poder adotar. Um servidor, que é o programa ou serviço que guarda as operações, oferece essas operações com nomes, entradas e respostas. Pense numa operação chamada buscar página: ela recebe um texto de busca e devolve o resultado. Um cliente compatível, que é o aplicativo onde você conversa com a IA, descobre essas operações e pode chamá-las. A comparação com o USB-C explica a ideia de um encaixe comum. Ela não é a promessa de que qualquer ferramenta funciona em qualquer lugar sem preparação.

Conector é o nome que a interface pode dar à integração com um serviço, aquilo que aparece na lista e que você liga. Ele pode usar MCP e também pode depender de uma autorização própria.

Talvez você ouça a frase “MCP conecta, skill executa”. Ela resume o mapa, mas, com mais precisão: a skill descreve como trabalhar, e o agente usa as operações conectadas. No diagrama, o caminho vai do cliente à ferramenta e da ferramenta à fonte, com a skill e a aprovação separadas desse caminho.

Pense num resumo de reunião. A conexão busca a fonte. A skill orienta o que extrair dela. A aprovação define o que pode acontecer depois, como salvar o resumo em algum lugar ou enviá-lo a alguém. Vamos observar essas três coisas separadas no mesmo exemplo, que será uma página do Notion.

### m03-a01-b02 — Conectar e fazer uma consulta

Slide m03-a01-s02

Vamos começar pelos conectores que o próprio ambiente oferece, e o nosso exemplo é o Notion, com uma página de exercício. Abra a lista de conectores, encontre o Notion e confira quais operações ele disponibiliza. Operação é cada ação que o conector sabe fazer, como buscar, ler ou criar uma página. Se você usa outro serviço, o caminho é o mesmo. Os nomes dos botões podem variar conforme o plano e a versão; siga os nomes que aparecerem na sua tela.

Antes de autorizar, veja qual conta será conectada e qual acesso está sendo pedido. Quem tem mais de uma conta, uma pessoal e uma da empresa, por exemplo, pode conectar a errada sem perceber.

Depois de conectar, faça uma consulta de leitura à página de exercício. Leitura quer dizer que a IA apenas consulta, sem mudar nada. Um pedido possível é: "Busque no Notion a página do exercício e me mostre o título e os principais tópicos." Use o título que a página tiver no seu Notion. O pedido precisa dizer duas coisas: o que buscar e que a operação é só de leitura.

Quando a resposta chegar, compare com a página aberta no próprio Notion. Essa comparação é importante. Ter o conector listado não prova que a conta tem acesso à página certa. A consulta pode não encontrar nada, trazer outro documento ou mostrar só parte dos dados. Se isso acontecer, confira conta, permissão e identificação da entrada antes de alterar a skill, porque o problema costuma estar no acesso, e não no procedimento.

Para criar ou alterar informações, diga também o destino e o que está autorizado. Excluir dados ou executar uma ação de impacto pede uma decisão explícita. A conexão não é uma autorização geral para qualquer operação.

### m03-a01-b05 — Conector pronto: autorização e primeira leitura

Slide m03-a01-s05

Agora vamos percorrer a conexão do começo ao fim, parando em cada decisão. A página que vamos usar é fictícia, criada só para o exercício, sem nenhum dado real.

Abra a área de conectores do Claude e procure o serviço escolhido para o exercício. Vamos usar o Notion. Leia a descrição e identifique se aquela integração é mantida pelo próprio serviço, pela Anthropic ou por outro fornecedor. Estar no catálogo não torna todas as integrações iguais, e saber quem mantém ajuda você a decidir quanto confiar.

Siga o login oficial, confira a conta e autorize somente a página ou o espaço necessário, quando o serviço permitir essa escolha. Limitar faz diferença porque o que você autoriza agora é o que o agente poderá enxergar depois. Volte à sessão e confira quais operações ficaram disponíveis. Agora peça a leitura da página de exercício, pelo título completo ou pelo identificador que o conector mostrar, e abra a mesma página no Notion para comparar.

O teste tem três resultados possíveis, e vale reconhecer cada um. Se encontrou a página correta, compare título e conteúdo. Se não encontrou, confira conta, escopo e identificador. Se trouxe outra página parecida, refine a identificação; não aceite pelo nome aproximado. Isso importa porque uma informação pública ou um texto plausível não prova acesso à sua página: a IA pode escrever uma resposta com cara de certa sem ter lido o que você queria.

Depois registre a origem da informação junto do resumo, ou seja, de qual página ele veio. No registro de testes, anote o identificador da página e o resultado. Senhas, tokens e chaves de acesso nunca vão para a conversa nem para o registro; a autenticação acontece no fluxo oficial de login. Por isso, o que acompanhamos aqui não é a tela de login, e sim o resultado: a conta certa recebeu o acesso certo, e uma operação retornou a fonte esperada.

### m03-a01-b06 — Permissão de leitura também precisa de critério

Slide m03-a01-s06

Uma regra útil para o exercício é começar com leitura e reservar gravação e exclusão para decisões explícitas. Gravação é criar ou alterar informação; exclusão é apagar. Mas leitura liberada não significa acesso irrestrito a toda a empresa. Uma pasta pode conter contratos, dados pessoais ou informações que não são necessárias ao processo, e ler também expõe esse conteúdo.

Por isso, defina o menor conjunto de recursos que resolve a tarefa. Se o trabalho só precisa da transcrição de teste, não há motivo para abrir todas as reuniões. Se precisa salvar uma proposta, escolha a pasta de destino e deixe claro o que pode ser criado. Uma autorização anterior para ler não autoriza alterar ou apagar. O mesmo vale para enviar algo a alguém: é uma ação com efeito fora da conversa, e pede a sua aprovação antes.

Na atividade, preencha o contrato de conexão, o arquivo contrato-conexao.md, com quatro campos: serviço, recurso, operação e aprovação. Um exemplo preenchido: serviço, Notion; recurso, a página de exercício; operação, somente leitura; aprovação, nenhuma gravação ou exclusão sem eu pedir. Junte a isso o critério de conferência: o título e os tópicos que a IA mostrar precisam bater com a página aberta. Depois execute a leitura autorizada e compare com a origem.

Registre também como revogar a conexão, isto é, como encerrar ou limitar o acesso. Procure essa opção na área de conectores; o caminho exato pode mudar conforme o plano e a versão. Basta localizar e entender o que ela faz, sem alterar nenhum dado. Isso faz parte de saber administrar o acesso, mesmo que você não precise revogá-lo a cada exercício.

### m03-a01-b03 — O acesso e o procedimento se complementam

Slide m03-a01-s03

Agora fica mais fácil separar as funções. O conector dá acesso às operações do serviço. A skill orienta quando usá-las, quais informações procurar e como organizar a entrega. A consulta que você fez no Notion pode ser relacionada aos critérios da skill de resumo, sem montar outro fluxo: o conector trouxe o conteúdo, e os critérios da skill dizem o que dele entra no resumo e como apresentá-lo.

Um detalhe sobre onde isso funciona. Um conector pode rodar em um serviço remoto, na internet, ou depender de um processo local, um programa que precisa estar rodando no seu computador. Isso muda onde ele pode ser usado: uma sessão na nuvem não recebe automaticamente os recursos instalados no seu computador. Ao escolher um conector, vale perguntar se ele depende da sua máquina.

Seu exercício é fazer uma consulta pequena de leitura no Notion e conferir a resposta na origem. Na conferência, olhe a conta conectada, a permissão, a identificação da entrada e se o retorno bate com o conteúdo da página. Você terá terminado quando conseguir dizer de onde veio a informação, com qual conta e com qual permissão, e confirmar que nada foi criado, alterado ou apagado. Quando essa base funciona, podemos explorar conectores que não estavam no catálogo inicial, mantendo a mesma disciplina: origem identificada, permissão adequada, chamada pequena e resultado conferido.

# 3.1 — O que é MCP

ID m03-a01. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Dependências e ensaio:** Teste autenticado e captura da página Notion ainda precisam do ambiente de gravação.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m03-a01-b01 | m03-a01-s01 / p. 1 | Mostrar uma skill com entrada local e depois a necessidade de buscar dados em um serviço externo. | Necessidade de acesso externo é diferenciada de instrução local. |
| m03-a01-b04 | m03-a01-s04 / p. 2 | Exibir fluxo cliente → ferramenta → fonte, com skill e aprovação separadas. | Aluno distingue protocolo, integração apresentada no cliente e procedimento. |
| m03-a01-b02 | m03-a01-s02 / p. 3 | Abrir conectores disponíveis, conectar um serviço de exercício e fazer uma consulta de leitura. O exemplo preferencial é Notion, como na Fase 2; confirmar acesso no ensaio. | Conector consulta o documento correto e a resposta é comparada com a origem. |
| m03-a01-b05 | m03-a01-s05 / p. 4 | Conectar Notion pela interface oficial e ler página fictícia por ID. | Leitura real conferida na origem; conta e recurso inequivocamente identificados. |
| m03-a01-b06 | m03-a01-s06 / p. 5 | Preencher um contrato mínimo de acesso e localizar revogação do conector. | Pedido limita escopo e resultado; aluno explica como encerrar o acesso. |
| m03-a01-b03 | m03-a01-s03 / p. 6 | Relacionar a consulta feita com os critérios da skill de resumo, sem construir outro fluxo. | Origem e conteúdo coincidem; escopo limitado; gravação/exclusão têm decisão distinta. |

## m03-a01-b01 — Quando a tarefa depende de um sistema

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Mostrar uma skill com entrada local e depois a necessidade de buscar dados em um serviço externo. | slides/m03-a01.pptx e slides/m03-a01.pdf, página 1, ID m03-a01-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a01-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a01-b01. Sem trilha prevista. |

**Estado inicial:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Entrada/material:** apoio/contrato-conexao.md, apoio/conversa-demo.txt, apoio/registro-testes.md

**Passos de captura:**
1. Mostrar uma skill com entrada local e depois a necessidade de buscar dados em um serviço externo.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Necessidade de acesso externo é diferenciada de instrução local.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a01-b01; SHA-256 3655bec4da46b58d5e3b1e64b44cd5e5b8c92f85922a4728d16872ee071a9d9e.

**Função visual:** Mostrar uma skill com entrada local e depois a necessidade de buscar dados em um serviço externo.


## m03-a01-b04 — MCP, conector e skill sem trocar as funções

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Exibir fluxo cliente → ferramenta → fonte, com skill e aprovação separadas. | slides/m03-a01.pptx e slides/m03-a01.pdf, página 2, ID m03-a01-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a01-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a01-b04. Sem trilha prevista. |

**Estado inicial:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Entrada/material:** apoio/contrato-conexao.md, apoio/conversa-demo.txt, apoio/registro-testes.md

**Passos de captura:**
1. Apontar cada peça no diagrama.
2. Relacionar uma consulta de documento ao procedimento de resumo.

**Saída e conferência:** Aluno distingue protocolo, integração apresentada no cliente e procedimento.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a01-b04; SHA-256 dd5d801a3b213f810b20ce1e334615582a3f60036394fe16c59642ae85f75eb9.

**Função visual:** Exibir fluxo cliente → ferramenta → fonte, com skill e aprovação separadas.


## m03-a01-b02 — Conectar e fazer uma consulta

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir conectores disponíveis, conectar um serviço de exercício e fazer uma consulta de leitura. O exemplo preferencial é Notion, como na Fase 2; confirmar acesso no ensaio. | slides/m03-a01.pptx e slides/m03-a01.pdf, página 3, ID m03-a01-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a01-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a01-b02. Sem trilha prevista. |

**Estado inicial:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Entrada/material:** apoio/contrato-conexao.md, apoio/conversa-demo.txt, apoio/registro-testes.md

**Passos de captura:**
1. Abrir conectores disponíveis, conectar um serviço de exercício e fazer uma consulta de leitura. O exemplo preferencial é Notion, como na Fase 2; confirmar acesso no ensaio.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Conector consulta o documento correto e a resposta é comparada com a origem.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a01-b02; SHA-256 3b92ee87aa1bad069a9b16ec8dd47322eeb1ebbcf7441b4d46306eb3031019ba.

**Função visual:** Abrir conectores disponíveis, conectar um serviço de exercício e fazer uma consulta de leitura. O exemplo preferencial é Notion, como na Fase 2; confirmar acesso no ensaio.


## m03-a01-b05 — Conector pronto: autorização e primeira leitura

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Conectar Notion pela interface oficial e ler página fictícia por ID. | slides/m03-a01.pptx e slides/m03-a01.pdf, página 4, ID m03-a01-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a01-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a01-b05. Sem trilha prevista. |

**Estado inicial:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Entrada/material:** apoio/contrato-conexao.md, apoio/conversa-demo.txt, apoio/registro-testes.md

**Passos de captura:**
1. Criar página de exercício sem dados reais.
2. Conferir mantenedor, conta e escopo.
3. Consultar a página e comparar com o Notion aberto.
4. Registrar ID e resultado, sem credenciais.

**Saída e conferência:** Leitura real conferida na origem; conta e recurso inequivocamente identificados.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a01-b05; SHA-256 693a0d7e9165dc4e55f642c6144881709153d2895b1aba937a59e5e4d30dead2.

**Função visual:** Conectar Notion pela interface oficial e ler página fictícia por ID.


## m03-a01-b06 — Permissão de leitura também precisa de critério

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Preencher um contrato mínimo de acesso e localizar revogação do conector. | slides/m03-a01.pptx e slides/m03-a01.pdf, página 5, ID m03-a01-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a01-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a01-b06. Sem trilha prevista. |

**Estado inicial:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Entrada/material:** apoio/contrato-conexao.md, apoio/conversa-demo.txt, apoio/registro-testes.md

**Passos de captura:**
1. Registrar serviço/recurso/operação/aprovação.
2. Executar leitura autorizada.
3. Localizar como remover ou limitar a conexão sem alterar dados.

**Saída e conferência:** Pedido limita escopo e resultado; aluno explica como encerrar o acesso.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a01-b06; SHA-256 4cc7b46288f2dd1af0e77041a6186a6dcc0a385133402fe249d0ece7343c26f7.

**Função visual:** Preencher um contrato mínimo de acesso e localizar revogação do conector.


## m03-a01-b03 — O acesso e o procedimento se complementam

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Relacionar a consulta feita com os critérios da skill de resumo, sem construir outro fluxo. | slides/m03-a01.pptx e slides/m03-a01.pdf, página 6, ID m03-a01-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a01-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a01-b03. Sem trilha prevista. |

**Estado inicial:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Entrada/material:** apoio/contrato-conexao.md, apoio/conversa-demo.txt, apoio/registro-testes.md

**Passos de captura:**
1. Relacionar a consulta feita com os critérios da skill de resumo, sem construir outro fluxo.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Origem e conteúdo coincidem; escopo limitado; gravação/exclusão têm decisão distinta.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a01-b03; SHA-256 4ab9e03c61b738f0a6f3c4444ee5c402011ec35d6dc2dd8bd7befb3762e3684b.

**Função visual:** Relacionar a consulta feita com os critérios da skill de resumo, sem construir outro fluxo.


## Atividade e solução

Conectar página fictícia do Notion, executar leitura e comparar conteúdo, conta e recurso.

Origem e conteúdo coincidem; escopo limitado; gravação/exclusão têm decisão distinta.

## Materiais

- contrato-conexao.md
- conversa-demo.txt
- registro-testes.md