Habilidades MCP vs Ferramentas MCP: A forma correta de configurar o Servidor MCP

As habilidades e as ferramentas MCP não são a mesma coisa — e confundí-las tem um custo real. Aprenda a diferença, os problemas reais e como combiná-las para um fluxo de trabalho agente que realmente funcione.

Todo mundo fala sobre MCP. Todo mundo fala sobre habilidades.

A maioria as usa como sinônimos — e esse é exatamente o problema.

Não são a mesma coisa. Não resolvem o mesmo problema. E se você usar o incorreto, você vai sentir: alucinações, contexto transbordado, agentes que perdem o fio da meada e fluxos de trabalho que se quebram sob pressão.

Vamos resolver isso.

O modelo mental

Pense nisso como uma cozinha.

As ferramentas MCP são seus eletrodomésticos e ingredientes — o forno, a geladeira, os vegetais frescos. Capacidade pura. Sem elas, nada é cozido.

As habilidades são suas receitas — as instruções passo a passo que dizem a um chef exatamente como transformar esses ingredientes em algo bom. Sem elas, você tem poder, mas sem direção.

Um agente com apenas ferramentas MCP pode fazer coisas, mas não necessariamente sabe como fazê-las bem. Um agente com apenas habilidades tem excelentes instruções, mas não pode agir sobre elas.

Você precisa dos dois.

O que é uma ferramenta MCP?

O Model Context Protocol é um padrão aberto — agora sob a Agentic AI Foundation da Linux Foundation — que dá aos agentes de IA uma forma padronizada de se conectar a sistemas externos: bancos de dados, APIs, sistemas de arquivos, GitHub, Slack, seu Angular CLI.

Quando você conecta um servidor MCP ao seu cliente — seja Claude Code, a CLI do Gemini ou um agente personalizado —, ele acessa um conjunto de ferramentas determinísticas e tipadas. Cada ferramenta tem um esquema claro de entrada e saída. Quando o agente a chama, ela é executada — sem interpretação, sem risco de alucinação em nível de execução. É uma chamada de API estruturada, não uma sugestão.

{
  "mcpServers": {
    "angular-cli": {
      "command": "npx",
      "args": ["-y", "@angular/cli", "mcp"]
    }
  }
}

MCP é como o agente alcança fora de si mesmo. É o sistema nervoso.

Use MCP quando o agente precisar:

• Ler ou escrever em um sistema real (banco de dados, sistema de arquivos, API)
• Executar ações com entradas e saídas claras e auditáveis.
• Conectar-se a ferramentas que você não controla
• Integrar múltiplos serviços através de uma interface consistente.

O que é uma habilidade?

Uma habilidade é uma pasta que contém um arquivo Markdown (com frontmatter YAML) mais scripts e recursos opcionais. Não é executável por si só — é um playbook.

Quando a solicitação de um usuário coincide com os critérios de relevância de uma habilidade, o agente carrega essas instruções dinamicamente e as segue. É como dar ao agente memória procedural de nível especialista, sob demanda.

---
name: angular-component-review
description: Revisar componentes Angular para conformidade com Signals e arquitetura standalone
---

# Revisão de Componente Angular

Ao revisar um componente Angular:
1. Verifique se todo o estado usa `signal()` ou `computed()` — nunca mutação direta
2. Confirme que o componente é `standalone: true`
3. Assegure-se de que não haja dependências de `NgModule`
4. Valide que se use `@if` / `@for` em vez de `*ngIf` / `*ngFor`

O agente o carrega apenas quando é relevante. Quando não é — não custa nada.

Use uma habilidade quando o agente precisar:

• Seguir um processo ou checklist consistente.
• Aplicar experiência específica do domínio (seus padrões de código, critérios de revisão).
• Codificar conhecimento que não muda frequentemente.
• Reutilizar o mesmo fluxo de trabalho em diferentes conversas.

As desvantagens reais

Aqui é onde a maioria dos guias para. Não deveriam.

MCP: O Imposto de Tokens

Cada ferramenta MCP que você conecta injeta seu esquema completo na janela de contexto antes que o agente processe uma única mensagem. Cada ferramenta custa 550–1.400 tokens. Conecte GitHub, Slack e Sentry e você está olhando 55.000 tokens queimados de entrada — mais de um quarto do limite de 200k do Claude antes de fazer qualquer trabalho real.

Uma equipe relatou conectar três servidores MCP e consumir 143.000 de 200.000 tokens apenas em definições de ferramentas. Ao agente restavam 57.000 tokens para a conversa real.

E se você usar o Gemini com sua janela de contexto de 1M+ tokens, pode pensar que pode ignorar isso. Não faça. Mesmo que você tenha espaço sobrando, injetar 55.000 tokens de esquema JSON cru em cada iteração da conversa aumenta a latência, incrementa os custos da API e dilui o foco do modelo.

A boa notícia: clientes modernos como Claude Code e a CLI do Gemini adotaram o progressive discovery para MCP — carregando apenas nomes e descrições de ferramentas no início (~20–50 tokens cada uma), e obtendo os esquemas completos apenas quando o agente realmente precisa de uma ferramenta. O overhead de tokens caiu ~85%. Mas isso só funciona se sua configuração MCP estiver preparada para usá-lo — e a maioria ainda não está.

Habilidades: O Problema da Desatualização

As habilidades são arquivos Markdown. Não se atualizam sozinhos. Se seus padrões de Angular evoluírem — digamos que você migrou de setInput() para a nova API declarativa no Angular 20 — sua Habilidade continua ensinando a forma antiga até que alguém a atualize manualmente.

Quanto mais habilidades você cria, maior é a carga de manutenção. E se uma habilidade estiver sutilmente errada, o agente a seguirá com confiança — sem erro, apenas output silenciosamente incorreto.

Ambos: O problema da seleção

Dê a um agente muitas ferramentas ou muitas habilidades e ele começa a tomar as decisões erradas — chama a ferramenta incorreta, ativa o playbook errado, ou os combina de formas que pro