MCP와 에이전트 스킬로 구현하는 AI 뷰티 패션 워크플로우

AI 에이전트에게 “내 피부 상태를 분석해 줘”, “이 헤어스타일이 나에게 어울리는지 보여줘”, “이 재킷을 입혀서 움직이는 영상으로 만들어 줘”라고 요청하는 것과, 실제 피부 분석, 가상 체험, 이미지 및 동영상 생성 API를 호출해 결과물을 만드는 것은 전혀 다른 문제입니다.

기존에는 AI 에이전트에서 이러한 기능을 사용하려면 개발자가 직접 API 인증을 처리하고, 엔드포인트와 파라미터를 연결하고, 비동기 작업을 생성하고, 결과를 polling하는 코드를 작성해야 했습니다.

이제 YouCam API는 이러한 개발 과정을 AI 에이전트 환경에 맞게 간소화할 수 있도록 MCP(Model Context Protocol)와 에이전트 스킬을 제공합니다. MCP를 사용하면 개별 YouCam API를 AI 에이전트의 도구로 직접 연결할 수 있고, Agent Skills를 사용하면 여러 API를 조합한 사전 제작 워크플로우를 바로 실행할 수 있습니다.

Claude Code, Claude Desktop, Cursor, Codex 등 AI 에이전트 환경에서 자연어로 작업을 요청하면 에이전트가 필요한 YouCam API를 선택하고, 필요한 입력을 확인한 뒤 실제 AI 분석이나 가상 체험을 실행해 구조화된 결과와 비주얼 결과물을 반환하는 방식입니다.

MCP와 Agent Skills는 무엇이 다른가?

YouCam API를 AI 에이전트에 연결하는 방법은 크게 두 가지입니다. MCP를 이용해 필요한 API를 직접 도구로 연결하거나, 여러 API가 이미 조합된 Agent Skills를 설치해 특정 활용 사례를 바로 실행할 수 있습니다.

즉, MCP는 “YouCam API를 에이전트의 도구로 연결하는 방법”에 가깝고, Agent Skills는 “특정 작업을 수행하도록 만들어진 실행 가능한 워크플로우”에 가깝습니다.

개발자는 원하는 수준의 제어권에 따라 MCP를 직접 연결할 수도 있고, 빠른 구현이 필요하다면 사전 제작된 Agent Skills를 사용할 수도 있습니다.

왜 YouCam API를 AI 에이전트에 연결해야 할까?

일반적인 LLM은 이미지에 대해 설명하거나 추천을 생성할 수 있지만, 전문적인 피부 분석이나 실제 상품을 얼굴 및 신체에 적용한 가상 체험 결과를 직접 생성하는 데는 별도의 비주얼 AI가 필요합니다.

YouCam API를 AI 에이전트의 도구로 연결하면 이 과정을 하나의 자연어 인터페이스 안에서 구성할 수 있습니다.

• 피부 분석: 사용자의 사진을 기반으로 피부 고민과 피부 타입을 분석
• 얼굴 분석: 피부 톤, 얼굴 특징 및 비율 등 분석
• 메이크업: 추천한 메이크업 룩을 실제 사진에 적용
• 헤어: 얼굴 특징을 기반으로 헤어스타일과 컬러를 추천하고 미리보기 생성
• 패션: 의류를 가상 착용하고 다양한 포즈나 모션 결과 생성
• 이미지 및 동영상: AI 이미지 및 동영상 생성·편집 워크플로우 구성

따라서 AI 에이전트가 단순히 “이 스타일이 잘 어울립니다”라고 텍스트로 답하는 수준에서 끝나는 것이 아니라, 분석 → 추천 → 생성 → 결과 확인까지 이어지는 비주얼 워크플로우를 실행할 수 있습니다.

MCP로 YouCam API 연결하기

MCP(Model Context Protocol)는 AI 에이전트가 외부 도구와 데이터에 표준화된 방식으로 연결될 수 있도록 하는 프로토콜입니다.

YouCam API는 MCP를 통해 AI 에이전트에서 사용할 수 있도록 3개의 전문 MCP 서버를 제공합니다. 개발자는 필요한 도메인의 MCP 서버만 선택해 연결하거나, 동일한 YouCam API 키를 사용해 여러 서버를 함께 사용할 수 있습니다.

