# App Groups

## App Groupsとは？

App Groupsは、MCPアプリ統合をテーマ別のコレクションにまとめるワークフローバンドルです。スマートフォンのフォルダのように、関連するアプリをグループ化し、エージェントが連携したツールキットとして使用します。

例えば、Salesforce、HubSpot、Gmail、Google Calendarで「営業」グループを作成したり、GitHub、Jira、Docker Hub、Slackで「DevOps」グループを作成できます。

## App Groupの作成

### ステップ1：グループの設定

グループに名前を付け、色（8つのプリセットオプション）を選択し、絵文字アイコンを選びます。オプションで**ワークフローメモリ**を有効にすると、グループ内のすべてのアプリ間で共有コンテキストを維持できます。

### ステップ2：アプリの選択

1200以上の利用可能なMCPアプリから選択します。各アプリには、認証情報が必要かどうかと使用する認証タイプが表示されます。

### ステップ3：認証情報の設定

認証が必要な各アプリについて、以下が可能です：

- **既存の認証情報を使用** -- このアプリのグローバル認証情報を既に保存している場合、グループでそれを再利用できます。
- **新しい認証情報を入力** -- このグループ専用の認証情報を提供します（例：営業用とサポート用で異なるSalesforceアカウント）。

グループ作成モーダルには、各アプリの認証情報ステータスが表示されます：
- 保存済み -- 認証情報は既に設定済み
- プリセット使用 -- 既存のグローバル認証情報を使用
- 未設定 -- グループが動作する前に認証情報が必要

### ステップ4：アプリごとの設定

グループ内の各アプリについて、エージェントがこのワークフローコンテキストでどのように使用すべきかを説明する説明文を追加できます（例：「Salesforceを使用して顧客アカウントを検索し、取引ステージを更新する」）。

## グループ機能

### ワークフローメモリ

有効にすると、ワークフローメモリによりグループ内のすべてのアプリがコンテキストを共有できます。エージェントがSalesforceで顧客を検索した場合、その情報はGmailでメールを作成する際にも利用可能です -- 繰り返し説明する必要はありません。

### カラー＆アイコンコーディング

グループは、素早い視覚的識別のために、色分けされたカードと絵文字アイコンで表示されます。使用可能な色には、青、赤、緑、オレンジ、紫、ピンク、シアン、アンバーがあります。

### グループ固有の認証情報

各グループはグローバル認証情報とは独立した独自の認証情報セットを持つことができます。これにより：

- 個人用と仕事用グループで異なるGoogleアカウント
- 開発環境と本番環境で別々のAPIキー
- ワークフローごとに分離されたOAuthトークン

認証情報の検索は、グループ固有の認証情報を優先し、次にグローバル認証情報にフォールバックするチェーンに従います。

## 認証情報管理

### サポートされる認証タイプ

| タイプ | 説明 |
|------|-------------|
| **APIキー** | 単一キーフィールド（例：OpenAI APIキー） |
| **OAuth** | クライアントID + クライアントシークレットのペア |
| **認証情報** | 複数フィールドフォーム（例：ユーザー名 + パスワード + ドメイン） |
| **なし** | 認証不要 |

### 認証情報の保存

すべての認証情報は、マシン由来のキーを使用したAES-256-GCMで暗号化されます。`~/.neotask/mcp-credentials.enc`にローカルに保存されます。

### 認証情報のマスキング

保存された認証情報を表示する際、機密値はマスクされます：
- 短い値：最初の3文字 + `...` + 最後の2文字
- 長い値：最初の6文字 + `...` + 最後の4文字

### レガシー移行

以前のフォーマット（個別のAPIキー、OAuth、またはカスタムURLストア）を使用して認証情報を保存していた場合、統一された暗号化ストアに自動的に移行されます。

## ユースケース

| グループ | アプリ | 目的 |
|-------|------|---------|
| **営業** | Salesforce、HubSpot、Gmail、Calendar | CRMワークフロー |
| **DevOps** | GitHub、Jira、Docker Hub、Slack | 開発パイプライン |
| **コンテンツ** | WordPress、Canva、Google Docs、Buffer | コンテンツ作成 |
| **サポート** | Zendesk、Intercom、Notion、Slack | カスタマーサービス |
| **財務** | QuickBooks、Stripe、Google Sheets | 財務管理 |
| **マーケティング** | Mailchimp、Google Analytics、Facebook Ads | キャンペーン管理 |