Agente de IA, MCP, skills e microagentes: como se encaixam

Equipe Hcode22 de novembro de 202610 min de leitura

Neste artigo
Capa Agente de IA, MCP, skills e microagentes: como se encaixam

Um agente de IA é um sistema em que o modelo decide sozinho quais passos dar e quais ferramentas usar para cumprir um objetivo. Conector MCP, skill e microagente são as peças em volta dele: o conector dá acesso a um sistema, a skill ensina um procedimento e o microagente é um agente pequeno, montado para uma tarefa só.

Quem confunde as três peças costuma errar na hora de montar: escreve um prompt enorme quando precisava de um conector, ou pede um conector quando faltava explicar o processo. Este texto separa cada uma e acompanha um exemplo do começo ao fim: um agente que transforma a transcrição de uma reunião em ata e tarefas. O exemplo é ilustrativo, não um caso de cliente.

O que faz de um sistema um agente

O critério é quem decide o caminho. No artigo Building effective agents, de 19 de dezembro de 2024, a Anthropic separa dois tipos de sistema. Nos workflows, modelos e ferramentas seguem caminhos definidos em código. Nos agentes, o modelo dirige o próprio processo e escolhe as ferramentas a cada passo.

No exemplo da reunião, a diferença fica assim:

  • Workflow: toda vez que uma gravação termina, um fluxo transcreve, resume com um prompt fixo e envia o resumo por e-mail. Os passos são sempre os mesmos.

  • Agente: você pede "prepare a ata da reunião de ontem com o fornecedor e crie as tarefas". O agente localiza a transcrição, decide se precisa consultar a ata anterior, escreve, cria as tarefas no sistema da equipe e avisa o que ficou pendente.

O mesmo artigo recomenda começar pela solução mais simples e só aumentar a complexidade quando ela se paga, porque agentes trocam custo e tempo de resposta por desempenho na tarefa. Para a definição completa e mais exemplos, veja o explicador do blog sobre o que são agentes de IA.

O que é um conector MCP

MCP, sigla de Model Context Protocol, é um padrão aberto para ligar aplicações de IA a sistemas externos. A documentação do protocolo usa a comparação com uma porta USB-C: em vez de cada assistente ter uma integração própria com cada sistema, os dois lados falam o mesmo protocolo.

"Conector" é o nome que os produtos dão a um servidor MCP já pronto para uso. A arquitetura descrita na documentação tem três papéis:

  • Host: a aplicação de IA que você usa, como o Claude ou o Visual Studio Code.

  • Cliente: o componente do host que mantém a conexão com um servidor.

  • Servidor: o programa que expõe um sistema, como a sua agenda, o banco de dados ou o gerenciador de tarefas.

Um servidor pode oferecer três coisas ao agente: ferramentas, que são funções que executam ações; recursos, que são dados para contexto; e prompts, que são modelos de instrução reutilizáveis. O servidor pode rodar na sua máquina ou na nuvem. Para servidores remotos, a documentação recomenda OAuth para obter os tokens de autenticação, o que na prática é a tela de "permitir acesso" que você já conhece.

No exemplo da reunião, o agente precisa de dois conectores: um para ler a transcrição onde ela está guardada e outro para criar tarefas no sistema da equipe. Sem eles, o agente escreve a ata, mas você copia e cola o resto.

A documentação lista Claude, ChatGPT, Visual Studio Code e Cursor entre as aplicações com suporte. O Copilot Studio conecta um agente a um servidor MCP existente por um assistente de configuração, segundo o Microsoft Learn. O n8n tem um nó para consumir servidores MCP e outro para expor fluxos como servidor, segundo a documentação do n8n.

O que é uma skill

Uma skill é uma pasta com um arquivo SKILL.md que ensina o agente a fazer uma tarefa do jeito da sua equipe. O formato se chama Agent Skills. Ele foi desenvolvido pela Anthropic e publicado como padrão aberto, segundo o site da especificação, que lista outros produtos compatíveis.

O arquivo começa com dois campos obrigatórios e segue com instruções em Markdown. A especificação define as regras: name com até 64 caracteres, em minúsculas, números e hifens, igual ao nome da pasta; description com até 1.024 caracteres, dizendo o que a skill faz e quando usar.

Uma skill para o exemplo da reunião:

---
name: ata-de-reuniao
description: Transforma a transcrição de uma reunião em ata no padrão da equipe e em lista de tarefas com responsável e prazo. Use quando o usuário pedir ata, resumo de reunião ou tarefas de uma reunião.
---

# Ata de reunião

## Passos

1. Leia a transcrição inteira antes de escrever.
2. Separe o que foi decidido do que foi apenas discutido.
3. Para cada tarefa, registre o responsável e o prazo ditos na reunião.
   Se um dos dois não foi dito, escreva "a definir". Não invente.
4. Monte a ata no formato abaixo.
5. Mostre a lista de tarefas e peça confirmação antes de criar qualquer
   tarefa em outro sistema.

## Formato da ata

- Data, participantes e objetivo (uma linha cada)
- Decisões (lista numerada)
- Tarefas (tabela: tarefa, responsável, prazo)
- Pendências para a próxima reunião

## Casos comuns

- Transcrição sem nomes: identifique como "Participante 1", "Participante 2".
- Reunião sem decisão: diga isso na ata em vez de preencher a seção.

A pasta se chama ata-de-reuniao e pode ter, além do SKILL.md, subpastas para scripts, documentos de referência e modelos.

O agente não carrega todas as skills o tempo todo. A especificação descreve três estágios: no início, ele lê só o nome e a descrição de cada skill, algo em torno de 100 tokens por skill; quando a tarefa combina com a descrição, lê o SKILL.md inteiro; e só abre os arquivos extras se precisar. Por isso a descrição é a linha mais importante do arquivo: é por ela que o agente decide usar ou ignorar a skill. A recomendação é manter o SKILL.md abaixo de 500 linhas.