• Beauty & Personal Care: 피부 분석, 메이크업, 얼굴 분석, 헤어스타일, 헤어 컬러 등
• Fashion & Retail: 의류 가상 착용, 배경 변경, 주얼리 및 시계 가상 착용 등
• Image & Video: 이미지와 동영상 생성 및 편집

연결 과정도 간단합니다.

1. MCP 클라이언트에서 사용할 YouCam MCP 서버를 선택합니다.
2. MCP 설정에 서버 구성을 추가합니다.
3. YouCam API 키를 Bearer 인증 방식으로 설정합니다.
4. AI 에이전트에서 자연어로 작업을 요청합니다.

설정이 완료되면 에이전트가 사용자의 자연어 요청을 해석하고 적절한 YouCam API 도구를 선택해 호출할 수 있습니다. 공식 MCP 구성 예시와 연결 방법은 YouCam API MCP & Agent Skills 페이지에서 확인할 수 있습니다.

6가지 YouCam Agent Skills 살펴보기

MCP가 개별 API를 연결하는 방식이라면, Agent Skills는 실제 사용 시나리오를 중심으로 여러 API 호출과 실행 로직을 패키징한 형태입니다.

현재 YouCam Skills에는 뷰티, 피부, 헤어, 패션 분야를 위한 6가지 Agent Skills가 제공됩니다.

1. Skin Analysis Expert

셀피 한 장을 기반으로 피부 고민과 피부 타입을 분석합니다. HD/SD 상세 수준을 선택할 수 있으며, 분석 결과를 오버레이 또는 마스크 형태로 시각화할 수도 있습니다.

개발자는 이를 피부 상담, 스킨케어 추천, 온라인 피부 테스트 등의 에이전트 워크플로우에 활용할 수 있습니다.

2. Facial Consultant

피부 톤뿐 아니라 눈, 눈썹, 입술, 헤어 컬러와 얼굴 특징 및 비율 등을 분석합니다. 얼굴형이나 비율 분석을 기반으로 한 개인화 스타일 추천을 구현할 때 유용합니다.

3. Beauty Advisor

얼굴형과 피부 톤을 기반으로 메이크업 룩을 추천하고, 추천 결과를 실제 사용자 사진에 렌더링합니다.

따라서 “어떤 메이크업이 어울릴까?”라는 질문에 텍스트 추천만 제공하는 대신, 추천 → 가상 메이크업 → 결과 이미지로 이어지는 경험을 만들 수 있습니다.

4. Hair Color & Style Advisor

사용자의 얼굴 특징을 바탕으로 헤어스타일과 헤어 컬러를 추천하고 결과를 미리 볼 수 있도록 렌더링합니다. 템플릿뿐 아니라 참조 이미지, 컬러 프리셋, 커스텀 팔레트 등을 활용할 수 있습니다.

5. Hair Diagnostics

모발 밀도, 모발 타입, 곱슬 정도, 모발 길이 등을 분석해 하나의 리포트로 구성합니다.

헤어케어 제품 추천이나 상담 서비스에서 분석 결과를 다음 단계의 상품 추천 로직으로 전달하는 데 활용할 수 있습니다.

6. Clothes Try-on Studio

사용자의 사진에 의상을 가상으로 착용하고, 선택에 따라 배경 변경이나 회전, 런웨이 워크, 포즈 등의 짧은 모션 영상도 생성할 수 있습니다.

패션 이커머스의 가상 피팅룸뿐 아니라 AI 스타일리스트, 룩북 생성, 상품 콘텐츠 제작 등의 에이전트 워크플로우에도 활용할 수 있습니다.

Agent Skill은 실제로 어떻게 실행될까?

개발자 입장에서 Agent Skill의 핵심은 단순히 API 문서를 자연어로 감싼 것이 아니라는 점입니다. 각 스킬은 실제 API 호출에 필요한 실행 과정을 처리하도록 구성되어 있습니다.

일반적인 실행 흐름은 다음과 같습니다.

