본문으로 건너뛰기

© 2026 Molayo

Qiita헤드라인2026. 06. 06. 17:14

Claude Code × MCP × Google Sheets 연동 사례 5가지 정리

요약

Claude Code와 MCP(Model Context Protocol)를 결합하여 Google Sheets를 직접 조작하는 자율형 에이전트 활용 사례를 소개합니다. 데이터 읽기, 정형화된 데이터 쓰기, 다중 시트 요약 등 실무 자동화 패턴 5가지를 다룹니다.

핵심 포인트

  • MCP를 통해 Claude Code가 외부 API와 직접 통신 가능
  • Google Sheets 데이터 읽기/쓰기 자동화로 업무 효율 극대화
  • GAS(Google Apps Script) 작성보다 빠른 자동화 구현 가능
  • 구체적인 셀 범위 지정과 올바른 권한 설정이 핵심

「AI에게 스프레드시트를 자동으로 조작하게 하고 싶다」라고 생각한 적 없으신가요?

Claude Code는 강력한 코딩 어시스턴트이지만, MCP와 결합하면 Google Sheets를 직접 읽고 쓸 수 있는 "자율형 에이전트 (Autonomous Agent)"로 동작할 수 있게 됩니다. 이 기사에서는 실무에서 사용할 수 있는 연동 패턴을 5가지로 압축하여 소개합니다. 도입 절차부터 구체적인 유스케이스 (Use Case)까지 최대한 친절하게 해설할 테니, 꼭 끝까지 읽어보시기 바랍니다.

「Claude Code는 결국 코드만 작성해 주는 것 아닌가?」라고 느끼고 계시지는 않나요?

사실 MCP (Model Context Protocol)를 활용하면, Claude Code는 Google Sheets를 직접 읽고 쓰는 에이전트로서 기능합니다.

수동으로 진행하던 데이터 입력, 집계, 리포트 작성과 같은 반복 작업을 자연어 지시만으로 자동화할 수 있게 됩니다.

하고 싶은 일MCP 없음MCP 있음
Sheets 데이터 읽기❌ 수동 복사/붙여넣기✅ 자동 취득
...

즉, **MCP + Claude Code + Google Sheets의 조합은 "말할 수 있는 스프레드시트 자동화 기반"**이라고 저는 느끼고 있습니다.

MCP란 AI 모델이 외부 도구나 API와 표준 프로토콜로 대화하기 위한 메커니즘입니다.

Claude Code는 표준 상태에서도 코드를 작성하고 실행할 수 있지만, MCP를 통함으로써 **외부 서비스로의 직접 액세스 (Direct Access)**가 가능해집니다. Google Sheets의 MCP 서버를 구축하면, Claude Code는 "이 시트의 매출 데이터를 읽어서 전월 대비를 계산한 뒤 다른 시트에 써줘"와 같은 지시를 도구 호출 (Tool Call)로서 실행할 수 있게 됩니다.

❌ 기존: 코드를 작성한다 → 수동 실행 → 결과를 확인한다 → 다시 코드를 수정한다... 라는 루프

✅ MCP 도입 후: 자연어로 지시한다 → Claude Code가 도구를 호출하여 직접 조작한다

이 차이는 업무 자동화 속도와 직결됩니다. 제가 실제로 시도해 보며 느낀 점은 "이거, GAS (Google Apps Script)를 처음부터 짜는 것보다 압도적으로 빠르다"는 것이었습니다.

유스케이스 (Use Case): 매일 아침 매출 시트를 읽어서 중요 수치만 Slack으로 알림

MCP 서버를 경유하여 Google Sheets에 액세스하고, 지정된 셀 범위의 데이터를 취득 → 요약 → 출력하는 흐름입니다.

"A1:D50의 매출 데이터를 읽어서 이번 주 합계와 전주 대비를 알려줘"
단계내용
1Google Sheets MCP 서버를 기동
...

✅ 포인트: 셀 범위 지정은 구체적으로 전달할수록 정밀도가 높아집니다.

유스케이스 (Use Case): 폼(Form)의 응답을 정형화하여 시트에 추가

