Español
← Volver al inicio

MCP / Agent / Skill / Harness

Un mapa editorial de conceptos relacionados con aplicaciones agénticas

MCP, Agent, Skill y Harness describen aspectos distintos de las aplicaciones agénticas: intercambio de contexto, ejecución, instrucciones reutilizables y entorno anfitrión. Esta visión en cuatro partes es un modelo editorial de Aphrodite, no una arquitectura universal ni la afirmación de que todos los productos la implementen.

Última revisión: . Arquitectura MCP actual (2026-07-28).

  1. Claude Code
    1. Harness
      1. Skill
      2. Agent
      3. Tool
      1. MCP
        1. Herramientas / Datos Ext.
🔗

MCP - Model Context Protocol

Protocolo de Capa de Conexión

MCP es un protocolo cliente-servidor abierto para intercambiar contexto entre aplicaciones de IA y sistemas externos. El anfitrión coordina clientes y los servidores exponen herramientas, recursos y prompts autorizados. MCP no define entrenamiento, inferencia ni el ciclo interno de razonamiento de un Agent.

¿Qué es MCP?

MCP es un protocolo de comunicación que define cómo la IA puede:

  • Solicitar la ejecución de una operación
  • Obtener datos externos
  • Interactuar con aplicaciones locales

Cómo funciona

  1. Un cliente MCP se conecta a un proceso local o servicio remoto
  2. Cliente y servidor intercambian solicitudes, respuestas y notificaciones JSON-RPC
  3. El servidor accede a herramientas, recursos o prompts autorizados
  4. El cliente presenta el resultado normalizado al modelo o interfaz anfitriona

Ejemplo de configuración

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

En Windows puede ser necesario invocar npx mediante cmd /c. Las rutas de configuración varían entre Claude Desktop, Claude Code, Codex y Cursor. Verificado el 2026-07-29 con el repositorio oficial de MCP.

Servidores de referencia oficiales

Servidores de referencia del grupo directivo (repositorio oficial):

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

Son implementaciones educativas y de referencia, no necesariamente listas para producción. Usa el MCP Registry para localizar servidores de terceros y evalúa la identidad del editor, los permisos, la seguridad y el mantenimiento antes de adoptarlos. Los servidores archivados y los de proveedores o de la comunidad son categorías distintas.

🤖

Agent - Agente de IA

Capa de Ejecución de Tareas

El Agent es un sistema de IA capaz de planificar y ejecutar tareas complejas de forma autónoma. A diferencia de las simples preguntas y respuestas, el Agent puede: comprender objetivos → hacer planes → tomar acciones → evaluar resultados → ajustar la estrategia.

Capacidades centrales

  • Comprender instrucciones complejas
  • Dividir tareas grandes en pasos pequeños
  • Decidir autónomamente los siguientes pasos
  • Usar herramientas para completar operaciones
  • Aprender de los resultados de la ejecución

Ejemplo de uso

Ejemplo de Conversación con Claude Agent

Usuario: ¡Ayúdame a refactorizar el manejo de errores en este proyecto

Claude Agent:

Te ayudaré a refactorizar el manejo de errores. Primero déjame analizar la estructura actual del código…

  1. Escanear el código de manejo de errores en el proyecto
  2. Identificar patrones repetidos
  3. Diseñar un enfoque unificado de manejo de errores
  4. Implementar la refactorización módulo por módulo
  5. Ejecutar pruebas para asegurar que nada se rompa

[El Agent ejecuta autónomamente todos los pasos anteriores]

vs GitHub Copilot

Claude Code y GitHub Copilot ofrecen programación con agentes y revisión de código en el terminal o el IDE. La confirmación de permisos, el aislamiento, la elección de modelo, las tareas asíncronas en la nube y la compatibilidad con MCP varían según el producto, el cliente y la versión. Distingue la revisión local de la revisión de pull requests y consulta la documentación vigente.

Última revisión: . Fuentes: Documentación de Claude Code · Funciones de GitHub Copilot.

🛠️

Skill - Extensión de Capacidades

Capa de Mejora de Capacidades

