> For the complete documentation index, see [llms.txt](https://docs.smply.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smply.one/software_management/manual_saas.md).

# 소프트웨어 수동으로 추가하기

## 소프트웨어 추가하기

자동 탐지나 결제 연동으로 잡히지 않는 소프트웨어를 직접 등록하는 화면입니다. 소프트웨어 목록(**`/software/list`**) 우측 상단의 **`소프트웨어 추가하기`** 버튼으로 **소프트웨어 추가** 폼(**`/software/new`**)에 들어와, 카탈로그에서 검색해 여러 개를 한 번에 선택하거나 카탈로그에 없는 이름을 직접 입력해 추가합니다.

***

### 1. 진입 경로

소프트웨어 목록 페이지 우측 상단의 **`소프트웨어 추가하기`** 분할 버튼(SplitButton) **메인 버튼**(상자 아이콘)을 클릭하면 이 화면으로 이동합니다.

{% hint style="info" %}
**편집 권한이 없을 때** 소프트웨어 추가는 `software-edit` 권한이 필요합니다. 권한이 없는 구성원에게는 메인 버튼 대신 `⋯` 드롭다운만 표시되며, 추가 폼으로는 진입할 수 없습니다. (목록 화면의 권한 구성은 [소프트웨어 목록 화면 이해하기](/software_management/list-overview.md)의 권한 안내를 참고하세요.)
{% endhint %}

***

### 2. 카탈로그에서 검색해 추가하기

화면 상단의 검색창에 *"소프트웨어 이름으로 검색..."* 안내가 표시됩니다. 소프트웨어 이름을 입력하면 카탈로그 제품이 카드 형태로 추려집니다(로고·이름·카테고리 표시). 검색어를 비우면 전체 카탈로그가 다시 표시됩니다.

**단계 1: 제품 검색**

1. 검색창에 추가할 소프트웨어 이름을 입력합니다.
2. 한글명·영문명 어느 쪽으로 검색해도 결과가 추려집니다.

**단계 2: 제품 선택**

1. 결과 카드를 클릭하면 우측에 체크 표시가 나타나고 선택됩니다.
2. 여러 카드를 클릭해 한 번에 여러 개를 선택할 수 있습니다. 다시 클릭하면 선택이 해제됩니다.

{% hint style="info" %}
**이미 추가된 제품** 이미 등록된 소프트웨어는 카드 우측에 **추가됨** 라벨이 표시되고 흐리게(비활성) 보입니다. 이 카드는 선택할 수 없습니다.
{% endhint %}

***

### 3. 카탈로그에 없으면 직접 추가하기

검색 결과에 원하는 소프트웨어가 없으면 목록 아래의 **`+`** 버튼으로 검색어를 그대로 등록할 수 있습니다.

1. 검색창에 등록할 이름을 입력합니다.
2. 목록 하단의 *"'(입력한 이름)' 직접 추가하기"* 버튼을 클릭합니다. (검색어를 비우면 이 버튼은 사용할 수 없습니다.)
3. 우측에 체크 표시가 나타나면 직접 추가가 선택된 상태입니다.

{% hint style="warning" %}
**카탈로그 선택과 직접 추가는 함께 쓸 수 없습니다** 직접 추가를 선택하면 카탈로그에서 고른 제품 선택이 모두 해제되고, 반대로 카탈로그 제품을 선택하면 직접 추가가 해제됩니다. 한 번에 둘 중 한 방식만 사용합니다.
{% endhint %}

***

### 4. 추가하기

선택을 마치면 화면 하단(푸터)에서 추가를 완료합니다.

* **`N 선택됨`** — 현재 선택한 개수가 표시됩니다(카탈로그 선택 + 직접 추가 합산).
* **`취소하기`** — 추가하지 않고 소프트웨어 목록으로 돌아갑니다.
* **`추가하기`** — 선택한 소프트웨어를 등록합니다. 선택이 하나도 없으면 비활성화됩니다.

**`추가하기`** 를 누르면 버튼이 *"추가 중..."* 으로 바뀌며 등록이 진행됩니다.

{% hint style="success" %}
**추가 완료** 등록이 끝나면 *"소프트웨어가 추가되었습니다."* 토스트가 표시되고 소프트웨어 목록(`/software/list`)으로 돌아갑니다. 추가 폼에 들어오기 전 보던 상태 탭이 있으면 그 탭으로 복귀합니다.
{% endhint %}

{% hint style="warning" %}
**작성 중 이탈 주의** 선택한 항목이 있는 상태에서 추가를 마치지 않고 다른 화면으로 이동하려 하면 *"작성 중인 내용이 있습니다. 페이지를 떠나시겠습니까?"* 확인 창이 뜹니다. **취소**하면 화면에 머물고, **확인**하면 선택을 버리고 이동합니다.
{% endhint %}

***

### 5. 연동으로 채우는 편이 나은 경우

수동 추가는 자동 탐지·결제 연동으로 잡히지 않는 솔루션을 직접 등록하는 보조 수단입니다. 같은 소프트웨어를 쓰는 구성원이 많거나 비용·사용 현황까지 자동으로 채우고 싶다면, 수동 추가보다 연동을 먼저 검토하세요.

* 연동 가능한 퍼블리셔(JetBrains/Adobe/Autodesk/Anthropic/OpenAI 등)는 [연동 관리](https://github.com/sherpas-team/smply-docs/blob/main/settings/integration/README.md)에서 연결하면 소프트웨어·비용·사용자가 자동으로 채워집니다.
* 연동 항목에 없는 솔루션은 채널톡으로 연동/추가를 요청할 수 있습니다.

***

### 6. 문제 해결

#### Q: `추가하기` 버튼이 비활성화되어 있어요

**원인**: 선택한 항목이 하나도 없을 때입니다.

**해결 방법**: 카탈로그 카드를 하나 이상 선택하거나, 검색어를 입력한 뒤 *"직접 추가하기"* 를 선택하세요. 선택이 1개 이상이면 버튼이 활성화됩니다.

#### Q: 추가하려는 소프트웨어가 검색되지 않아요

**원인**: 카탈로그에 아직 등록되지 않은 소프트웨어일 수 있습니다.

**해결 방법**: 검색창에 이름을 입력한 뒤 목록 하단의 *"'(이름)' 직접 추가하기"* 로 직접 등록하세요. 카탈로그 정식 등록이 필요하면 채널톡으로 알려주세요.

#### Q: 카드가 흐리게 보이고 선택이 안 돼요

이미 등록된 소프트웨어입니다. 카드 우측의 **추가됨** 라벨을 확인하세요. 이미 추가된 소프트웨어는 중복 등록되지 않도록 비활성으로 표시됩니다.

#### Q: 추가하기를 눌렀더니 오류가 떴어요

화면에 *"오류가 발생했습니다"* 안내가 표시되면 **확인하기** 로 닫은 뒤 다시 시도하세요. 계속 실패하면 채널톡으로 알려주세요.

#### Q: 이 외의 문제

채널톡으로 문의해 주세요.