구글 Apps Script, AI 코딩 그리고 clasp, 실용적 연결의 전략
현장에서 필요한 작은 디지털 도구를 만들 때, 우리는 종종 기술적 한계와 씨름한다. 전문 개발팀은 꿈속의 이야기이고, 복잡한 시스템은 비용 부담이 크다. 이럴 때 우리 같은 ‘전략적 탐구자’에게 익숙한 구글 워크스페이스는 사막의 오아시스와 같다. 특히 구글 Apps Script는 간과하기 쉬운 강력한 플랫폼이지만, AI 코딩 도구의 등장으로 잠재력이 폭발하는 중이다. 문제는 그 폭발력을 현장까지 연결하는 실질적 가교가 필요하다는 점이다.
Apps Script, 현장의 숨은 엔진이 되는 이유
비영리기관이나 교육 현장에서 작은 규모의 업무용 앱을 만들 때, 구글 스프레드시트와 구글 Apps Script 조합은 가장 현실적인 선택지다. 전자결재, 상담 기록, 업무 일지, 교육 신청, 물품 관리 같은 내부 시스템은 많지만, 모든 것을 전문 개발자에게 맡기기에는 예산이 부족하고, 상용 솔루션은 현장의 고유한 업무 흐름과 맞지 않는다.
우리는 이미 Google Workspace for Nonprofits를 통해 Gmail, Drive, Docs, Sheets 등을 기관 업무에 활용한다. 따라서 익숙한 구글 워크스페이스 위에서 작은 앱을 만드는 흐름이 자연스럽게 형성된다. 이때 구글 스프레드시트는 단순한 표 계산 도구를 넘어, 강력한 업무용 데이터베이스 역할을 한다. 사용자가 웹앱 화면에서 정보를 입력하면, Apps Script가 이 데이터를 스프레드시트에 저장하고, 필요할 때 다시 불러와 목록이나 대시보드로 보여주는 구조다.
이 방식은 별도의 서버나 데이터베이스를 처음부터 구축하지 않아도 되므로, 최소 기능 제품(MVP)을 빠르게 만드는 데 매우 효과적이다. 하지만 한 가지 큰 불편함이 있었다. 챗GPT나 Google Antigravity 같은 AI 코딩 도구가 훌륭한 코드를 만들어줘도, 그 코드를 사람이 직접 Apps Script 편집기에 복사해서 붙여넣고, 저장하고, 배포하는 과정을 반복해야 했다. 결국 수십 줄의 코드를 챗GPT가 뚝딱 만들어내도, 손으로 옮겨 붙이는 과정에서 개발의 진수는 증발한다.
clasp, 코드 흐름을 해방하는 통로
바로 이 불편함을 해결해주는 도구가 clasp다. clasp는 구글이 제공하는 Apps Script CLI 즉, 명령줄 도구다. 쉽게 말하면, 브라우저에서 Apps Script 편집기를 열어 코드를 직접 붙여넣는 대신, 내 컴퓨터의 프로젝트 폴더에서 코드를 관리하고 그 코드를 Apps Script 프로젝트에 바로 ‘밀어 넣는’ 마법 같은 도구다.
이 도구 하나로 현장의 개발 워크플로우는 극적으로 달라진다. 아래 표는 기존 방식과 clasp 활용 방식의 차이를 명확하게 보여준다.
| 항목 | 기존 방식 (수동 복사) | clasp 활용 방식 (자동화) |
|---|---|---|
| 코드 생성 | AI 도구가 생성하면 사람이 직접 복사 | AI 도구가 로컬 프로젝트 파일을 직접 수정 |
| 코드 관리 | Apps Script 편집기에서 개별 파일 생성 및 붙여넣기 | 로컬 컴퓨터 폴더에서 관리 (파일 시스템 활용) |
| 업로드/동기화 | 각 파일을 수동으로 복사하여 편집기에 붙여넣기 반복 | clasp push 명령으로 로컬 파일 전체를 Apps Script에 업로드 |
| 배포 | Apps Script 편집기 메뉴에서 수동으로 배포 | clasp deploy 명령으로 버전 생성 및 배포까지 자동화 |
| 오류 수정 | 수정 후 다시 복사, 붙여넣기, 배포 반복 | 로컬 수정 후 clasp push, 필요한 경우 재배포 |
이 변화는 단순히 시간 절약의 차원을 넘어선다. 개발자가 ‘복사 붙여넣기 기계’에서 벗어나, 문제 해결과 가치 설계에 집중할 수 있는 환경을 비로소 얻는다.
첫 삽 뜨기, clasp 연동의 필수 관문
clasp를 처음 접하면 CLI, API, Script ID 같은 용어 때문에 어렵게 느껴질 수 있다. 하지만 본질적으로 이들은 ‘내 로컬 컴퓨터와 구글 서버 간의 안전한 대화 통로’를 설정하는 과정일 뿐이다.
-
사전 준비, Google Apps Script API 활성화 clasp가 로컬 컴퓨터와 Google Apps Script 서버가 통신하려면 먼저 Google Apps Script API 사용 설정이 켜져 있어야 한다. 이 API는 clasp가 코드를 업로드하고 배포하는 데 필요한 통신 채널을 제공한다. 보통 AI 코딩 도구가 이 설정을 감지하고 바로가기 링크를 안내한다.
-
clasp 설치 및 로그인 clasp는 Node.js 기반 도구다. 터미널에서
npm install -g @google/clasp명령으로 설치한다. 설치 후clasp login명령을 실행하면 웹 브라우저가 열리고, 여기서 Apps Script를 사용할 Google 계정으로 로그인하여 clasp가 프로젝트에 접근할 수 있도록 권한을 허용한다. -
스프레드시트 ID 또는 Apps Script 프로젝트 ID 연결 구글 스프레드시트를 데이터베이스처럼 사용하는 앱을 만들 때는 AI에게 어떤 스프레드시트를 사용할지 알려줘야 한다. 이는 스프레드시트 주소에서
d/와/edit사이의 긴 문자열이다. 이미 만들어둔 Apps Script 프로젝트에 clasp를 연결하려면 해당 프로젝트의 Script ID가 필요하다. 이 두 ID는 서로 다르지만, AI에게 스프레드시트 링크를 통째로 주면 AI가 알아서 필요한 ID를 찾아 연결하는 경우가 많다.
핵심은 명령어를 완벽하게 외우는 것이 아니다. AI 개발 도구에게 “clasp를 사용할 것”이라고 분명히 알리고, Google 로그인, Apps Script API 사용 설정, 그리고 필요한 ID를 알려주는 역할은 사용자의 몫이다.
편리함 이면의 보안 역설
clasp가 매우 편리한 것은 맞지만, 모든 권한 설정과 승인을 완전히 자동으로 처리해주는 만능 열쇠는 아니다. 이는 clasp의 한계가 아니라, 오히려 설계의 현명함이다. Apps Script는 Gmail, Drive, Sheets, Calendar 같은 Google 서비스에 접근할 수 있기 때문에, 아무 승인 없이 자동으로 모든 권한이 열리면 보안 재앙으로 이어지기 때문이다.
아래 표는 clasp가 자동화하는 영역과 사용자가 직접 확인해야 하는 영역을 구분한다.
| clasp가 자동화하는 것 | 사용자가 직접 확인해야 하는 것 |
|---|---|
| 로컬 코드 업로드 | Google 계정 로그인 및 clasp 권한 승인 |
| Apps Script 프로젝트 생성 | Apps Script API 사용 설정 |
| 기존 프로젝트 가져오기 | 처음 실행 시 Apps Script 권한 승인 |
| 파일 동기화 | 조직 계정 관리자가 API 접근 제한 시 설정 확인 |
| 버전 생성 | 민감한 OAuth 범위를 사용하는 경우 추가 검토 |
| 배포 생성 및 갱신 | 웹앱 접근 권한 설정 확인 |
| Apps Script 편집기 열기 |
즉, clasp는 코드 저장과 배포 과정을 크게 줄여주지만, Google 계정 보안과 관련된 승인은 사용자가 직접 확인해야 한다. 이는 편리함과 보안이라는 본질적 가치 사이의 균형점을 명확히 보여준다. 만약 이 보안 관문이 없다면, 우리는 편리함 뒤에 숨은 거대한 정보 유출 위험을 감수하는 셈이다.
교육 현장에서 clasp의 전략적 가치
비영리기관이나 교육 현장에는 전문 개발팀이 없는 경우가 대다수다. 하지만 내부 업무를 디지털화해야 하는 요구는 계속해서 증가한다. 전자결재, 상담일지, 교육 신청, 학생 관리, 직원 업무일지 등 작은 시스템이 끝없이 필요하다. 이럴 때 구글 Sheets와 Apps Script를 활용하면 작게 시작할 수 있으며, 여기에 clasp를 붙이면 개발 흐름이 훨씬 유려해진다.
clasp가 특히 빛을 발하는 지점들을 구체적인 현장 시나리오로 살펴보자.
| 항목 | 기존 Apps Script 개발 | clasp 활용 Apps Script 개발 | 실질적 이점 (현장 관점) |
|---|---|---|---|
| 여러 파일 관리 | 각 파일(Code.gs, Index.html 등)을 수동으로 복사/붙여넣기 | 로컬 파일 시스템에서 전체 프로젝트를 한 번에 업로드 | 학생 명단 관리, 수업 자료 배포 등 여러 모듈 통합 앱 개발 시 오류 감소 |
| 반복적인 수정 | 수정할 때마다 번거로운 복사/붙여넣기 반복 | 로컬에서 수정 후 clasp push로 빠르게 동기화 |
앱 기능 추가(검색, 대시보드), 피드백 반영 속도 향상 |
| 버전 관리 (Git) | 코드 백업 및 변경 이력 관리가 매우 어려움 | 로컬 파일이므로 Git으로 쉽게 버전 관리 및 백업 | 업무용 앱의 “작동”보다 “복구 가능성”이 중요함. 문제 발생 시 이전 버전 복원 |
| AI 개발 도구 연동 | AI가 만든 코드를 사람이 수동으로 옮김 | AI가 로컬 파일을 직접 수정하고 clasp가 Apps Script로 반영 | AI를 공동 개발자로 활용하여 아이디어를 빠르게 프로토타이핑 |
교실에서 ‘작동하는’ 것도 중요하지만, ‘지속 가능하고 복구 가능한’ 시스템은 현장 전문가의 생존 전략이다. clasp를 활용하면 로컬 파일로 코드를 관리하고 Git으로 변경 이력을 남길 수 있어, 문제가 생겼을 때 이전 버전으로 돌아갈 수 있다. 이는 단순한 편리함을 넘어, 현장 개발의 안정성과 지속 가능성을 보장하는 핵심 요소다.
작은 불편함, 큰 변화의 시작
구글 스프레드시트와 Apps Script를 활용하면 비영리기관이나 소규모 조직에서도 업무용 앱을 비교적 쉽게 만들 수 있다. 하지만 기존 방식은 AI가 코드를 만들어줘도, 사람이 직접 복사해서 붙여넣고, 저장하고, 다시 배포해야 하는 비효율적 과정이 존재했다. 파일이 많아지고 수정이 반복될수록 이 과정은 번거롭고 실수도 많아진다.
clasp는 이 흐름을 훨씬 간단하게 만든다. 챗GPT나 Google Antigravity 같은 AI 개발 도구가 로컬 프로젝트 파일을 만들고 수정하면, clasp를 통해 Apps Script 프로젝트에 바로 업로드할 수 있다. 필요한 경우 배포까지 이어가는 완전한 자동화가 된다. 물론 Apps Script API 활성화, Google 로그인, 권한 승인 같은 초기 단계는 사용자가 직접 해줘야 한다. 하지만 한 번 연결해두면 이후 개발 편의성은 크게 좋아진다.
정리하면 이렇다.
- Google Sheets는 작은 업무용 데이터베이스 역할을 한다.
- Apps Script는 그 데이터를 다루는 서버 역할을 한다.
- 챗GPT나 Google Antigravity는 코드를 만들어주는 개발 파트너가 된다.
- clasp는 그 코드를 Google Apps Script에 연결하고 배포하는 통로가 된다.
비영리기관의 디지털 전환은 꼭 거창한 시스템 구축에서 시작하지 않아도 된다. 작은 스프레드시트 하나, Apps Script 하나, 그리고 clasp 하나만으로도 충분히 실용적인 업무용 앱을 만들어볼 수 있다. 작은 불편함부터 시작하라. 그리고 다음 주 점심시간, 동료 교사 또는 연구자와 함께 clasp로 직접 해결해보는 작은 ‘코딩 점심’을 시도해보는 건 어떨까. 그 작은 시도가 교육 현장의 거대한 변화를 촉발하는 첫 단추가 된다.