# App Groups

## App Groups क्या हैं?

App Groups वर्कफ़्लो bundles हैं जो आपके MCP app integrations को themed collections में व्यवस्थित करते हैं। इन्हें अपने फ़ोन पर folders की तरह समझें, आप संबंधित apps को एक साथ group करते हैं और आपका agent उन्हें एक coordinated toolkit के रूप में उपयोग करता है।

उदाहरण के लिए, आप Salesforce, HubSpot, Gmail और Google Calendar के साथ एक "Sales" group बना सकते हैं, या GitHub, Jira, Docker Hub और Slack के साथ एक "DevOps" group।

## App Group बनाना

### चरण 1: Group Setup

अपने group को एक नाम दें, एक color चुनें (8 preset options), और एक emoji icon चुनें। group के सभी apps में shared context बनाए रखने के लिए वैकल्पिक रूप से **Workflow Memory** सक्षम करें।

### चरण 2: Apps चुनें

1200+ उपलब्ध MCP apps में से चुनें। प्रत्येक app दिखाता है कि इसे credentials की आवश्यकता है या नहीं और यह किस auth type का उपयोग करता है।

### चरण 3: Credentials Configure करें

प्रत्येक app के लिए जिसे प्रमाणीकरण की आवश्यकता है, आप कर सकते हैं:

- **मौजूदा credentials का उपयोग करें**, यदि आपने पहले से इस app के लिए globally credentials सहेजे हैं, तो group उन्हें reuse कर सकता है।
- **नए credentials दर्ज करें**, इस group के लिए विशिष्ट credentials प्रदान करें (जैसे sales बनाम support के लिए एक अलग Salesforce account)।

group creation modal प्रत्येक app की credential status दिखाता है:
- ✓ Saved, Credentials पहले से configured हैं
- ✓ Using preset, मौजूदा global credentials का उपयोग कर रहा है
- ⚠ Missing, group काम करने से पहले Credentials आवश्यक हैं

### चरण 4: Per-App Configuration

group में प्रत्येक app के लिए, आप एक विवरण जोड़ सकते हैं जो बताता है कि agent को इस workflow context में इसे कैसे उपयोग करना चाहिए (जैसे "Salesforce का उपयोग customer accounts देखने और deal stages अपडेट करने के लिए करें")।

## Group Features

### Workflow Memory

सक्षम होने पर, workflow memory group में सभी apps को context share करने की अनुमति देती है। यदि आपका agent Salesforce में किसी customer को देखता है, तो वह जानकारी Gmail में email draft करते समय उपलब्ध होती है, बिना आपको खुद को दोहराने की आवश्यकता के।

### Color और Icon Coding

Groups color-coded cards के रूप में emoji icons के साथ त्वरित visual identification के लिए प्रदर्शित होते हैं। उपलब्ध colors में blue, red, green, orange, purple, pink, cyan और amber शामिल हैं।

### Group-Specific Credentials

प्रत्येक group की अपनी credentials का set हो सकता है, global credentials से स्वतंत्र। इसका अर्थ है:

- personal बनाम work groups के लिए अलग Google accounts
- dev बनाम production environments के लिए अलग API keys
- प्रति workflow isolated OAuth tokens

Credential lookup एक chain का पालन करती है: पहले group-specific credentials, फिर global credentials पर fallback।

## Credential Management

### समर्थित Auth Types

| Type | विवरण |
|------|-------------|
| **API Key** | Single key field (जैसे OpenAI API key) |
| **OAuth** | Client ID + Client Secret pair |
| **Credentials** | Multi-field form (जैसे username + password + domain) |
| **None** | कोई प्रमाणीकरण आवश्यक नहीं |

### Credential Storage

सभी credentials AES-256-GCM के साथ machine-derived key का उपयोग करके encrypted हैं। वे locally `~/.neotask/mcp-credentials.enc` पर stored हैं।

### Credential Masking

सहेजी गई credentials देखते समय, sensitive values masked होती हैं:
- Short values: पहले 3 chars + `...` + अंतिम 2 chars
- Long values: पहले 6 chars + `...` + अंतिम 4 chars

### Legacy Migration

यदि आपने पहले पुराने formats (अलग API key, OAuth, या custom URL stores) का उपयोग करके credentials सहेजी थीं, तो वे स्वतः unified encrypted store में migrate हो जाती हैं।

## Use Cases

| Group | Apps | Purpose |
|-------|------|---------|
| **Sales** | Salesforce, HubSpot, Gmail, Calendar | CRM workflow |
| **DevOps** | GitHub, Jira, Docker Hub, Slack | Development pipeline |
| **Content** | WordPress, Canva, Google Docs, Buffer | Content creation |
| **Support** | Zendesk, Intercom, Notion, Slack | Customer service |
| **Finance** | QuickBooks, Stripe, Google Sheets | Financial tracking |
| **Marketing** | Mailchimp, Google Analytics, Facebook Ads | Campaign management |