Model Context Protocol (MCP) は、軽量な JSON ベースのラッパーであり、クライアントアプリケーション(Cursor、Copilot in VS Code、Claude for Desktop など)が、低レベルの HTTP の細部を扱うことなく YouCam AI サービスを呼び出せるようにします。
主な利点: MCP 設定 JSON ファイルに 1 つのエントリを追加し、YouCam の API キーを指定するだけで、MCP 互換のクライアント(Cursor、Copilot in VS Code、Claude for Desktop)から YouCam AI サービス(肌診断、衣服のバーチャル試着、ヘアスタイリングなど)を使用できます。クライアントがリクエストのフォーマット、認証、ポーリングを処理するため、追加のコードは不要です。
- MCP 互換のクライアントがインストールされていること(Claude Desktop、Codex、Cursor、Copilot in VS Code など)。
- YouCam MCP サーバーへのネットワークアクセス(サーバーは 3 つのカテゴリがあります):
https://mcp-api-01.makeupar.com/mcp/beautyhttps://mcp-api-01.makeupar.com/mcp/fashionhttps://mcp-api-01.makeupar.com/mcp/creators
- 有効な YouCam API キー(次のセクションを参照)。
クライアント自体がリクエスト/レスポンスのシリアライズとポーリングロジックをすでに実装しているため、開発者が追加のコードを用意する必要はありません。
- API キーコンソールに移動します: https://yce.perfectcorp.com/api-console/en/api-keys/
- 新しいキーを作成するか、既存のキーをコピーします。
- キーを安全な方法で保存します(環境変数、シークレットマネージャーなど)。
環境変数の例(デプロイ環境に合わせて調整してください):
YOUR_API_KEY=your‑api‑key
MCP クライアントは mcp.json という名前の JSON 設定ファイルを読み込みます。以下のように YouCam MCP サーバーのエントリを追加してください:
- YouCam for Beauty & Skin Care
{
"mcpServers": {
"youcam-beauty": {
"url": "https://mcp-api-01.makeupar.com/mcp/beauty",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}- YouCam for Fashion & Retail
{
"mcpServers": {
"youcam-fashion": {
"url": "https://mcp-api-01.makeupar.com/mcp/fashion",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}- YouCam for Creators
{
"mcpServers": {
"youcam-creators": {
"url": "https://mcp-api-01.makeupar.com/mcp/creators",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}設定手順
| 手順 | 操作 |
|---|---|
| 1. MCP 設定 JSON ファイルのセットアップ | ファイルをプロジェクトのルート、またはクライアント固有の設定ディレクトリに配置します(各クライアントのドキュメントを参照してください)。 |
| 2. プレースホルダーの置換 | YOUR_API_KEY をセクション 2 で取得した値に置き換えるか、クライアントが対応している場合は環境変数を参照します(${YOUR_API_KEY})。 |
| 3. 接続性の確認 | クライアントの UI を開き、「YouCam API MCP」が選択可能なサービスとして表示されることを確認します。 |
設定は静的なため、キーを変更した場合はクライアントの再読み込みが必要です。
主要な MCP 対応クライアントとの統合
Node.js と npm をダウンロードしてインストールします。
Settings → Developer → Edit config → claude_desktop_config.json ファイルを開きます

mcpServersセクションを更新しますYOUR_API_KEYの部分を実際の API キーに置き換えます
{
"mcpServers": {
"youcam-beauty": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp-api-01.makeupar.com/mcp/beauty",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer YOUR_API_KEY"
}
}
}
}- File → Exit を選択して Claude Desktop アプリを再起動します
Settings → Tools & MCP → Add Custom MCP を開きます

mcp.json ファイルに設定を追加します
{
"mcpServers": {
"youcam-beauty": {
"url": "https://mcp-api-01.makeupar.com/mcp/beauty",
"type": "http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Cursor Settings → Tools & MCP に移動します
「Installed MCP Servers」セクションで、必要なツールを有効または無効にします
Copilot in VS Code オプション 1:
> MCP: Add Server
HTTPを選択します
サーバーの URL を入力します
MCP サーバーの名前を指定します
ヘッダー設定: API トークンを入力します
Copilot in VS Code オプション 2:
> MCP: Open User Configuration
youcam-beauty の設定を
mcp.jsonに更新します
{
"servers": {
"youcam-beauty": {
"url": "https://mcp-api-01.makeupar.com/mcp/beauty",
"type": "http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}YouCam for Beauty & Skin Care には、メイクアップ、スキンケア解析、顔の補正、外見の変換に使用できる以下のツールが含まれています:
- YouCam for Beauty & Skin Care
{
"mcpServers": {
"youcam-beauty": {
"url": "https://mcp-api-01.makeupar.com/mcp/beauty",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}| ツール名 | 説明 |
|---|---|
AI_Skin_Analysis | シワ、毛穴、ニキビ、皮脂のべたつき、クマ、きめ、うるおいなどの肌の悩みを評価します(HD モードと SD モード)。 |
AI_Skin_simulation | 最大 10 種類の肌の悩み(つや、ニキビ、シミなど)について、ケアの前後の進行状況を可視化します。 |
AI_Facial_Color_Tones_Analyzer | 顔の肌色、目の色、眉毛の色、唇の色、髪の色を検出します。 |
AI_Aging_Simulation | 1 枚の自撮り写真をもとに、若い頃から老年期までの姿を示す一連の写真を生成します。 |
AI_Face_Attributes_and_Ratio_Analyzer | 顔の構造、パーツ(目、眉、唇、鼻、頬骨)、黄金比の比率を解析します。 |
AI_Face_Lift | AI によるフェイス補正で、目の下のたるみ、頬、額、顔の形、口元を調整します。 |
AI_Face_Reshape | 目、鼻、唇、フェイスライン、あご、顔全体の構造をピクセル単位で精密に調整できます。 |
AI_Fitzpatrick_Skin_Type_Analysis | メラニン量と UV への反応に基づき、肌を 6 種類のフィッツパトリックタイプに分類します。 |
AI_Smile | 無表情や悲しい表情を、自然な笑顔(歯が見える笑顔・見えない笑顔)に変換します。 |
AI_Teeth_Whitening | 歯を自動的に検出して明るくし、ホワイトニングの強度を調整できます。 |
| ツール名 | 説明 |
|---|---|
AI_Hair_Style_Virtual_Try_On | テンプレートや参照画像を使って、さまざまなヘアスタイル(カール、ロング、刈り上げなど)をバーチャルに試せます。 |
AI_Hair_Type_Detection | 髪の質感、太さ、カールの形状を、明確に定義された 9 タイプで解析します。 |
AI_Hair_Volume_Virtual_Try_On | 写真内の細毛や薄毛にボリュームを追加します。 |
AI_Bangs_Filter_Virtual_Try_On | さまざまな前髪スタイルをバーチャルで試し、最も顔に似合う前髪を確認できます。 |
AI_Hair_Color_Virtual_Try_On | プリセットまたはカスタムパレット(全体モード/オンブレモード)を使って髪の色を変更します。 |
AI_Wavy_Hair_Virtual_Try_On | ウェーブ、カール、リングレットのヘアスタイルをバーチャルに試せます。 |
AI_Hair_Density_Detection | 地肌の見え方に基づいて、髪の密度を 4 レベルで評価・分類します。 |
AI_Hair_Extension_Virtual_Try_On | ロングからエクストラロングまでのヘアエクステンションを、自然に馴染む形でバーチャルに試せます。 |
AI_Hair_Frizziness_Detection | 正面・左・右の方向から撮影した写真を使い、髪の広がりレベルを解析します。 |
AI_Hair_Length_Detection | 髪の長さを測定し、5 つの明確なステージに分類します。 |
| ツール名 | 説明 |
|---|---|
AI_Abs_Filter | 全身/上半身の写真に、リアルな six-pack または vest-line の腹筋のくっきりした輪郭を追加します。 |
AI_Body_Reshape | ウエスト、腕、太もも、胸、身長などのボディプロポーションをスリム化・シェイプ・改善します。 |
AI_Breast_Augmentation_Simulator | 侵襲なく AI でバストラインの改善を可視化し、強度を調整できます。 |
| ツール名 | 説明 |
|---|---|
AI_Makeup_Virtual_Try_On | ファンデーション、チーク、アイシャドウ、リップなどのメイクを写真に適用します。 |
AI_Makeup_Transfer | 参照写真のメイク全体の雰囲気を、対象の自撮り写真に転送します。 |
AI_Nail_Virtual_Try_On | ネイルポリッシュの色、質感、デザイン、付け爪をネイルバーチャル試着で試せます。 |
AI_Eye_Color_Lens_Virtual_Try_On | コンタクトレンズ/瞳の色のバーチャルシミュレーションです。不透明度とブレンドを調整できます。 |
AI_Look_Virtual_Try_On | ビューティー/フェイシャルのルックをテンプレート経由で適用します。 |
AI_Beard_Style_Generator | さまざまなメンズのヒゲスタイル(無精ヒゲ、フルヒゲ、山羊ヒゲ、口ヒゲなど)をバーチャルに試せます。 |
| ツール名 | 説明 |
|---|---|
*_Templates | 前髪、ヒゲ、ヘアエクステンション、ヘアスタイル、ボリュームアップ、ルックのプリセットテンプレートを一覧表示します。 |
*_Detection | 一部のシェイプ/リフト/ホワイトニング API の前に必要な検出・前処理タスクを実行します。 |
File_Upload | ブラウザから画像/動画を直接アップロードできる、インタラクティブなドラッグ&ドロップウィジェットです。 |
Get_Running_Task_Status | これまでに開始した AI 処理タスクのステータスを確認し、結果を取得します。 |
Get_Upload_API_Info | 特定のタスクタイプに対するアップロード API のエンドポイントと、リクエスト/レスポンスの例を返します。 |
Get_Feature_Cost | 各 YouCam API 機能のユニット消費量/コスト単価を確認します。 |
YouCam for Fashion & Retail には、ファッション、アクセサリー、スタイリングのアプリケーション向けの以下の API ツールが含まれています:
- YouCam for Fashion & Retail
{
"mcpServers": {
"youcam-fashion": {
"url": "https://mcp-api-01.makeupar.com/mcp/fashion",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}| ツール名 | 説明 |
|---|---|
AI_Clothes_Virtual_Try_On | 服装を写真に重ね合わせます。全身、上半身/下半身、靴、アウター、自動検出に対応しています。 |
AI_Fabric_Virtual_Try_On | プリセットテンプレート(シルク、大胆なパターンなど)を使って、リアルな生地の質感やプリントを画像に適用します。 |
AI_Fabric_Virtual_Try_On_Templates | Fabric VTO ツールで利用可能な、すべてのプリセット生地质感/スタイルテンプレートを一覧表示します。 |
| ツール名 | 説明 |
|---|---|
AI_Shoes_Virtual_Try_On | 靴のバーチャル試着です。gender パラメータの明示的な指定が必要です。 |
| ツール名 | 説明 |
|---|---|
AI_Hat_Virtual_Try_On | ハット、キャップ、ヘアバンドのバーチャル試着です。gender パラメータの明示的な指定が必要です。 |
AI_Scarf_Virtual_Try_On | 服装の上でのスカーフの自然な垂れ下がり、折り目、柄の流れをシミュレートします。gender パラメータの明示的な指定が必要です。 |
| ツール名 | 説明 |
|---|---|
AI_Bracelet_Virtual_Try_On | 1 枚の 2D 画像から、配置、影、ライティングを調整できる AI によるブレスレット試着です。 |
AI_Earrings_Virtual_Try_On | イヤリングのバーチャル試着です。耳の左右選択、ライティング、遮蔽処理に対応しています。 |
AI_Necklace_Virtual_Try_On | ネックレスのバーチャル試着です。首/鎖骨のトラッキングに対応しています。 |
AI_Ring_Virtual_Try_On | リング/婚約指輪のバーチャル試着です。指の選択、位置合わせ、影/ライティングに対応しています。 |
AI_Watch_Virtual_Try_On | ウォッチのバーチャル試着です。ストラップの位置合わせと手首への配置に対応しています。 |
AI_Bag_Virtual_Try_On | バッグのバーチャル試着です。ストラップの長さと服装との合わせに対応しています。gender パラメータの明示的な指定が必要です。 |
| ツール名 | 説明 |
|---|---|
File_Upload | ブラウザから画像/動画を直接アップロードできる、インタラクティブなドラッグ&ドロップウィジェットです。 |
Get_Running_Task_Status | これまでに開始した AI 処理タスクのステータスを確認し、結果を取得します。 |
Get_Upload_API_Info | 特定のタスクタイプに対するアップロード API のエンドポイントと、リクエスト/レスポンスの例を返します。 |
Get_Feature_Cost | 各 YouCam API 機能のユニット消費量/コスト単価を確認します。 |
YouCam for Creators で利用可能な以下の AI ツールは、主な機能別にグループ化されています:
- YouCam for Creators
{
"mcpServers": {
"youcam-creators": {
"url": "https://mcp-api-01.makeupar.com/mcp/creators",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}| ツール名 | 説明 |
|---|---|
AI_Image_Generator_Text_to_Image | テキストプロンプトから画像を生成します。スタイル/サイズの調整とプロンプト書き換えに対応しています。 |
AI_Image_Generator_Image_to_Image | テキスト指示に加え、ポーズ/スタイルの指針として最大 3 枚の参照画像を使って、既存の画像を変換・編集します。 |
AI_Photo_Colorize | モノクロや色あせた写真をカラー化します。暖色から寒色までの 4 つのバージョンを出力します。 |
AI_Color_Correction | 彩度、色温度、色相、露出、肌色を自動調整し、4 つのバリエーションを出力します。 |
AI_Photo_Enhance | 解像度を拡大(1x/2x/4x)し、ブレを補正し、画質劣化を除去します。 |
AI_Photo_Lighting | 明るさを調整します。暗部の復元と露出の調整を行います。 |
AI_Image_Extender | スタイルと品質を維持したまま、画像をカスタム比率へ拡張するアウトペインティングです。 |
| ツール名 | 説明 |
|---|---|
AI_Photo_Background_Removal | 人物、商品、動物、車などの被写体分離に対応します。 |
AI_Photo_Background_Blur | 被写体を際立たせる自然なボケ/背景ぼかしを適用します。強度は調整可能(0–100)。 |
AI_Photo_Background_Change & _Templates | 被写体分離の後、カスタムのテキストプロンプトまたはプリセットの風景テンプレートを使って背景を置換します。 |
AI_Video_Background_Replace | 参照画像/動画を使って動画の背景を置換します。クロップ/ストレッチのフィットモードに対応しています。 |
| ツール名 | 説明 |
|---|---|
AI_Avatar_Generator & _Templates | 顔の特徴を学習し、アーティスティック/スタイライズされたテンプレートを適用する、画像から画像へのアバター生成です。 |
AI_Studio_Generator & _Templates | カジュアルな自撮り写真をプロの人物写真に変換します。 |
AI_Headshot_Generator & _Templates | AI スタイリングテンプレートを使い、標準的な写真からヘッドショットを生成します。 |
| ツール名 | 説明 |
|---|---|
AI_Face_Swap & AI_Face_Swap_Face_Detection | 写真の顔入れ替えです。複数の顔、カスタムマッピング、スキップロジックに対応しています。 |
AI_Video_Face_Swap | 動画の顔入れ替えです。適応的ライティング、表情トラッキング、肌色ブレンドに対応しています。 |
AI_Object_Removal_Pro | グレースケールマスクを使って物体や人物を除去します。 |
AI_Video_Object_Removal | 参照マスクフレームを使い、動画内の物体を除去します。 |
AI_Replace | マスク領域を除去し、カスタムプロンプトに基づいて新しい物体/テクスチャを生成する AI インペインティングです。 |
| ツール名 | 説明 |
|---|---|
AI_Video_Generator_Text_to_Video | 解像度、アスペクト比、再生時間、ネガティブプロンプトを調整して、テキストプロンプトから動的な動画を作成します。 |
AI_Video_Generator_Image_to_Video | モーションプロンプトとテンプレートを使い、静止画を動画にアニメーション化します。 |
AI_Video_Enhancer | ブレを補正し、露出/明るさを調整し、ノイズを低減し、低解像度の映像を HD に拡大します。 |
AI_Video_Style_Transfer & _Templates | フィルター(ポップアート、レトロ、アニメなど)をフレームごとに適用します。 |
| ツール名 | 説明 |
|---|---|
File_Upload | ブラウザから画像/動画を直接アップロードできる、インタラクティブなドラッグ&ドロップウィジェットです。 |
Get_Running_Task_Status | これまでに開始した AI 処理タスクのステータスを確認し、結果を取得します。 |
Get_Upload_API_Info | 特定のタスクタイプに対するアップロード API のエンドポイントと、リクエスト/レスポンスの例を返します。 |
Get_Feature_Cost | 各 YouCam API 機能のユニット消費量/コスト単価を確認します。 |