Português
← Voltar ao início

MCP / Agent / Skill / Harness

Um mapa editorial de conceitos ligados a aplicações agênticas

MCP, Agent, Skill e Harness descrevem aspetos distintos das aplicações agênticas: troca de contexto, execução, instruções reutilizáveis e runtime do host. Esta visão em quatro partes é um modelo editorial da Aphrodite, não uma arquitetura universal nem a afirmação de que todos os produtos a implementam.

Última revisão: . Arquitetura MCP atual (2026-07-28).

  1. Claude Code
    1. Harness
      1. Skill
      2. Agent
      3. Tool
      1. MCP
        1. Ferramentas / Dados Ext.
🔗

MCP - Model Context Protocol

Protocolo da Camada de Conexão

O MCP é um protocolo cliente-servidor aberto para trocar contexto entre aplicações de IA e sistemas externos. O host coordena clientes e os servidores expõem ferramentas, recursos e prompts autorizados. O MCP não define treino, inferência nem o ciclo interno de raciocínio de um Agent.

O que é MCP?

O MCP é um protocolo de comunicação que define como a IA pode:

  • Solicitar a execução de uma operação
  • Obter dados externos
  • Interagir com aplicações locais

Como funciona

  1. Um cliente MCP conecta-se a um processo local ou serviço remoto
  2. Cliente e servidor trocam solicitações, respostas e notificações JSON-RPC
  3. O servidor acessa ferramentas, recursos ou prompts autorizados
  4. O cliente apresenta o resultado normalizado ao modelo ou host

Exemplo de configuração

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Projects"]
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "/Users/you/Projects/example"]
    }
  }
}

No Windows, pode ser necessário invocar npx por meio de cmd /c. Os caminhos de configuração diferem entre Claude Desktop, Claude Code, Codex e Cursor. Verificado em 2026-07-29 com base no repositório oficial do MCP.

Servidores de referência oficiais

Servidores de referência do grupo diretor (repositório oficial):

  • Everything
  • Fetch
  • Filesystem
  • Git
  • Memory
  • Sequential Thinking
  • Time

São implementações educacionais e de referência, não necessariamente prontas para produção. Use o MCP Registry para localizar servidores de terceiros e avalie identidade do publicador, permissões, segurança e manutenção antes de adotá-los. Servidores arquivados e servidores de fornecedores ou da comunidade são categorias distintas.

🤖

Agent - Agente de IA

Camada de Execução de Tarefas

O Agent é um sistema de IA capaz de planejar e executar tarefas complexas de forma autônoma. Diferente de um simples sistema de perguntas e respostas, o Agent pode: compreender objetivos → fazer planos → executar ações → avaliar resultados → ajustar a estratégia.

Capacidades centrais

  • Compreender instruções complexas
  • Dividir grandes tarefas em pequenas etapas
  • Decidir autônomamente os próximos passos
  • Usar ferramentas para concluir operações
  • Aprender com os resultados da execução

Exemplo de uso

Exemplo de Conversa com Claude Agent

Usuário: Ajude-me a refatorar o tratamento de erros neste projeto

Claude Agent:

Vou ajudá-lo a refatorar o tratamento de erros. Deixe-me primeiro analisar a estrutura atual do código…

  1. Analisar o código de tratamento de erros no projeto
  2. Identificar padrões repetidos
  3. Projetar uma abordagem unificada de tratamento de erros
  4. Implementar a refatoração módulo por módulo
  5. Executar testes para garantir que nada foi quebrado

[O Agent executa autônomamente todas as etapas acima]

vs GitHub Copilot

Claude Code e GitHub Copilot oferecem programação agêntica e revisão de código no terminal ou na IDE. Confirmação de permissões, sandbox, escolha de modelo, tarefas assíncronas na nuvem e suporte a MCP variam conforme produto, cliente e versão. Diferencie revisão local de revisão de pull request e consulte a documentação atual.

Última revisão: . Fontes: Documentação do Claude Code · Recursos do GitHub Copilot.

🛠️

Skill - Extensão de Capacidades

Camada de Aprimoramento de Capacidades

O Skill é um conjunto de instruções, scripts e recursos que um agente carrega sob demanda para uma tarefa especializada. O formato SKILL.md é publicado e não está vinculado a um único produto; o Claude Code é um dos hosts que os carregam. Através dos Skills, você pode: definir comandos comuns, encapsular fluxos de trabalho complexos, adicionar conhecimento de domínio.