Conector ou skill: qual peça falta no seu caso

O conector resolve acesso e a skill resolve método. Se o agente não alcança o sistema, falta conector. Se alcança e faz do jeito errado, falta skill.

Conector MCP

  • O que entrega: Ferramentas e dados de um sistema externo

  • Pergunta que responde: "O agente consegue chegar lá?"

  • Quem costuma criar: Fabricante do sistema ou equipe de TI

  • Formato: Servidor que fala o protocolo MCP

  • Exemplo na ata de reunião: Ler a transcrição, criar tarefas

  • Principal cuidado: Permissões: o que o agente pode ler e alterar

Skill

  • O que entrega: Instruções, modelos e scripts para uma tarefa

  • Pergunta que responde: "O agente sabe como fazemos isso aqui?"

  • Quem costuma criar: Quem domina o processo

  • Formato: Pasta com um SKILL.md

  • Exemplo na ata de reunião: Padrão da ata, regra do "a definir"

  • Principal cuidado: Manutenção: o processo muda e a skill fica velha

As duas peças se combinam. Na skill acima, o passo 5 manda pedir confirmação antes de criar tarefas, e quem cria as tarefas é o conector.

Como montar um microagente

Microagente não é termo de nenhuma especificação. Neste texto, é o nome para um agente pequeno, com um objetivo só, poucas ferramentas e um limite claro do que pode fazer sem perguntar. É o melhor ponto de partida porque dá para testar em uma tarde e auditar em uma página.

São cinco decisões, aqui aplicadas ao exemplo:

  1. Objetivo único: transformar a transcrição em ata e tarefas. Responder dúvidas sobre o projeto fica de fora.

  2. Instruções: a skill ata-de-reuniao.

  3. Conhecimento: as duas últimas atas do mesmo projeto, para manter as pendências.

  4. Ferramentas: um conector para ler transcrições e um para criar tarefas. Nenhum acesso a e-mail.

  5. Limite: o agente mostra as tarefas e espera um "sim" antes de criar. Enviar a ata aos participantes continua com uma pessoa.

O teste também é curto. Rode o microagente em três reuniões que já aconteceram e compare com as atas que a equipe escreveu. Anote onde ele inventou prazo, onde tratou discussão como decisão e quanto tempo você levou para revisar. Cada erro vira uma linha nova na skill.

A mesma receita vale em produtos diferentes: um agente no Copilot Studio, um fluxo com agente no n8n ou uma skill com conectores no Claude. Na página de preços do Claude, consultada em 22 de novembro de 2026, a Anthropic lista conectores e skills em todos os planos, com distribuição de skills para a organização inteira nos planos Team e Enterprise.

Limites e riscos que você precisa conhecer

Um agente com ferramentas erra de um jeito diferente de um chat: o erro vira ação. Uma ata ruim você corrige; vinte tarefas criadas para as pessoas erradas dão trabalho para desfazer.

  • Permissão demais: dê ao conector o menor acesso que resolve a tarefa. Leitura antes de escrita, uma pasta antes do drive inteiro.

  • Servidor MCP de terceiros: ao conectar um servidor que não é da Microsoft, o Microsoft Learn avisa que a responsabilidade pelas ferramentas e pelos recursos acessados é de quem conecta. O raciocínio vale para qualquer host.

  • Conteúdo que dá ordens: uma transcrição ou um e-mail pode conter texto escrito para manipular o agente. A confirmação humana antes de ações que alteram dados é a defesa mais simples. O blog tem um artigo sobre como o NeMo Guardrails protege agentes de IA para quem implementa essa camada em código.

  • Custo e erro acumulado: o artigo da Anthropic observa que agentes custam mais e podem acumular erros ao longo dos passos, e recomenda testes em ambiente isolado e limites de segurança.

  • Dados pessoais: transcrição de reunião tem nome, voz e opinião de pessoas. Confira a política da empresa e a LGPD antes de enviar esse conteúdo a qualquer ferramenta, e avise os participantes de que a reunião é gravada e processada.

Perguntas frequentes

Preciso programar para criar uma skill?

Não. O mínimo é um arquivo de texto com nome, descrição e instruções. Scripts são opcionais e entram quando a tarefa pede um cálculo ou uma conversão que o texto não resolve.

MCP funciona só com o Claude?

Não. O protocolo é aberto, e a documentação lista ChatGPT, Visual Studio Code e Cursor entre as aplicações com suporte. Copilot Studio e n8n também documentam a integração.

Um GPT personalizado ou um agente do Copilot Studio é um microagente?

Pode ser, se tiver um objetivo só, poucas ferramentas e um limite claro. O nome do produto muda; os cinco itens de decisão são os mesmos.

Quantas skills um agente consegue ter?

A especificação não fixa um número. Como só o nome e a descrição ficam carregados, o custo de cada skill parada é pequeno. O limite prático é a clareza: duas descrições parecidas fazem o agente escolher a skill errada.

Próximos passos

Escolha um procedimento que a sua equipe repete e que hoje depende de uma pessoa lembrar o jeito certo. Escreva o SKILL.md em uma página, teste em três casos que já aconteceram e só depois ligue um conector com permissão de escrita. Quando o agente precisar entrar nos sistemas da empresa, com autenticação, registro do que foi feito e aprovação humana, o trabalho de Agentes de IA da Hcode constrói agentes ligados aos sistemas da empresa.

Fontes

Continue aprendendo com a Hcode

Cadastre-se na plataforma de cursos e acompanhe os próximos guias do blog.