API나 Webhook으로 받은 데이터를 Claude Code가 정형화하여 Sheets에 쓰는 패턴입니다.

"다음 JSON 데이터를 Sheets의 '응답 로그' 시트의 A열부터 순서대로 추가해줘"

❌ 흔히 하는 실수: 쓰기 대상 시트 ID나 권한 설정을 잘못하여 에러가 발생함

✅ 대책: MCP 서버 기동 시 스코프 (Scope, spreadsheets 권한)를 올바르게 설정해 둘 것

유스케이스 (Use Case): 월별로 나누어진 시트를 횡단하여 연간 요약(Summary)을 자동 생성

이것은 수작업으로 하면 상당히 힘든 작업이지만, MCP를 사용하면 Claude Code에게 "1월~12월의 각 시트에서 매출 합계를 모아서 요약 시트에 써줘"라고 지시하는 것만으로 완결됩니다.

작업수동Claude Code + MCP
시트 12장의 수치 수집20~30분수십 초
...

✅ 제가 시도해 본 소감으로는, 시트 수가 많을수록 혜택이 커서 "이걸 매달 수동으로 하고 있었구나..."라며 조금 허무해지기도 했습니다 (웃음).

유스케이스 (Use Case): "상태가 '미대응'인 행만 추출하여 별도 시트에 복사"

Sheets의 필터 기능을 수동으로 조작하는 대신, Claude Code에게 조건을 일본어(자연어)로 전달하는 것만으로 추출할 수 있습니다.

"'대응 상황' 열이 '미대응'이고 '우선순위'가 '높음'인 행을 '대응 필요 리스트' 시트에 복사해줘"

❌ 주의점: 열 이름이 일치하지 않으면 (예: '대응 상황', '대응 상태'가 혼재됨) 잘못 추출될 수 있음

✅ 대책: 사전에 시트의 열 구성을 Claude Code에게 공유해 두면 정밀도가 올라감

유스케이스 (Use Case): 주간 리포트 템플릿에 수치를 자동으로 채워 넣기

정해진 포맷의 리포트 시트에 집계된 데이터를 흘려넣는 작업도 자동화할 수 있습니다.

단계내용
템플릿 시트 준비삽입하고 싶은 셀에 이름 정의된 범위 (Named Range) 설정
...

✅ 포인트: 이름 정의된 범위 (Named Range)를 사용해 두면, Claude Code의 지시가 더욱 정확해집니다.

실제로 연동을 시도하다 보면, 의외로 환경 구축에서 시간을 많이 소비할 수 있습니다. 개인적으로 막히기 쉽다고 느낀 포인트들을 정리해 두겠습니다.

문제 발생 포인트원인대책
인증 에러 발생OAuth 설정 미비Google Cloud Console에서 Sheets API를 활성화
시트를 읽을 수 없음권한 스코프 (Scope) 부족spreadsheets 스코프를 명시적으로 부여
MCP 서버가 실행되지 않음Node.js 버전 불일치권장 버전 (v18 이상)으로 통일
일본어 시트 이름으로 실패URL 인코딩 문제시트 이름을 ASCII로 설정하거나 ID로 지정

❌ "왠지 안 된다"며 포기해 버리는 분들이 많은 인상이지만, 대부분의 원인은 권한이나 버전 문제입니다.

✅ 에러 메시지를 그대로 Claude Code에 붙여넣으면 해결책을 제시해 주는 경우가 많으므로 시도해 보시기 바랍니다.

  • MCP를 통해 Claude Code는 Google Sheets를 직접 조작할 수 있음
  • 읽기·쓰기·집계·리포트 생성까지 자연어 (Natural Language)로 지시하기만 하면 됨
  • 셋업은 권한과 버전에 주의한다면 어렵지 않음
  • 반복 작업이 많은 사람일수록 도입 비용의 회수가 빠름

"스프레드시트 수작업을 줄이고 싶다"는 고민은 Claude Code × MCP로 확실히 해결할 수 있습니다. 우선은 한 가지 연동 패턴부터 시도해 보시는 것을 추천합니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0