한국어
← 홈으로 돌아가기

MCP / Agent / Skill / Harness

에이전트 애플리케이션 관련 개념의 편집 지도

MCP, Agent, Skill, Harness는 에이전트 애플리케이션에서 컨텍스트 교환, 작업 실행, 재사용 지침, 호스트 런타임이라는 서로 다른 관심사를 설명한다. 이 네 부분은 Aphrodite의 편집 모델이며 업계 공통 아키텍처나 모든 제품이 네 요소를 구현한다는 주장이 아니다.

최근 검토: . 현재 MCP 아키텍처(2026-07-28).

  1. Claude Code
    1. Harness
      1. Skill
      2. Agent
      3. Tool
      1. MCP
        1. 외부 도구/데이터
🔗

MCP - Model Context Protocol

연결 계층 프로토콜

MCP는 AI 애플리케이션과 외부 시스템이 컨텍스트를 교환하는 개방형 클라이언트—서버 프로토콜이다. 호스트가 클라이언트를 조정하고 서버는 허가된 도구, 리소스, 프롬프트 같은 기능을 노출한다. 모델 학습, 추론 또는 Agent 내부 추론 루프는 정의하지 않는다.

MCP란?

MCP는 AI가 다음을 수행하는 방식을 정의하는 통신 프로토콜입니다:

  • 작업 실행 요청
  • 외부 데이터 가져오기
  • 로컬 애플리케이션과 상호작용

작동 원리

  1. MCP 클라이언트가 로컬 프로세스 또는 원격 서비스에 연결
  2. 클라이언트와 서버가 JSON-RPC 요청·응답·알림을 교환
  3. 서버가 허가된 도구·리소스·프롬프트에 접근
  4. 클라이언트가 정규화된 결과를 모델 또는 호스트 UI에 제공

설정 예시

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

Windows에서는 cmd /c를 통해 npx를 호출해야 할 수 있다. 설정 경로는 Claude Desktop, Claude Code, Codex, Cursor마다 다르다. 2026-07-29에 MCP 공식 저장소와 대조했다.

공식 레퍼런스 서버

운영위원회 참조 서버(공식 저장소):

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

교육 및 참고용 구현이며 곧바로 프로덕션에 적합하다는 뜻은 아니다. MCP Registry에서 타사 서버를 찾고 도입 전에 게시자 신원, 권한, 보안, 유지 관리 상태를 평가해야 한다. 보관된 서버와 공급업체 또는 커뮤니티 서버는 별도 범주이다.

🤖

Agent - AI 에이전트

작업 실행 계층

Agent는 복잡한 작업을 자율적으로 계획하고 실행할 수 있는 AI 시스템이다. 단순한 질의응답과 달리, Agent는 다음과 같이 동작한다: 목표 이해 → 계획 수립 → 작업 실행 → 결과 평가 → 전략 조정.

핵심 기능

  • 복잡한 지시 이해
  • 큰 작업을 작은 단계로 분할
  • 다음 단계를 자율적으로 결정
  • 도구를 사용하여 작업 수행
  • 실행 결과로부터 학습

사용 예시

Claude Agent 대화 예시

사용자: 이 프로젝트의 오류 처리를 리팩토링해 주세요

Claude Agent:

오류 처리를 리팩토링해 드리겠습니다. 먼저 현재 코드 구조를 분석하겠습니다…

  1. 프로젝트의 오류 처리 코드를 스캔
  2. 반복되는 패턴 식별
  3. 통합 오류 처리 방식 설계
  4. 모듈별로 리팩토링 수행
  5. 테스트를 실행하여 기존 기능이 손상되지 않는지 확인

[Agent가 위 모든 단계를 자율적으로 실행합니다]

GitHub Copilot 비교

Claude Code와 GitHub Copilot은 모두 터미널 또는 IDE에서 에이전트형 코딩과 코드 리뷰 기능을 제공한다. 권한 확인, 샌드박스, 모델 선택, 클라우드 비동기 작업, MCP 지원 범위는 제품·클라이언트·버전에 따라 달라진다. 로컬 리뷰와 풀 리퀘스트 리뷰를 구분하고 최신 제품 문서를 확인해야 한다.

최근 검토: . 출처: Claude Code 문서 · GitHub Copilot 기능.

🛠️

Skill - 기능 확장

기능 강화 계층

Skill은 에이전트가 특정 전문 작업을 위해 필요할 때 불러오는 지침, 스크립트, 리소스의 묶음이다. SKILL.md 형식은 공개되어 있으며 특정 제품에 종속되지 않고, Claude Code는 이를 불러오는 호스트 중 하나이다. Skill을 통해 다음과 같은 작업을 할 수 있다: 자주 사용하는 명령 정의, 복잡한 워크플로우 캡슐화, 도메인 지식 추가.

