# Macro Automation Studio 문서

> Macro Automation Studio 문서: 에뮬레이터와 클라우드 기기 설정, Python SDK 레퍼런스, MAS Agent, MCP 서버, API 키, 웹훅, 가이드.

Every page is also available as Markdown at the same path with a .md suffix. The full text of every page is at https://automationmacro.com/ko/docs/llms-full.txt.

## 시작하기

- [파이썬 안드로이드 자동화 시작하기: 첫 매크로 실행](https://automationmacro.com/ko/docs/getting-started.md): Macro Automation Studio에서 파이썬 안드로이드 자동화를 시작합니다: 기기를 연결한 뒤 마켓플레이스 봇 실행, MAS Agent 요청, 첫 매크로 작성까지 안내합니다.
- [Macro Automation Studio 다운로드 및 설치 방법](https://automationmacro.com/ko/docs/install.md): 64비트 Windows 또는 Apple Silicon Mac에 Macro Automation Studio를 다운로드해 설치하고, 이메일이나 Google로 로그인하며, 업데이트와 프로젝트 위치를 확인합니다.
- [이미지 인식 매크로 원리: MAS 작동 방식](https://automationmacro.com/ko/docs/concepts.md): MAS의 이미지 인식 매크로 작동 방식: 템플릿 이미지와 OCR로 Android 화면을 읽고, 사람과 비슷한 입력을 adb로 보내며, 매크로가 어디서 실행되는지 설명합니다.

## MAS Agent

- [AI 매크로 만들기: 안드로이드 AI 에이전트 MAS Agent](https://automationmacro.com/ko/docs/agent.md): Android 자동화 작업을 설명하면 MAS Agent가 에뮬레이터나 클라우드 기기에서 앱을 탐색하고, 검증을 거친 파이썬 매크로를 만들어 Studio에서 편집할 수 있게 합니다.

## 기기

- [안드로이드 에뮬레이터 매크로: 기기 추가와 adb 포트](https://automationmacro.com/ko/docs/devices.md): Macro Automation Studio의 안드로이드 에뮬레이터 매크로 기기 설정: 자동 검색되는 에뮬레이터, adb 포트 규칙, 포트로 기기 추가, 클라우드 기기와 휴대폰 연결을 다룹니다.
- [블루스택 ADB 연결과 포트 설정: MAS에 BlueStacks 추가](https://automationmacro.com/ko/docs/bluestacks-setup-guide.md): BlueStacks 5에서 ADB를 켜고 ADB 포트를 찾아 Macro Automation Studio에 연결하고, Windows와 Mac에서 기기를 찾을 수 없음, offline 오류를 해결합니다.
- [LD플레이어 ADB 연결과 디버깅 설정: MAS에 LDPlayer 추가](https://automationmacro.com/ko/docs/ldplayer-setup-guide.md): LDPlayer 9에서 ADB 디버깅을 켜고 ADB 포트를 찾아 Macro Automation Studio에 연결하며, 조작 녹화기 대신 화면을 인식하는 매크로로 바꾸는 방법을 안내합니다.
- [MuMu Player 12 ADB 포트 확인과 MAS 연결 설정](https://automationmacro.com/ko/docs/mumu-setup-guide.md): MuMu Player 12의 ADB 포트를 찾아 Macro Automation Studio에 연결하고, 모든 인스턴스를 기기로 추가하며, 조작 녹화 대신 MAS 매크로를 실행하는 방법을 설명합니다.
- [MEmu ADB 연결과 포트 설정: 미뮤 앱플레이어를 MAS에 추가](https://automationmacro.com/ko/docs/memu-setup-guide.md): MEmu Play를 21503 포트로 Macro Automation Studio에 ADB 연결하고 기기로 추가하며, offline 오류를 고치고 녹화기 대신 MAS 매크로를 실행합니다.
- [adb 연결 안됨 해결: 블루스택, LD플레이어 에뮬레이터 ADB 오류](https://automationmacro.com/ko/docs/adb-troubleshooting.md): Macro Automation Studio에서 BlueStacks, LDPlayer, MuMu, MEmu, Nox의 adb 연결 안됨, 기기 없음, offline 오류를 직접 확인할 adb 명령과 함께 해결합니다.
- [클라우드 안드로이드 에뮬레이터: 클라우드 기기 생성과 매크로 실행](https://automationmacro.com/ko/docs/cloud-devices.md): Macro Automation Studio에서 클라우드 안드로이드 기기를 만들고 WebRTC로 화면을 보며, APK를 설치하고 PC를 꺼도 서버에서 매크로를 실행하며, 멈춘 기기를 고칩니다.
- [블루스택 멀티 인스턴스 매크로: MAS 기기 그룹 설정](https://automationmacro.com/ko/docs/device-groups.md): Macro Automation Studio의 기기 그룹으로 블루스택 멀티 인스턴스 창과 클라우드 기기를 묶고, 기기마다 매크로, 인수, 프록시를 지정한 뒤 한 번에 시작합니다.
- [안드로이드 에뮬레이터 프록시 설정: 기기마다 다른 IP 사용](https://automationmacro.com/ko/docs/proxies.md): Macro Automation Studio에서 에뮬레이터 인스턴스나 클라우드 기기마다 HTTP, HTTPS, SOCKS5 프록시를 하나씩 연결하고, 출구 IP를 테스트하며 웹훅에서 확인합니다.

## 가이드

- [모바일 게임 매크로 만들기: 모든 안드로이드 게임 봇 제작](https://automationmacro.com/ko/docs/make-a-bot-for-any-game.md): Macro Automation Studio에서 모바일 게임 매크로 만들기: 마켓플레이스에서 설치하거나, MAS Agent에 요청하거나, BlueStacks에서 파이썬으로 직접 작성합니다.
- [블루스택 이미지 인식 매크로 만들기와 LD플레이어 반복](https://automationmacro.com/ko/docs/guides/image-recognition-macros.md): Asset Lab에서 템플릿을 잘라 BlueStacks나 LDPlayer 화면에서 찾고, 원하는 상태가 나타날 때까지 반복하는 블루스택 이미지 인식 매크로를 만듭니다.
- [파이썬 ADB 자동화 튜토리얼: 안드로이드 에뮬레이터 제어](https://automationmacro.com/ko/docs/guides/control-an-emulator-from-python.md): Macro Automation Studio용 파이썬 ADB 자동화 튜토리얼: 앱이 adb를 대신 관리하는 동안 BlueStacks에서 탭, 스와이프, 입력, 키 누름, 스크린샷을 파이썬으로 실행합니다.
- [파이썬 OCR 매크로: 게임 봇이 Tesseract로 숫자 읽기](https://automationmacro.com/ko/docs/guides/ocr-text-reading.md): MAS의 read_text로 안드로이드 게임 봇에 Tesseract OCR을 붙입니다: Asset Lab에서 영역을 고르고 psm과 색 변환을 조정해 카운터와 타이머를 읽습니다.
- [LD플레이어 매크로 반복, 정지 조건, 예약 실행](https://automationmacro.com/ko/docs/guides/loops-and-scheduling.md): LDPlayer나 BlueStacks에서 매크로를 정지 조건과 함께 반복하고, 실행 사이에 진행 상황을 저장하며, 종료 코드를 남기고 MAS 스케줄러로 매일 예약 실행합니다.
- [LD플레이어 멀티 매크로와 블루스택 멀티 인스턴스 동기화 실행](https://automationmacro.com/ko/docs/guides/multi-instance.md): MAS에서 BlueStacks나 LDPlayer 인스턴스를 포트별로 추가하고 기기 그룹으로 묶어, 기기마다 프로필과 프록시를 주고 한 번에 실행하는 멀티 인스턴스 자동화 안내입니다.