# 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/](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


```json
{
  "mcpServers": {
    "youcam-beauty": {
      "url": "https://mcp-api-01.makeupar.com/mcp/beauty",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

* YouCam for Fashion & Retail


```json
{
  "mcpServers": {
    "youcam-fashion": {
      "url": "https://mcp-api-01.makeupar.com/mcp/fashion",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

* YouCam for Creators


```json
{
  "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](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) をダウンロードしてインストールします。
2. Settings → Developer → Edit config → claude_desktop_config.json ファイルを開きます
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/claude_mcp_config1_8142d700d0.png)
3. `mcpServers` セクションを更新します
4. `YOUR_API_KEY` の部分を実際の API キーに置き換えます


```json
{
  "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 を開きます
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/cursor_mcp_config2_9f31015370.png)
2. mcp.json ファイルに設定を追加します


```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`
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/vscode_mcp_setting1_b1f041a72a.png)
2. `HTTP` を選択します
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/vscode_mcp_setting2_e1d82b494c.png)
3. サーバーの URL を入力します
4. MCP サーバーの名前を指定します
5. ヘッダー設定: API トークンを入力します


**Copilot in VS Code オプション 2:**

1. `> MCP: Open User Configuration`
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/vscode_config_img_34fe410c06.png)
2. youcam-beauty の設定を `mcp.json` に更新します


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


```json
{
  "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

YouCam for Fashion & Retail には、ファッション、アクセサリー、スタイリングのアプリケーション向けの以下の API ツールが含まれています:

* YouCam for Fashion & Retail


```json
{
  "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

YouCam for Creators で利用可能な以下の AI ツールは、主な機能別にグループ化されています:

* YouCam for Creators


```json
{
  "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` & `_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 機能のユニット消費量/コスト単価を確認します。 |