Skill 유형

  • 개인 Skill: ~/.claude/skills/에 저장해 프로젝트 간 재사용
  • 프로젝트 Skill: .claude/skills/에 저장해 저장소와 공유
  • 플러그인 Skill: 설치한 플러그인이 제공
  • 번들 기능: 버전에 따라 달라지므로 /help로 확인

정의 예시

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

사용 방법

  1. ~/.claude/skills/<name>/ 또는 .claude/skills/<name>/ 아래에 완전한 SKILL.md가 있는 폴더를 생성
  2. 위 예시의 YAML name 및 description 필드를 포함
  3. 작업을 설명하거나 Skill 이름을 언급하고, 문서화되지 않은 내장 명령이 있다고 가정하지 않기
  4. /help를 실행하고 버전별 명령은 최신 문서에서 확인

내장 명령

Claude Code의 번들 기능 이름은 버전에 따라 달라질 수 있다. /help를 실행하거나 최신 명령 참고 문서를 확인하면 된다. 개인·프로젝트·플러그인 Skill도 /skill-name 명령을 제공할 수 있다.

🧩

Harness - 에이전트 스캐폴드

런타임 계층

이 페이지에서 Harness는 모델이나 Agent를 둘러싼 호스트 런타임을 가리키는 편집 용어다. 시스템 지침, 도구 루프, 세션 상태, 메모리, 권한, 연동을 결합할 수 있지만 제품마다 경계가 다르며 이 페이지의 모든 구성 요소가 필수인 것은 아니다.

핵심 기능

  • system prompt와 도구 루프 조립
  • 세션 컨텍스트와 장기 메모리 유지
  • Skill과 MCP 서버 로드 및 스케줄링
  • 권한 제어, 샌드박스, 로그 제공
  • 다양한 형태로 호스팅 (CLI, IDE 플러그인, 데몬, Serverless)

Harness 구조 해부

최소 Harness의 구조 (Claude Code 기준)

  1. system prompt → CLAUDE.md / 저장소 설명
  2. tool loop → Read/Edit/Bash/Grep (내장 도구 세트)
  3. MCP clients → mcpServers 설정으로 외부 서버에 연결
  4. skills → ~/.claude/skills/*.md (요청 시 로드)
  5. runtime → 터미널 REPL / VS Code 플러그인 / 게이트웨이 데몬

기타 Harness 구현:

  • Codex CLI (openai/codex) — Rust로 작성된 터미널 Harness
  • OpenClaw — 크로스 플랫폼 멀티채널 게이트웨이 Harness
  • Hermes Agent — 학습 루프를 내장한 Harness
  • Cursor Agent — IDE에 임베드된 Harness

네 가지의 관계

MCP + Agent

MCP + Agent: Agent는 MCP 프로토콜을 통해 외부 도구를 호출한다. 예를 들어: Agent가 파일을 읽고 쓸 때 MCP 파일시스템 서버를 통해 작업을 수행한다.

Agent + Skill

Agent + Skill: Skill은 Agent의 '기능 패키지'이다. 사용자가 특정 Skill을 호출하면 Agent는 해당 프롬프트 템플릿과 워크플로우를 사용한다.

Skill + MCP

Skill + MCP: Skill은 복잡한 MCP 호출을 캡슐화할 수 있다. 예를 들어: '배포 Skill'은 MCP의 Git + Docker + CLI 도구를 호출할 수 있다.

Harness + 세 가지

Harness + 세 가지: Harness는 호스트이며 MCP/Agent/Skill을 조립한다. Harness 설정 파일(예: claudedesktopconfig.json)을 변경하는 것은 배선을 다시 하는 것과 같고, 새 Skill을 작성하는 것은 호스트에 새 도구를 장착하는 것과 같다. Claude Code, Codex CLI, Cursor Agent는 모두 이러한 “호스트 + 3종 세트”의 인스턴스이다.

MCP는 하위 계층 프로토콜로, Agent가 외부 세계와 통신할 수 있게 한다

Agent는 실행 주체로, 사용자의 요구에 따라 작업을 계획하고 실행한다

Skill은 기능 확장으로, 특정 작업을 더 효율적이고 전문적으로 만든다

Harness는 런타임 계층으로, 세 가지를 실제로 작동하는 에이전트로 통합한다

이 개념들은 자주 함께 작동하지만 필수 기술 스택이나 엄격한 의존 계층은 아니다. 제품마다 경계와 구현이 다르다.