비공개 레포와 Meta 앱을 준비해 AI와 협업하기
Awen 작업은 레포를 공개하지 않고도 진행할 수 있습니다. 먼저 접근권한을 안전하게 받고, 로컬 폴더를 만든 뒤, Meta 앱 권한과 광고계정 연결까지 확인합니다.
목표
이 튜토리얼의 목표는 레포를 안전하게 내려받고, AI가 맥락을 잃지 않도록 작업 폴더 안에 기준 문서를 둔 다음, 변경사항을 검토 가능한 형태로 만드는 것입니다.
비공개 레포 요청 방법
요청 방식은 팀의 보안 수준과 협업 기간에 따라 다릅니다. 일반 PM/운영자는 초대 방식이 가장 단순하고, 자동화 서버나 읽기 전용 연동은 키 기반 접근이 더 안전합니다.
레포 소유자가 Settings에서 사람이나 팀을 초대합니다. 장기 협업자에게 가장 이해하기 쉬운 방식입니다.
회사/팀 단위로 레포를 관리하고 Read, Triage, Write 같은 권한을 팀별로 나눕니다.
서버나 특정 장비가 레포를 읽어야 할 때 SSH deploy key를 등록합니다. 쓰기 권한은 꺼두는 것이 기본입니다.
Mac mini runner처럼 읽기 전용 모니터링 장비에 적합합니다.GitHub API나 CLI 자동화가 필요할 때 특정 레포와 권한으로 제한한 토큰을 발급합니다.
토큰은 만료일을 짧게 두고, 문서나 AI 채팅에 붙이지 않습니다.GitHub 계정 연결이 어려운 사람에게는 레포 소유자가 ZIP 파일을 내려받아 안전한 내부 채널로 전달합니다.
빠르지만 업데이트 추적이 약합니다. 단기 리뷰나 튜토리얼에만 사용합니다.레포 다운로드
GitHub에서 private repository 열기
접근 권한이 있는 계정으로 GitHub에 로그인한 뒤 협업할 레포로 이동합니다.
Code 메뉴에서 ZIP 다운로드
Code 버튼을 누르고 Download ZIP을 선택합니다. Git 사용이 익숙하지 않은 팀원도 이 방식으로 같은 출발점을 만들 수 있습니다.
로컬 작업 폴더에 압축 해제
압축을 풀고 프로젝트 이름을 명확하게 바꿉니다. 예시는 아래처럼 관리합니다.
~/Documents/Awen/meta-ads-core
~/Documents/Awen/agent-ops
~/Documents/Awen/site작업 폴더 준비
AI와 협업하기 전에 폴더 안에 현재 목적, 금지사항, 검증 기준이 보여야 합니다. 이 기준이 없으면 AI는 “파일을 수정했다”를 성공으로 착각하기 쉽습니다.
AGENTS.md
작업 위치, 금지 명령, 배포 정책, 성공 기준을 적습니다.
README.md
프로젝트 목적과 로컬 실행 방법을 짧게 둡니다.
.env.example
필요한 환경변수 이름만 공유하고 실제 값은 넣지 않습니다.
outputs/
테스트 결과, 화면 증거, 실행 로그를 남길 공간을 만듭니다.
AI와 협업하는 순서
먼저 읽게 하기
AI에게 바로 수정시키지 말고 프로젝트 맵, 진입 파일, 테스트 방법을 먼저 찾게 합니다.
작은 목표로 나누기
한 번에 “광고 자동화 완성”이 아니라 “기존게시물 매핑 검증 로그 개선”처럼 실패 여부가 보이는 단위로 요청합니다.
검증 기준을 먼저 박기
API 성공, UI 성공, 로그 성공을 분리합니다. 특히 Meta 광고는 생성 응답만으로 성공이라고 보지 않습니다.
변경사항을 설명받기
수정된 파일, 실행한 테스트, 남은 리스크를 마지막에 요약하게 합니다.
Meta 앱 세팅
Awen이 광고를 읽고 쓰려면 Meta 개발자 앱, Marketing API, 권한, 토큰, 광고계정 접근권한이 같은 흐름 안에 있어야 합니다. 앱만 만들었다고 바로 광고 생성이 되는 구조가 아닙니다.
Meta for Developers에서 앱 생성
Meta 개발자 콘솔에서 새 앱을 만들고 앱 이름, 연락 이메일, 비즈니스 연결 상태를 확인합니다.
Marketing API 제품 추가
앱 대시보드에서 Marketing API를 추가합니다. 광고 캠페인, 광고세트, 광고 작업은 이 제품 권한 흐름을 탑니다.
권한과 Business verification 확인
광고 읽기/쓰기는 보통 ads_read, ads_management 권한이 필요합니다. 실제 운영 접근에는 앱 검수와 비즈니스 인증이 요구될 수 있습니다.
토큰 발급 방식 선택
초기 테스트는 사용자 토큰으로 시작할 수 있지만, 운영 자동화는 Business Manager의 System User와 장기 토큰 흐름을 분리해서 관리합니다.
광고계정과 페이지 권한 연결
앱, 사용자 또는 시스템 유저가 대상 광고계정, 페이지, Instagram 계정, 픽셀에 접근 가능한지 확인합니다. 기존게시물 광고는 페이지/게시물 권한까지 맞아야 합니다.
Awen 환경변수에 값 등록
앱 ID, 앱 시크릿, 액세스 토큰, 광고계정 ID, 페이지 ID를 .env에만 저장합니다. .env.example에는 이름만 남깁니다.
META_APP_ID=
META_APP_SECRET=
META_ACCESS_TOKEN=
META_AD_ACCOUNT_ID=act_000000000
META_PAGE_ID=안전장치
.env, 토큰, 광고 계정 권한 파일은 업로드하거나 문서에 붙이지 않습니다.
시작 프롬프트
아래처럼 말하면 AI가 먼저 구조를 파악하고, 필요한 수정 범위를 좁혀서 움직이기 좋습니다.
다음 튜토리얼
다음 문서는 Awen에서 자연어 지시를 광고 계층 구조로 바꾸는 방법을 다룹니다. 캠페인, 광고세트, 광고가 목적별로 어떻게 달라지는지 먼저 시각화합니다.
Awen 홈으로 돌아가기