# 앱 그룹

## 앱 그룹이란 무엇인가?

앱 그룹은 MCP 앱 통합을 테마별 컬렉션으로 구성하는 워크플로 번들입니다. 스마트폰의 폴더처럼 관련 앱을 그룹화하면 에이전트가 이를 조율된 도구 모음으로 활용합니다.

예를 들어, Salesforce, HubSpot, Gmail, Google Calendar를 포함하는 "영업" 그룹을 만들거나, GitHub, Jira, Docker Hub, Slack을 포함하는 "DevOps" 그룹을 만들 수 있습니다.

## 앱 그룹 생성

### 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 | 캠페인 관리 |