# App Groups

## O Que Sao App Groups?

App Groups sao pacotes de fluxos de trabalho que organizam suas integracoes de apps MCP em colecoes tematicas. Pense neles como pastas no seu celular -- voce agrupa apps relacionados e seu agente os usa como um kit de ferramentas coordenado.

Por exemplo, voce pode criar um grupo "Vendas" com Salesforce, HubSpot, Gmail e Google Calendar, ou um grupo "DevOps" com GitHub, Jira, Docker Hub e Slack.

## Criando um App Group

### Etapa 1: Configuracao do Grupo

De um nome ao seu grupo, escolha uma cor (8 opcoes predefinidas) e selecione um icone emoji. Opcionalmente, ative a **Memoria de Fluxo de Trabalho** para permitir que o grupo mantenha contexto compartilhado entre todos os seus apps.

### Etapa 2: Selecionar Apps

Escolha entre mais de 1200 apps MCP disponiveis. Cada app mostra se precisa de credenciais e qual tipo de autenticacao usa.

### Etapa 3: Configurar Credenciais

Para cada app que requer autenticacao, voce pode:

- **Usar credenciais existentes** -- Se voce ja salvou credenciais para este app globalmente, o grupo pode reutiliza-las.
- **Inserir novas credenciais** -- Fornecer credenciais especificas para este grupo (ex.: uma conta Salesforce diferente para vendas vs suporte).

O modal de criacao do grupo mostra o status das credenciais de cada app:
- Salvas -- Credenciais ja configuradas
- Usando predefinido -- Usando credenciais globais existentes
- Faltando -- Credenciais necessarias antes que o grupo possa funcionar

### Etapa 4: Configuracao por App

Para cada app no grupo, voce pode adicionar uma descricao explicando como o agente deve usa-lo neste contexto de fluxo de trabalho (ex.: "Use o Salesforce para buscar contas de clientes e atualizar estagios de negociacao").

## Recursos do Grupo

### Memoria de Fluxo de Trabalho

Quando ativada, a memoria de fluxo de trabalho permite que todos os apps no grupo compartilhem contexto. Se seu agente buscar um cliente no Salesforce, essa informacao fica disponivel quando ele redigir um email no Gmail -- sem voce precisar se repetir.

### Codificacao por Cor e Icone

Os grupos sao exibidos como cartoes codificados por cor com icones emoji para identificacao visual rapida. As cores disponiveis incluem azul, vermelho, verde, laranja, roxo, rosa, ciano e ambar.

### Credenciais Especificas do Grupo

Cada grupo pode ter seu proprio conjunto de credenciais, independente das credenciais globais. Isso significa:

- Contas Google diferentes para grupos pessoais vs trabalho
- Chaves de API separadas para ambientes de desenvolvimento vs producao
- Tokens OAuth isolados por fluxo de trabalho

A busca de credenciais segue uma cadeia: credenciais especificas do grupo primeiro, depois fallback para credenciais globais.

## Gerenciamento de Credenciais

### Tipos de Autenticacao Suportados

| Tipo | Descricao |
|------|-----------|
| **API Key** | Campo de chave unica (ex.: chave de API do OpenAI) |
| **OAuth** | Par de Client ID + Client Secret |
| **Credentials** | Formulario com multiplos campos (ex.: usuario + senha + dominio) |
| **None** | Nenhuma autenticacao necessaria |

### Armazenamento de Credenciais

Todas as credenciais sao criptografadas com AES-256-GCM usando uma chave derivada da maquina. Sao armazenadas localmente em `~/.neotask/mcp-credentials.enc`.

### Mascaramento de Credenciais

Ao visualizar credenciais salvas, valores sensiveis sao mascarados:
- Valores curtos: primeiros 3 caracteres + `...` + ultimos 2 caracteres
- Valores longos: primeiros 6 caracteres + `...` + ultimos 4 caracteres

### Migracao de Legado

Se voce salvou credenciais anteriormente usando formatos antigos (chave de API separada, OAuth ou armazenamentos de URL personalizados), elas sao automaticamente migradas para o armazenamento criptografado unificado.

## Casos de Uso

| Grupo | Apps | Proposito |
|-------|------|-----------|
| **Vendas** | Salesforce, HubSpot, Gmail, Calendar | Fluxo de trabalho de CRM |
| **DevOps** | GitHub, Jira, Docker Hub, Slack | Pipeline de desenvolvimento |
| **Conteudo** | WordPress, Canva, Google Docs, Buffer | Criacao de conteudo |
| **Suporte** | Zendesk, Intercom, Notion, Slack | Atendimento ao cliente |
| **Financeiro** | QuickBooks, Stripe, Google Sheets | Acompanhamento financeiro |
| **Marketing** | Mailchimp, Google Analytics, Facebook Ads | Gerenciamento de campanhas |