# App Groups

## 什麼是 App Groups？

App Groups 是工作流程套組，將您的 MCP 應用程式整合組織成主題集合。將它們想像成手機上的資料夾 -- 您將相關應用程式分組在一起，您的代理程式將它們作為協調的工具集使用。

例如，您可以建立一個包含 Salesforce、HubSpot、Gmail 和 Google Calendar 的「Sales」群組，或包含 GitHub、Jira、Docker Hub 和 Slack 的「DevOps」群組。

## 建立 App Group

### 步驟 1：群組設定

為群組命名、選擇顏色（8 種預設選項）並選擇表情符號圖示。可選啟用**工作流程記憶**，讓群組在其所有應用程式之間維護共享上下文。

### 步驟 2：選擇應用程式

從 1200+ 個可用 MCP 應用程式中選擇。每個應用程式會顯示是否需要憑證以及使用的認證類型。

### 步驟 3：配置憑證

對於每個需要認證的應用程式，您可以：

- **使用現有憑證** -- 如果您已全域儲存了此應用程式的憑證，群組可以重複使用。
- **輸入新憑證** -- 提供此群組專用的憑證（例如用於銷售和支援的不同 Salesforce 帳戶）。

群組建立對話框會顯示每個應用程式的憑證狀態：
- Saved -- 憑證已配置
- Using preset -- 使用現有的全域憑證
- Missing -- 群組運作前需要憑證

### 步驟 4：每個應用程式的配置

對於群組中的每個應用程式，您可以添加描述，解釋代理程式在此工作流程上下文中應如何使用它（例如「使用 Salesforce 查找客戶帳戶並更新交易階段」）。

## 群組功能

### 工作流程記憶

啟用後，工作流程記憶讓群組中的所有應用程式共享上下文。如果您的代理程式在 Salesforce 中查找客戶，該資訊在 Gmail 中撰寫電子郵件時即可使用 -- 無需重複說明。

### 顏色和圖示編碼

群組以彩色編碼的卡片和表情符號圖示顯示，便於快速視覺識別。可用顏色包括藍色、紅色、綠色、橙色、紫色、粉色、青色和琥珀色。

### 群組專屬憑證

每個群組可以擁有自己的憑證集，獨立於全域憑證。這意味著：

- 個人和工作群組使用不同的 Google 帳戶
- 開發和生產環境使用不同的 API 金鑰
- 每個工作流程隔離的 OAuth Token

憑證查找遵循鏈式規則：首先查找群組專屬憑證，然後回退到全域憑證。

## 憑證管理

### 支援的認證類型

| 類型 | 描述 |
|------|-------------|
| **API Key** | 單一金鑰欄位（例如 OpenAI API 金鑰） |
| **OAuth** | Client ID + Client Secret 配對 |
| **Credentials** | 多欄位表單（例如使用者名稱 + 密碼 + 網域） |
| **None** | 不需要認證 |

### 憑證儲存

所有憑證使用 AES-256-GCM 和機器衍生金鑰加密。它們儲存在本機的 `~/.neotask/mcp-credentials.enc`。

### 憑證遮罩

查看已儲存的憑證時，敏感值會被遮罩：
- 短值：前 3 個字元 + `...` + 最後 2 個字元
- 長值：前 6 個字元 + `...` + 最後 4 個字元

### 舊版遷移

如果您之前使用舊格式（單獨的 API 金鑰、OAuth 或自訂 URL 儲存）儲存憑證，它們會自動遷移到統一的加密儲存。

## 使用案例

| 群組 | 應用程式 | 用途 |
|-------|------|---------|
| **Sales** | Salesforce、HubSpot、Gmail、Calendar | CRM 工作流程 |
| **DevOps** | GitHub、Jira、Docker Hub、Slack | 開發流水線 |
| **Content** | WordPress、Canva、Google Docs、Buffer | 內容創作 |
| **Support** | Zendesk、Intercom、Notion、Slack | 客戶服務 |
| **Finance** | QuickBooks、Stripe、Google Sheets | 財務追蹤 |
| **Marketing** | Mailchimp、Google Analytics、Facebook Ads | 活動管理 |