Tipos de Skill

  • Skills pessoais: em ~/.claude/skills/, reutilizáveis entre projetos
  • Skills de projeto: em .claude/skills/, compartilhados no repositório
  • Skills de plugin: fornecidos pelos plugins instalados
  • Recursos integrados: dependem da versão; verifique com /help

Exemplo de definição

---
name: component-docs
description: Generate documentation for Vue components. Use when the user asks to document a component or component library.
---

Component documentation

  1. Inspect component props, emits, slots, and dependencies.
  2. Generate a usage example.
  3. Document accessibility and edge cases.
  4. Link to related components.

Path: ~/.claude/skills/component-docs/SKILL.md

Como usar

  1. Crie uma pasta com um SKILL.md completo em ~/.claude/skills/<name>/ ou .claude/skills/<name>/
  2. Inclua os campos YAML name e description mostrados acima
  3. Descreva a tarefa ou mencione o Skill pelo nome; não pressuponha um comando integrado não documentado
  4. Execute /help e consulte a documentação atual para comandos específicos da versão

Comandos integrados

Os nomes dos recursos integrados do Claude Code podem mudar conforme a versão. Execute /help ou consulte a referência atual de comandos. Skills pessoais, de projeto e de plugin também podem oferecer comandos /skill-name.

🧩

Harness - Andaime de Agente

Camada de Runtime Host

Aqui, Harness é um termo editorial para o runtime anfitrião em torno de um modelo ou Agent. Pode reunir instruções de sistema, ciclos de ferramentas, estado da sessão, memória, permissões e integrações, mas cada produto define esse limite de forma diferente e não exige todos os componentes apresentados.

Capacidades centrais

  • Monta system prompt e loop de ferramentas
  • Mantém o contexto de sessão e a memória de longo prazo
  • Carrega e agenda Skills e servidores MCP
  • Fornece permissões, sandbox e logs
  • Hospeda-se em várias formas (CLI, plugin de IDE, daemon, serverless)

Anatomia de um Harness

Anatomia de um Harness mínimo (Claude Code como exemplo)

  1. system prompt → CLAUDE.md / briefing do repositório
  2. tool loop → Read/Edit/Bash/Grep (conjunto de ferramentas embutido)
  3. MCP clients → servidores externos via configuração mcpServers
  4. skills → ~/.claude/skills/*.md (carregados sob demanda)
  5. runtime → REPL de terminal / plugin VS Code / daemon de gateway

Outras implementações de Harness:

  • Codex CLI (openai/codex) — Harness de terminal escrito em Rust
  • OpenClaw — Harness de gateway multicanal multiplataforma
  • Hermes Agent — Harness com loop de aprendizado integrado
  • Cursor Agent — Harness embarcado na IDE

Como os Quatro se Articulam

MCP + Agent

MCP + Agent: O Agent usa o protocolo MCP para chamar ferramentas externas. Por exemplo: quando o Agent precisa ler/escrever arquivos, ele o faz através do servidor MCP de sistema de arquivos.

Agent + Skill

Agent + Skill: Os Skills são os «pacotes de habilidades» do Agent. Quando o usuário invoca um Skill específico, o Agent usa os templates de prompt e fluxos de trabalho correspondentes.

Skill + MCP

Skill + MCP: Os Skills podem encapsular chamadas complexas ao MCP. Por exemplo: um «Skill de Deploy» pode chamar ferramentas MCP de Git + Docker + CLI.

Harness + os três

Harness + os três: O Harness é o host que monta MCP/Agent/Skill. Editar um arquivo de configuração do Harness (ex. claudedesktopconfig.json) é como religar o host; escrever um novo Skill é como conectar uma nova ferramenta ao host. Claude Code, Codex CLI e Cursor Agent são todos instâncias deste padrão «host + conjunto de três».

MCP é o protocolo subjacente, permitindo que o Agent se comunique com o mundo externo

Agent é a entidade de execução, planejando e executando tarefas com base nas necessidades do usuário

Skill é a extensão de capacidades, tornando tarefas específicas mais eficientes e profissionais

Harness é a camada de runtime host que integra os três em um agente funcional

Estes conceitos interagem frequentemente, mas não formam uma pilha obrigatória nem uma hierarquia rígida de dependências. Limites e implementações variam entre produtos.