1. Natural Language Request: 사용자가 자연어로 원하는 결과를 요청합니다.
2. Skill Selection: AI 에이전트가 적절한 YouCam Skill을 선택합니다.
3. Input Collection: 사진이나 참조 이미지 등 필요한 입력을 확인합니다.
4. Cost Check: API 실행 전에 필요한 크레딧 비용을 확인하거나 추정합니다.
5. Media Upload: 필요한 미디어를 YouCam API에 업로드합니다.
6. Task Creation: API 작업을 생성합니다.
7. Polling: 작업이 완료될 때까지 상태를 확인합니다.
8. Result Reporting: 구조화된 JSON 결과를 반환하고 사람이 이해하기 쉬운 형태로 요약합니다.

즉, 개발자가 매번 파일 업로드 → API task 생성 → polling → 결과 처리 로직을 처음부터 작성하지 않아도 됩니다. 이러한 실행 과정이 Skill 내부에서 처리됩니다.

개발자가 주목해야 할 핵심 기능

자연어가 API의 새로운 인터페이스가 됩니다

기존 API 통합에서는 개발자가 엔드포인트와 파라미터를 알고 있어야 했습니다. Agent Skills를 사용하면 사용자는 “내 피부를 분석해 줘”, “이 사진에 이 옷을 입혀 줘”처럼 결과 중심으로 요청할 수 있습니다.

에이전트는 필요한 입력을 확인하고 적절한 Skill을 실행합니다.

API 호출 전 비용을 확인할 수 있습니다

AI 에이전트가 자동으로 유료 API를 호출하는 환경에서는 비용 관리가 중요합니다. YouCam Skills는 API 실행 전에 비용을 확인하거나 추정할 수 있는 구조를 제공하며, CLI에서도 비용과 크레딧을 확인할 수 있습니다.

python scripts/youcam_core.py cost --feature skin-analysis
python scripts/youcam_core.py credits

두 명령은 무료로 가격 또는 잔여 크레딧 정보를 확인할 수 있어, 실제 API 실행 전에 사용자가 비용을 확인하도록 하는 credit-aware workflow를 구축하는 데 활용할 수 있습니다.

Agent 환경뿐 아니라 CLI에서도 테스트할 수 있습니다

Agent Skills는 AI 에이전트에서만 실행되는 블랙박스가 아닙니다. CLI를 통해 개별 Skill을 직접 테스트하거나 자동화 워크플로에 사용할 수도 있습니다.

python scripts/youcam_core.py run \
  --feature skin-analysis \
  --src_file selfie.jpg \
  --param format=json \
  --param dst_actions='["hd_pore","hd_skin_type"]'

이 명령은 소스 이미지를 업로드하고 API task를 생성한 뒤 완료될 때까지 polling하고 구조화된 JSON 결과를 출력합니다.

API 키는 환경 변수로 관리할 수 있습니다

개발 환경에서는 API 키를 코드에 하드코딩하기보다 환경 변수 등을 이용해 관리하는 것이 일반적입니다. YouCam Skills는 YOUCAM_API_KEY 환경 변수를 통한 인증을 지원합니다.

YOUCAM_API_KEY=your_key_here

또한 Skill 폴더의 credentials.json을 통한 로컬 설정도 지원합니다.

Agent Skill 설치하기

현재 공식 YouCam Skills 저장소에서는 Skills CLI를 이용해 필요한 스킬을 설치할 수 있습니다.

npx skills add YouCam-API/skills

특정 스킬과 에이전트를 바로 지정하고 싶다면 다음과 같이 사용할 수 있습니다.

npx skills add YouCam-API/skills --skill skin-analysis-expert -a claude-code

전체 스킬을 설치하려면 다음 명령을 사용할 수 있습니다.

npx skills add YouCam-API/skills --all

현재 공식 저장소에는 6개의 Agent Skill이 포함되어 있으며, 설치 과정에서 필요한 스킬과 사용할 에이전트를 선택할 수 있습니다.

직접 API 연동 vs. MCP vs. Agent Skills

기존 애플리케이션에 YouCam API를 직접 통합해야 한다면 기존 API 방식을 그대로 사용할 수 있습니다. 반면 AI 에이전트를 중심으로 제품이나 개발 환경을 구축한다면 MCP와 Agent Skills를 활용하는 것이 더 자연스러운 개발 방식이 될 수 있습니다.

AI 에이전트로 만들 수 있는 실제 워크플로우

뷰티 쇼핑 어시스턴트

