Módulo 3 · Agentes que agem

MCP: conectar o agente a sistemas e dados

Aula 8 de 15 Aula de 35 min Atualizado em 29 de setembro de 2026
Progresso no curso53%

Nesta aula

O agente só é útil de verdade quando enxerga os sistemas do negócio. O MCP é a tomada padrão que faz isso sem gambiarra.

Até aqui os seus agentes enxergam o que você anexa ou a pasta onde estão. Mas o dia a dia do negócio vive em sistemas: agenda, planilha na nuvem, sistema de gestão, e-mail, banco de dados. Conectar um agente a cada um deles era, até pouco tempo, trabalho de programador, feito de um jeito diferente para cada plataforma. O MCP resolve isso com um padrão. Nesta aula eu explico o conceito sem jargão, mostro o que existe pronto e, principalmente, como decidir o que o agente pode ler e escrever em cada sistema. A prática é um mapa, não uma instalação: a decisão vem antes da conexão.

O problema que o MCP resolve

Pense numa imobiliária pequena. Os imóveis estão num sistema de gestão. As visitas, numa agenda compartilhada. Os interessados, numa planilha na nuvem. Os contratos, numa pasta. Um agente útil para essa imobiliária precisaria consultar os quatro. Antes do MCP, cada conexão era um pequeno programa feito sob medida, para uma plataforma de IA específica. Trocou de plataforma? Refaz tudo. Trocou de sistema? Refaz de novo.

O MCP, Model Context Protocol, é um protocolo aberto que define como um agente conversa com uma ferramenta ou uma fonte de dados. Foi criado pela Anthropic e liberado como padrão aberto, e hoje é adotado por várias plataformas e ferramentas. A analogia que eu uso é a tomada elétrica: antes do padrão, cada aparelho tinha o seu plugue; com o padrão, qualquer aparelho entra em qualquer tomada. No MCP, qualquer conector compatível funciona em qualquer agente compatível.

Dois papéis: servidor e cliente

Servidor MCP

O conector do lado do sistema. Um programa pequeno que "representa" a agenda, o banco de dados ou a pasta, e oferece ao agente ações como "listar eventos de amanhã" ou "buscar cliente por nome". Quem fornece o sistema pode publicar o servidor oficial; a comunidade publica outros.

Cliente MCP

O agente que usa os servidores. Claude Code é cliente MCP; o aplicativo do Claude para computador também, e outras ferramentas e plataformas adotaram o padrão. O cliente descobre quais ações o servidor oferece e as usa quando a tarefa pede.

O que o servidor oferece se chama, no protocolo, ferramenta (uma ação que o agente pode executar) e recurso (um dado que o agente pode ler). Volte à anatomia da aula 2: MCP é o jeito padronizado de dar ferramentas ao agente. A ficha do agente não mudou; o que mudou é que agora as ferramentas vêm de fora, prontas.

Dica

Você não precisa entender como o protocolo funciona por dentro, do mesmo jeito que não precisa entender a rede elétrica para ligar um aparelho. Precisa entender três coisas: de onde vem o conector, o que ele pode fazer e com qual permissão. O resto desta aula é sobre isso.

O que existe pronto e de onde vem

No momento em que escrevo (setembro de 2026), existem servidores MCP prontos para categorias inteiras de sistema: arquivos locais, repositórios de código, bancos de dados, ferramentas de escritório e documentos na nuvem, serviços de mensagem, agendas. Há três origens, e a origem é a primeira coisa que você confere:

  1. Oficial do fornecedor do sistema. A empresa que faz o sistema publica o servidor. É a origem preferida: quem conhece o sistema garante o conector e o mantém.
  2. De referência, mantido pela comunidade do protocolo. Servidores exemplares para sistemas comuns, publicados abertamente. Boa origem, com a ressalva de conferir se está mantido.
  3. De terceiros. Qualquer pessoa pode publicar um servidor. Alguns são excelentes; outros são abandonados; alguns podem ser maliciosos. Só use com revisão de alguém técnico da sua confiança.

A conexão em si varia por plataforma. No Claude Code, servidores são adicionados por um comando de configuração; no aplicativo do Claude para computador, por um arquivo de configuração ou pelo menu de conectores; nas plataformas web, por um catálogo de integrações. A documentação oficial de cada uma mostra o caminho atual. Se você tem alguém técnico na equipe ou um fornecedor de TI, essa é a parte que eu pediria para essa pessoa fazer a primeira vez, com você do lado decidindo permissões.

Cuidado