Skill es un conjunto de instrucciones, scripts y recursos que un agente carga bajo demanda para una tarea especializada. El formato SKILL.md está publicado y no depende de un solo producto; Claude Code es uno de los hosts que los cargan. A través de los Skills, puedes: definir comandos comunes, encapsular flujos de trabajo complejos, agregar conocimiento de dominio.

Tipos de Skill

  • Skills personales: en ~/.claude/skills/, reutilizables entre proyectos
  • Skills de proyecto: en .claude/skills/, compartidos con el repositorio
  • Skills de plugin: aportados por plugins instalados
  • Funciones integradas: dependen de la versión; consulta /help

Ejemplo de definición

---
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

Cómo usar

  1. Crea una carpeta con un SKILL.md completo en ~/.claude/skills/<name>/ o .claude/skills/<name>/
  2. Incluye los campos YAML name y description mostrados arriba
  3. Describe la tarea o menciona el Skill por su nombre; no presupongas un comando integrado no documentado
  4. Ejecuta /help y consulta la documentación actual para los comandos de esa versión

Comandos integrados

Los nombres de las funciones integradas de Claude Code pueden cambiar según la versión. Ejecuta /help o consulta la referencia actual de comandos. Los Skills personales, de proyecto y de plugin también pueden exponer comandos /skill-name.

🧩

Harness - Andamio de Agente

Capa de Runtime Host

Aquí, Harness es un término editorial para el entorno anfitrión que rodea a un modelo o Agent. Puede reunir instrucciones del sistema, ciclos de herramientas, estado de sesión, memoria, permisos e integraciones, pero cada producto traza este límite de forma distinta y no requiere todos los componentes mostrados.

Capacidades centrales

  • Ensambla el system prompt y el bucle de herramientas
  • Mantiene el contexto de sesión y la memoria a largo plazo
  • Carga y programa Skills y servidores MCP
  • Proporciona permisos, sandbox y logs
  • Se aloja en múltiples formas (CLI, plugin de IDE, daemon, serverless)

Anatomía de un Harness

Anatomía de un Harness mínimo (Claude Code como ejemplo)

  1. system prompt → CLAUDE.md / briefing del repositorio
  2. tool loop → Read/Edit/Bash/Grep (conjunto de herramientas integradas)
  3. MCP clients → servidores externos vía configuración mcpServers
  4. skills → ~/.claude/skills/*.md (cargados bajo demanda)
  5. runtime → REPL de terminal / plugin VS Code / daemon de gateway

Otras implementaciones de Harness:

  • Codex CLI (openai/codex) — Harness de terminal escrito en Rust
  • OpenClaw — Harness de gateway multicanal multiplataforma
  • Hermes Agent — Harness con bucle de aprendizaje integrado
  • Cursor Agent — Harness embebido en el IDE

Cómo se Articulan los Cuatro

MCP + Agent

MCP + Agent: El Agent usa el protocolo MCP para llamar herramientas externas. Por ejemplo: cuando el Agent necesita leer/escribir archivos, lo realiza a través del servidor MCP de sistema de archivos.

Agent + Skill

Agent + Skill: Los Skills son los «paquetes de habilidades» del Agent. Cuando el usuario invoca un Skill específico, el Agent utiliza las plantillas de prompts y flujos de trabajo correspondientes.

Skill + MCP

Skill + MCP: Los Skills pueden encapsular llamadas complejas a MCP. Por ejemplo: un «Skill de Despliegue» podría llamar a las herramientas MCP de Git + Docker + CLI.

Harness + los tres

Harness + los tres: El Harness es el host que ensambla MCP/Agent/Skill. Editar un archivo de configuración del Harness (p.ej. claudedesktopconfig.json) es como recablear el host; escribir un nuevo Skill es como enchufar una nueva herramienta al host. Claude Code, Codex CLI y Cursor Agent son todas instancias de este patrón «host + trío».

MCP es el protocolo subyacente, que permite al Agent comunicarse con el mundo exterior

Agent es la entidad de ejecución, que planifica y ejecuta tareas según las necesidades del usuario

Skill es la extensión de capacidades, que hace que tareas específicas sean más eficientes y profesionales

Harness es la capa de runtime host que integra los tres en un agente funcional

Estos conceptos interactúan con frecuencia, pero no forman una pila obligatoria ni una jerarquía rígida de dependencias. Los límites y las implementaciones varían según el producto.