Habilidades e ferramentas MCP não são a mesma coisa — e confundi-las pode custar caro. Aprenda a verdadeira diferença, os reais problemas e como combinar ambos para um fluxo de trabalho mais eficiente.

Habilidades MCP vs Ferramentas MCP: Qual é a Diferença e Como Combiná-las

Todos estão falando sobre MCP. Todos estão falando sobre habilidades.

A maioria das pessoas as usa de forma intercambiável — e esse é exatamente o problema.

Elas não são a mesma coisa. Elas não resolvem o mesmo problema. E se você pegar a errada, você sentirá: alucinações, explosões de contexto, agentes que se desviam da tarefa e fluxos de trabalho que desmoronam sob pressão.

Vamos corrigir isso.

O Modelo Mental Central

Pense nisso como uma cozinha.

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

Habilidades são suas receitas — as instruções passo a passo que dizem a um chef habilidoso exatamente como transformar esses ingredientes em algo bom. Sem elas, você tem poder 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 ótimas instruções, mas não tem como agir sobre elas.

Você precisa de ambos.

O Que É uma Ferramenta MCP?

O Protocolo de Contexto de Modelo é um padrão aberto — agora sob a Fundação de IA Agentic da Linux Foundation — que dá aos agentes de IA uma maneira 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, o Gemini CLI ou um agente personalizado — ele tem acesso a um conjunto de ferramentas tipadas e determinísticas. Cada ferramenta tem um esquema de entrada/saída claro. Quando o agente a chama, ela é executada — sem interpretação, sem risco de alucinação no 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 o exterior. É o sistema nervoso.

Use MCP quando você precisar que o agente:

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

O Que É uma Habilidade?

Uma Habilidade é uma pasta contendo um arquivo Markdown (com frontmatter YAML) mais scripts e recursos opcionais. Não é executável por si só — é um manual de instruções.

Quando o pedido de um usuário corresponde aos critérios de relevância de uma Habilidade, o agente carrega essas instruções dinamicamente e as segue. Pense nisso como dar ao agente memória procedural de nível especialista sob demanda.

---
name: revisao-componente-angular
description: Revisar componentes Angular para conformidade com Signal e arquitetura autônoma
---

# Revisão de Componente Angular

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

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

Use uma habilidade quando você precisar que o agente:

• Siga um processo ou lista de verificação consistente
• Aplique expertise específica do domínio (seus padrões de codificação, critérios de revisão)
• Codifique conhecimento que não muda com frequência
• Reutilize o mesmo fluxo de trabalho em diferentes conversas

Os Verdadeiros Problemas

É aqui que a maioria dos guias para. Eles não deveriam.

MCP: O Custo 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 de 550 a 1.400 tokens. Conecte GitHub, Slack e Sentry, e você está olhando para 55.000 tokens queimados antecipadamente — mais de um quarto do limite de 200k do Claude antes que qualquer trabalho real comece. E se você estiver usando o Gemini com sua janela de 1M+ tokens, você pode pensar que pode simplesmente ignorar isso. Não pode. Mesmo que você tenha espaço para isso, despejar 55.000 tokens de esquema JSON bruto em cada turno de uma conversa aumenta sua latência, aumenta os custos da API e dilui o foco do modelo.

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

A boa notícia: clientes modernos como Claude Code e o Gemini CLI adotaram a descoberta progressiva para MCP — carregando apenas nomes e descrições de ferramentas antecipadamente (~20–50 tokens cada) e buscando esquemas completos apenas quando o agente realmente precisa de uma ferramenta. O custo de tokens diminuiu em ~85%. Mas esse recurso só funciona se sua configuração MCP estiver configurada para usá-lo, e a maioria das configurações ainda não está.

Habilidades: O Problema da Obsolescência

Habilidades são arquivos Markdown. Elas não se atualizam sozinhas. Se seus padrões Angular evoluírem — digamos que você migre de setInput() para a nova API declarativa no Angular 20 — sua Habilidade ainda ensina o antigo método até que alguém a atualize manualmente.

Quanto mais habilidades você criar, mais carga de manutenção você terá. E se uma habilidade estiver sutilmente errada, o agente a seguirá com confiança — sem erro, apenas uma saída silenciosamente incorreta.

Ambos: O Problema da Seleção

Dê a um agente muitas ferramentas ou muitas habilidades, e ele começa a fazer as escolhas erradas — chamando a ferramenta errada, acionando o manual errado ou combinando-os de maneiras que produzem instruções contraditórias. Especialistas recomendam manter-se abaixo de 10–15 ferramentas MCP ativas a qualquer momento.

Como Combiná-los

O padrão mais poderoso é usá-los como camadas:

Camada 1 — MCP fornece acesso.
Conecte apenas o que o agente realmente precisa para a tarefa atual. Angular CLI, um banco de dados e um sistema de arquivos. Mantenha-o enxuto.

Camada 2 — Habilidades fornecem conhecimento.
Use habilidades para guiar o agente em processos complexos ou específicos do domínio, garantindo que ele siga as melhores práticas e padrões.