コンテンツへスキップ
最終更新

MCP

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 サービス(肌診断、衣服のバーチャル試着、ヘアスタイリングなど)を使用できます。クライアントがリクエストのフォーマット、認証、ポーリングを処理するため、追加のコードは不要です。

統合ガイド

1. 前提条件

  • MCP 互換のクライアントがインストールされていること(Claude Desktop、Codex、Cursor、Copilot in VS Code など)。
  • YouCam MCP サーバーへのネットワークアクセス(サーバーは 3 つのカテゴリがあります):
    • https://mcp-api-01.makeupar.com/mcp/beauty
    • https://mcp-api-01.makeupar.com/mcp/fashion
    • https://mcp-api-01.makeupar.com/mcp/creators
  • 有効な YouCam API キー(次のセクションを参照)。

クライアント自体がリクエスト/レスポンスのシリアライズとポーリングロジックをすでに実装しているため、開発者が追加のコードを用意する必要はありません。

2. API キーの取得

  1. API キーコンソールに移動します: https://yce.perfectcorp.com/api-console/en/api-keys/
  2. 新しいキーを作成するか、既存のキーをコピーします。
  3. キーを安全な方法で保存します(環境変数、シークレットマネージャーなど)。

環境変数の例(デプロイ環境に合わせて調整してください): YOUR_API_KEY=your‑api‑key

3. MCP 設定 JSON ファイルの設定

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 クライアントの設定

主要な MCP 対応クライアントとの統合

Claude Desktop

  1. Node.js と npm をダウンロードしてインストールします。

  2. Settings → Developer → Edit config → claude_desktop_config.json ファイルを開きます

  3. mcpServers セクションを更新します

  4. 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"
      }
    }
  }
}
  1. File → Exit を選択して Claude Desktop アプリを再起動します

Cursor

  1. Settings → Tools & MCP → Add Custom MCP を開きます

  2. mcp.json ファイルに設定を追加します

{
  "mcpServers": {
    "youcam-beauty": {
      "url": "https://mcp-api-01.makeupar.com/mcp/beauty",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
  1. Cursor Settings → Tools & MCP に移動します

  2. 「Installed MCP Servers」セクションで、必要なツールを有効または無効にします


Copilot in VS Code (Visual Studio Code)

Copilot in VS Code オプション 1:

  1. > MCP: Add Server

  2. HTTP を選択します

  3. サーバーの URL を入力します

  4. MCP サーバーの名前を指定します

  5. ヘッダー設定: API トークンを入力します

Copilot in VS Code オプション 2:

  1. > MCP: Open User Configuration

  2. youcam-beauty の設定を mcp.json に更新します

{
    "servers": {
        "youcam-beauty": {
            "url": "https://mcp-api-01.makeupar.com/mcp/beauty",
            "type": "http",
            "headers": {
                "Authorization": "Bearer YOUR_API_KEY"
            }
        }
    }
}

MCP の機能

YouCam for Beauty & Skin Care

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_Simulation1 枚の自撮り写真をもとに、若い頃から老年期までの姿を示す一連の写真を生成します。
AI_Face_Attributes_and_Ratio_Analyzer顔の構造、パーツ(目、眉、唇、鼻、頬骨)、黄金比の比率を解析します。
AI_Face_LiftAI によるフェイス補正で、目の下のたるみ、頬、額、顔の形、口元を調整します。
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

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_TemplatesFabric VTO ツールで利用可能な、すべてのプリセット生地质感/スタイルテンプレートを一覧表示します。

靴

ツール名説明
AI_Shoes_Virtual_Try_On靴のバーチャル試着です。gender パラメータの明示的な指定が必要です。

ハットとスカーフ

ツール名説明
AI_Hat_Virtual_Try_Onハット、キャップ、ヘアバンドのバーチャル試着です。gender パラメータの明示的な指定が必要です。
AI_Scarf_Virtual_Try_On服装の上でのスカーフの自然な垂れ下がり、折り目、柄の流れをシミュレートします。gender パラメータの明示的な指定が必要です。

ジュエリーとアクセサリー

ツール名説明
AI_Bracelet_Virtual_Try_On1 枚の 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

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 画像生成と画質改善

ツール名説明
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 & _TemplatesAI スタイリングテンプレートを使い、標準的な写真からヘッドショットを生成します。

顔入れ替えと物体編集

ツール名説明
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 機能のユニット消費量/コスト単価を確認します。