사용자가 셀피를 업로드하고 “나에게 어울리는 립 컬러를 추천해 줘”라고 요청하면, 에이전트가 얼굴 및 피부 정보를 분석하고 메이크업 룩을 추천한 뒤 가상 메이크업 결과를 생성하도록 구성할 수 있습니다.

스킨케어 상담 에이전트

피부 분석 결과를 기반으로 사용자의 주요 피부 고민을 파악하고, 이후 스킨케어 제품 추천이나 상담 플로우로 연결할 수 있습니다.

AI 패션 스타일리스트

사용자의 사진과 상품 이미지를 입력받아 의류 가상 착용을 실행하고, 여러 상품을 조합해 스타일링 결과를 생성하는 에이전트를 구축할 수 있습니다.

크리에이티브 제작 에이전트

제품 이미지를 기반으로 배경 변경, 이미지 생성, 동영상 생성 등의 API를 연결해 광고 소재나 소셜 콘텐츠 제작을 자동화할 수도 있습니다.

이처럼 YouCam API를 MCP 또는 Agent Skills와 연결하면 단일 AI 기능을 호출하는 것을 넘어 여러 비주얼 AI 기능을 하나의 에이전트 워크플로로 조합할 수 있습니다.

하나의 API 키로 확장되는 비주얼 AI

YouCam API는 AI 에이전트 환경에서 다양한 비주얼 AI 기능을 하나의 개발자 플랫폼으로 연결할 수 있도록 구성되어 있습니다.

• 3개 전문 MCP 서버
• 6개 사전 제작 Agent Skills
• 14개 Agent Skills를 구동하는 YouCam API
• 1개 통합 API 키

또한 MCP와 Agent Skills에서도 기존 YouCam API 키와 API 요금제를 사용할 수 있으며, MCP 또는 Agent Skills 사용 자체에 별도의 추가 비용은 없습니다.

따라서 개발자는 새로운 에이전트 기능을 추가할 때마다 별도의 AI 비주얼 엔진을 구축하기보다, 기존 YouCam API를 필요한 방식으로 에이전트 환경에 연결해 확장할 수 있습니다.

YouCam API를 AI 에이전트에 연결하는 방법

가장 빠른 시작 방법은 사용 목적에 따라 MCP와 Agent Skills 중 하나를 선택하는 것입니다.

1. 커스텀 AI 에이전트: 필요한 YouCam API를 직접 선택해야 한다면 MCP를 사용하세요.
2. 특정 활용 사례를 빠르게 구현: 피부 분석, 메이크업, 헤어, 의류 가상 착용 등의 워크플로가 필요하다면 Agent Skills를 사용하세요.
3. 기존 애플리케이션: 에이전트가 아닌 자체 웹/앱 기능에 API를 통합한다면 기존 YouCam API 방식으로 직접 연동할 수 있습니다.

API 키를 발급한 후 MCP 설정을 추가하거나 필요한 Agent Skill을 설치하면 됩니다. YouCam Skills는 CLI를 통한 테스트도 지원하기 때문에 실제 에이전트에 연결하기 전에 API 호출과 결과를 별도로 검증할 수도 있습니다.

YouCam API MCP & Agent Skills 페이지에서 MCP 서버 구성, 지원 기능 및 AI 에이전트 활용 사례를 확인해 보세요.

Claude Code와 Codex에서 YouCam API를 직접 활용해 보세요

AI 에이전트가 텍스트만 생성하는 시대에서, 실제 분석 결과와 가상 체험 이미지, 생성된 이미지 및 동영상을 실행하는 시대로 넘어가고 있습니다.

YouCam API는 이러한 변화에 맞춰 MCP를 통해 개별 비주얼 AI API를 연결하거나, Agent Skills를 통해 완성된 활용 사례를 바로 실행할 수 있도록 지원합니다.

기존 API를 직접 연동하는 개발 방식도 그대로 사용할 수 있지만, AI 에이전트 기반의 새로운 제품과 워크플로를 구축하고 있다면 MCP와 Agent Skills를 통해 YouCam API의 비주얼 AI 기능을 더욱 빠르게 연결해 볼 수 있습니다.

MCP 및 Agent Skills로 YouCam API 시작하기에서 연결 방법을 확인하고, YouCam Skills 개발자 문서에서 설치와 CLI 실행 방법을 살펴보세요.

MCP 및 AI 에이전트 스킬 자주 묻는 질문