Um servidor MCP é um programa que roda com as permissões que você deu, e o agente confia no que ele devolve. Servidor de origem desconhecida pode ler mais do que devia ou devolver dados manipulados para influenciar o agente. Trate como qualquer software com acesso aos seus dados: origem conhecida, versão mantida, permissão mínima. Mais sobre isso na aula 13.

Permissões: o que o agente lê e o que ele escreve

Esta é a decisão que importa, e ela é sua, não do técnico. Para cada sistema, você responde duas perguntas: o que o agente precisa LER para a tarefa? O que ele precisa ESCREVER? A resposta padrão para escrita, na primeira versão, é "nada". Leitura já resolve a maior parte do valor, com uma fração do risco.

Vou usar uma clínica odontológica com quatro sistemas como exemplo:

SistemaLerEscreverRisco se der errado
Agenda (sistema de gestão)Horários livres e ocupados dos próximos 30 diasNada na v1. Na v2, criar pré-agendamento marcado "aguardando confirmação"Baixo na leitura; médio na escrita (agendamento errado)
Cadastro de pacientesNada. O agente não precisa de dados pessoais para informar horáriosNadaAlto (dado de saúde e pessoal)
Planilha de convênios aceitosLista de convênios e procedimentos cobertosNadaBaixo
E-mail da recepçãoNada na v1Nada na v1. Na v2, enviar resumo diário para a recepçãoMédio (envio errado)

Repare no cadastro de pacientes: leitura zero. O agente que informa horários e convênios não precisa saber quem são os pacientes. Isso é permissão mínima na prática: não é "dar o mínimo que dá para dar", é "dar só o que a tarefa exige".

Três regras de permissão

Exemplo real

Um escritório contábil conectou o agente ao banco de dados do sistema de gestão para responder à equipe "quais clientes ainda não enviaram os extratos". Primeira versão: usuário só leitura, restrito a duas tabelas (clientes e status de documentos), sem acesso a valores. Seis semanas depois, com o agente acertando, ganhou permissão de escrita em uma coluna: marcar "lembrete enviado". Uma coluna. Escrita de verdade em dado financeiro nunca foi liberada, por decisão, não por limitação técnica.

Quando o MCP vale a pena e quando não vale

Nem tudo pede conector. Se a informação muda pouco (tabela de serviços, políticas), um arquivo no projeto resolve, como na aula 4. Se muda todo dia e o agente precisa do dado atual (agenda, estoque, status de pedido), um conector vale a pena. Se o sistema não tem servidor MCP e ninguém técnico pode construir ou revisar um, a alternativa honesta é uma exportação periódica (uma planilha gerada toda manhã) que o agente lê como arquivo. É menos elegante e funciona.

E uma regra que serve para tudo neste curso: a conexão é a parte técnica; a decisão sobre o que o agente pode ver e fazer é a parte de negócio. Não delegue a segunda para quem faz a primeira. O mapa da prática é o documento que você entrega ao técnico, e ele conecta o que está no mapa, não mais.

Prática · 10 min

Mapeie três sistemas do negócio e o que o agente pode ler e escrever

  1. Abra um documento e liste os sistemas que o processo escolhido na aula 3 usa (agenda, planilha, gestão, e-mail, pasta, mensagens). Escolha os três mais importantes para o agente do curso.
  2. Monte uma tabela com cinco colunas: sistema, ler, escrever, risco se der errado, origem do conector (oficial, referência, terceiro, exportação por arquivo, não sei ainda).
  3. Na coluna "ler", escreva o dado específico, não o sistema inteiro. Se a resposta for "nada", escreva "nada" e o motivo.
  4. Na coluna "escrever", escreva "nada na v1" a menos que a tarefa seja impossível sem escrita; nesse caso, escreva a ação mais reversível possível (rascunho, pendente, marcação).
  5. Na coluna "risco", classifique baixo, médio ou alto pensando no pior caso. Toda linha "alto" precisa de uma frase dizendo como o risco é contido (só leitura, conta própria, escopo por dado).
  6. Adicione no fim uma linha de decisão: "o agente do curso conecta a: ..." com no máximo dois sistemas na primeira versão.
Entregável: o mapa de três sistemas com o que o agente lê e escreve em cada um, o risco e a origem do conector, mais a decisão de quais entram na primeira versão. Esse mapa vai para quem fizer a conexão e para o projeto final.

Resumo da aula

Quiz da aula

Quatro perguntas para fixar. A melhor nota fica guardada para o certificado.

Aula 8 de 15

Antes de seguir para a próxima aula

Coloque em prática o que viu. As caixas ficam marcadas neste navegador, para você voltar depois.

Ficou com dúvida nesta aula? O time da IV Help responde pessoalmente no WhatsApp.

Perguntar no WhatsApp