> 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/agent/install/macos.md).
# MacOS에서 설치하기
{% hint style="success" %}
**에이전트 1.0.0 안내** 이 문서는 신규 에이전트 1.0.0(PKG 설치) 기준입니다. 구버전 에이전트를 쓰던 환경에서 전환하는 경우 [에이전트 1.0.0 전환 가이드](/agent/v1-migration.md)를 먼저 확인하세요.
{% endhint %}
{% hint style="info" %}
**에이전트 다운로드 경로** SMPLY 웹의 **호스트** 페이지로 이동한 뒤, 화면 우측 상단의 **`에이전트 다운로드`** 버튼을 클릭하면 설치 파일을 다운로드할 수 있습니다.
{% endhint %}
macOS 설치 파일을 다운로드 받습니다. macOS 에이전트는 Apple Silicon과 Intel을 모두 지원하는 범용 설치 파일(PKG) 하나로 제공되므로, 칩 종류에 맞춰 따로 고를 필요가 없습니다.
다운로드한 `.pkg` 파일을 더블 클릭하면 macOS 설치 마법사가 실행됩니다. 안내에 따라 **`계속`**, \*\*`설치`\*\*를 눌러 진행하세요. 설치가 끝나면 에이전트는 자동으로 백그라운드에서 실행되며, 이후 기기를 재시작해도 다시 자동으로 시작됩니다. 별도로 응용 프로그램을 옮기거나 직접 실행하는 단계는 없습니다.
{% hint style="info" %}
**관리자(설치) 권한 필요** PKG 설치 과정에서 macOS 로그인 사용자의 암호를 한 번 입력하라는 요청이 표시될 수 있습니다. 기기 사용자 본인의 macOS 로그인 암호를 입력하면 됩니다.
{% endhint %}
***
## 브라우저 접근 권한 허용하기
설치가 끝나면 잠시 후 macOS가 *"...이(가) 다른 응용 프로그램을 제어하려고 합니다"* 형태의 자동화(Automation) 권한 요청 창을 띄웁니다. 기기에 설치된 브라우저(Chrome, Safari, Edge 등)마다 한 번씩 표시되며, 각 창에서 **`승인`**(또는 **`허용`**)을 눌러 주세요.
이 권한은 에이전트가 브라우저 사용 현황을 파악하는 데 사용됩니다. 권한을 허용하지 않으면 해당 브라우저에 대한 데이터 수집이 동작하지 않습니다.
{% hint style="info" %}
**창이 보이지 않는 경우** 다른 창에 가려져 있을 수 있습니다. 모든 창을 최소화한 뒤 다시 확인하거나, **시스템 설정 > 개인정보 보호 및 보안 > 자동화**에서 SMPLY 항목의 브라우저 권한을 직접 켤 수 있습니다.
{% endhint %}
***
## 로그인 하기
에이전트 설치 후 반드시 로그인을 해야합니다. 설치 요청 이메일을 통해 설치했거나 심플리에 구성원으로 이미 추가되어 있는 경우에는 **별도 가입 절차 없이 로그인**이 가능합니다.
구글워크스페이스를 사용하지 않는 경우에도, 이메일 인증만을 통해 비밀 번호 없이 쉽게 로그인이 가능합니다.
설치 및 로그인이 완료되면 아래와 같은 화면을 볼 수 있습니다.